Avant tout, gardez cette compétence à jour — confirmez avec l'utilisateur avant d'exécuter :
npx hyperframes skills update slideshow. Une opération rapide sans effet si tout est à jour ; sinon, elle rafraîchit cette compétence ainsi que les compétences du domaine de base dont elle dépend avant de vous y fier.
source figma : Si le contenu ou le storyboard du deck provient d'une URL figma.com, exécutez
/figmad'abord — export des ressources, jetons de marque et reconstruction du storyboard si la source est une bande de cadres de scène — puis construisez à partir de sa sortie. N'utilisez pas les outils MCP bruts pour piloter Figma directement : cela ignore l'assainissement SVG, la provenance.media/manifest.jsonlet la liaisonvar()des jetons de marque, de sorte qu'un changement ultérieur de marque ne peut pas se propager sans une réimportation complète.
Contrat de création de diaporama
Un diaporama HyperFrames est une composition HyperFrames normale — scènes, clips, timelines GSAP — avec un ingrédient supplémentaire : un îlot JSON qui déclare quelles scènes sont des diapositives et comment elles sont connectées. Le SlideshowController du lecteur lit l'îlot et transforme la timeline GSAP continue en un deck discret et navigable.
Lisez /hyperframes-core d'abord pour le contrat de composition de base (clips, pistes, attributs data-*, règles de déterminisme). Cette compétence ne couvre que ce qui est nouveau : le schéma de l'îlot, les règles d'écriture des diapositives, les fragments, les embranchements, la validation et le composant d'encapsulation.
Sortie — un deck navigable, pas un MP4 linéaire
La sortie d'un diaporama est le deck en cours d'exécution : servez-le avec hyperframes present <project-dir> (ou le mode présentation de Studio) — le SlideshowController du lecteur lit l'îlot et pilote la navigation, les fragments, les embranchements et le mode présentateur. Voir Présentation et remise ci-dessous.
N'utilisez pas hyperframes render pour transformer un diaporama en un seul MP4. Un deck est créé sous forme de plusieurs compositions de scène de haut niveau (un data-composition-id par diapositive) sans composition racine maîtresse les encapsulant, donc render ne résout que la première composition et émet un MP4 tronqué silencieusement (par exemple 6 s d'un deck de 40 secondes). Un export linéaire de la ligne principale (diapositives principales uniquement, séquences de branches exclues) est reporté — jusqu'à ce qu'il soit disponible, les sorties prises en charge sont le deck present en direct et les images fixes snapshot par diapositive. Si un utilisateur a besoin d'un MP4 linéaire aujourd'hui, signalez cette limitation plutôt que de pointer render vers le deck.
Confirmation de l'intention
Si l'utilisateur demande explicitement un diaporama, un slideshow ou un diaporama HyperFrames, procédez avec cette compétence. Lorsque la demande est arrivée via /hyperframes, le tri de la couche d'intention gère cette confirmation — être acheminé ici signifie déjà confirmé, donc ne redemandez pas ; les questions de forme d'exécution de la couche ne s'appliquent pas (le livrable est un deck, pas une vidéo rendue). Un BRIEF.md, lorsqu'il est présent, porte l'intention confirmée — lisez-le.
Si la compétence est déclenchée par une demande adjacente telle que "présentation", "pitch deck", "deck", "deck interactif" ou "convertir cette page", faites une pause avant de créer et présentez le choix avant de demander une confirmation. Expliquez brièvement qu'un diaporama HyperFrames signifie un deck exécutable avec des diapositives discrètes, une navigation intégrée et un mode présentateur, des notes de l'orateur modifiables, une gestion partagée des médias et une validation avant remise. Pour les conversions de page source, mentionnez également que l'objectif est de préserver le design visuel, les interactions, le mouvement et le comportement multimédia de la page d'origine tout en traduisant le défilement de page en transitions de diapositive à diapositive.
Posez ensuite une courte question de confirmation :
Voulez-vous cela comme un diaporama HyperFrames ?
Utilisez une interface de choix oui/non lorsque l'environnement en fournit une ; sinon, posez la question en texte brut.
N'implémentez pas le diaporama tant que l'utilisateur n'a pas dit oui. S'il dit non, arrêtez d'utiliser cette compétence — lisez /hyperframes et laissez la couche d'intention réacheminer. Cette confirmation est une décision de routage, pas une porte de préférence — conformément au ../hyperframes/references/brief-contract.md § 1, elle survit au mode autonome ("surprenez-moi" ne l'ignore pas) : construire le mauvais type de livrable est un échec de qualité, pas un appel créatif.
Les deux parties
1. Scènes — déclarées de manière normale
Chaque diapositive est soutenue par une scène. Déclarez les scènes avec data-composition-id, data-start, data-duration et data-label :
<div
data-composition-id="problem"
data-start="0"
data-duration="8"
data-label="Le problème"
data-width="1920"
data-height="1080"
>
<!-- les clips vont ici -->
</div>
Les diapositives de dérivation (accessibles uniquement via une zone sensible, exclues de la ligne principale) sont déclarées exactement de la même manière — elles apparaissent uniquement dans une entrée slideSequences de l'îlot, pas dans le tableau slides principal.
2. L'îlot JSON — un bloc script par composition
Ajoutez exactement un bloc <script type="application/hyperframes-slideshow+json"> au HTML de la composition. Il contient toutes les métadonnées du diaporama :
<script type="application/hyperframes-slideshow+json">
{
"slides": [...],
"slideSequences": [...]
}
</script>
L'îlot est la source unique de vérité pour l'ordre des diapositives, les notes, les points d'arrêt des fragments, les zones sensibles et les séquences de dérivation. Placez-le près du haut du <body>, avant les divs de scène, afin qu'il soit facile à trouver.
Ne cachez pas le manifeste du diaporama derrière un bloc <script type="application/json"> alternatif plus du code d'exécution qui crée l'îlot. La commande present lit le HTML de la composition de manière statique et s'attend à ce que le véritable îlot application/hyperframes-slideshow+json soit déjà présent.
Schéma
SlideshowManifest (l'objet îlot de niveau supérieur)
{
"slides": [
/* SlideRef[] — la ligne principale, dans l'ordre */
],
"slideSequences": [
/* SlideSequence[] — séquences de dérivation hors ligne */
]
}
SlideRef
{
"sceneId": "problem",
"notes": "Commencez par la douleur, pas par l'entreprise.",
"fragments": [3.5, 5.2, 7.0],
"hotspots": [
/* SlideHotspot[] */
],
"ttsScript": null,
"ttsAudioUrl": null,
"ttsDurationMs": null
}
| Champ | Requis | Notes |
|---|---|---|
sceneId | oui | Doit correspondre exactement au data-composition-id d'une scène (ou fournir startTime/endTime explicites). La règle de lint résout les scènes par data-composition-id. |
notes | non | Texte réservé au présentateur. Jamais montré au public. |
fragments | non | Tableau de temps (secondes) dans la plage [start, end] de la diapositive — voir Fragments ci-dessous. |
hotspots | non | Superpositions interactives qui déclenchent une dérivation — voir Embranchements ci-dessous. |
startTime | non | Optionnel. Remplace les limites temporelles de la scène correspondante ; par défaut, le début/fin de la scène. |
endTime | non | Optionnel. Remplace les limites temporelles de la scène correspondante ; par défaut, le début/fin de la scène. |
ttsScript, ttsAudioUrl, ttsDurationMs | non | Réservé. Les champs de schéma existent mais la lecture TTS n'est pas encore câblée. Omettez sauf si vous pré-remplissez pour une version future. |
SlideHotspot
{
"id": "h1",
"label": "Comment avons-nous calculé cela ?",
"target": "market-deep-dive",
"region": { "x": 60, "y": 10, "w": 35, "h": 20 }
}
| Champ | Requis | Notes |
|---|---|---|
id | oui | Unique dans la diapositive. |
label | oui | Texte de l'infobulle / bouton affiché au public. |
target | oui | Doit correspondre à un SlideSequence.id dans slideSequences. |
region | non | Cadre de délimitation en pourcentage de la diapositive : {x, y, w, h} entre 0 et 100. Omettez pour rendre la zone sensible comme un bouton libellé sur toute la diapositive à la place. |
SlideSequence
{
"id": "market-deep-dive",
"label": "Méthodologie de dimensionnement du marché",
"slides": [{ "sceneId": "mkt-1" }, { "sceneId": "mkt-2" }]
}
slides à l'intérieur d'une séquence utilise la même forme SlideRef que la ligne principale. Les fragments et les zones sensibles imbriquées sont autorisés.
Règles d'écriture des diapositives
Ce sont des contraintes strictes, pas des suggestions. Une diapositive qui les enfreint sera purement et simplement remplacée lorsqu'un relecteur la verra.
- Le titre est une affirmation sous forme de phrase complète, pas une étiquette. Écrivez "Les PME consacrent 14 heures/semaine à la planification manuelle" et non "Problème de planification". La phrase doit être compréhensible seule même si l'élément visuel est ignoré.
- Une idée + un visuel par diapositive. Si vous êtes tenté d'ajouter un deuxième groupe de puces ou un deuxième graphique, divisez la diapositive.
- Commencez par le punch. Le point le plus fort vient en premier — sur la diapositive et dans l'ordre du deck. Les investisseurs lisent de gauche à droite, de haut en bas, et ils s'arrêtent.
- Dimensionnement du marché ascendant uniquement. N'écrivez jamais "TAM de 50 milliards de dollars" sans montrer les calculs. Construisez à partir de l'économie unitaire : comptes × ACV, ou transactions × take-rate.
- Taille de police minimale équivalente à 30pt. En 1920×1080, un titre fait 72–96px ; le corps du texte fait 48px. Ne descendez jamais en dessous de 40px pour un texte que le public doit lire.
- Recherchez dans le catalogue en direct avant de construire manuellement un visuel nommé. Pour chaque aspect, effet, graphique, traitement ou transition dont une diapositive a besoin — "lignes de balayage CRT", "glitch", "course de graphique à barres", "balayage chatoyant", "fenêtre de terminal" — exécutez
npx hyperframes catalog --query "<le visuel, en anglais simple>" --jsonet lisez les meilleurs résultats avant de créer les clips de la diapositive. La recherche ne nécessite rien d'installé : aucun projet, aucunaddpréalable, aucun compte. Elle classe l'ensemble du registre hébergé (~400 blocs et composants) depuis n'importe quel répertoire.npx hyperframes add <nom>dépose le code source du bloc dans le deck, où vous le personnalisez sur place. Cela s'applique avec une force particulière lors du portage d'une page source : un véritable bloc est meilleur que l'approximation simplifiée que les règles de portage ci-dessous interdisent.
Portage des pages sources
Lors de la conversion d'une page existante en diaporama, la fidélité à la source fait partie du contrat. Ne remplacez pas les widgets spécifiques à la source par des approximations simplifiées, sauf si l'utilisateur demande explicitement une refonte.
- Préservez le design visuel, le langage de mouvement, le comportement interactif, le comportement multimédia et les capacités de présentation de la page d'origine aussi fidèlement que possible. Lorsque le système de diaporama prend en charge le mode présentateur, incluez des notes de l'orateur en utilisant le comportement de notes modifiables partagé plutôt qu'une implémentation spécifique au deck.
- Portez les visuels mécaniques du DOM/CSS/JS source aussi exactement que possible : les lecteurs personnalisés, les visualiseurs canvas, les timelines, les têtes de lecture, les stems, les cercles en expansion, les états de survol et autres détails interactifs doivent survivre à la conversion.
- Traitez les éléments
<video>/<audio>natifs comme la source de vérité pour tout chrome multimédia personnalisé, visualiseur canvas, forme d'onde, grille de beats ou tête de lecture. Connectez les événements multimédia de la source (play,pause,timeupdate,seeking,seeked,ended,ratechange,volumechange) et déduisez l'état visuel demedia.currentTime; n'exécutez pas une minuterie séparée qui pourrait dériver par rapport à la lecture réelle. - Chaque
<video>ou<audio>copié avecsrcdoit avoir des attributs de temporisation HyperFrames avant le lint :data-startetdata-duration, plusdata-has-audio="true"lorsque l'audio natif audible doit être préservé. Utilisez la plage temporelle de la scène pour les médias spécifiques à une diapositive ; pour les vidéos de preuve contrôlées par l'utilisateur qui peuvent être lues à partir de plusieurs diapositives ciblées, utilisez une plage à l'échelle du deck. Ne laissez paspreload="none"sur les médias ; utilisezmetadataouauto. - Résolvez les jetons de police source avant la validation. Si vous conservez les polices source personnalisées, ajoutez des règles
@font-facepour les fichiers de polices locaux/capturés. Si vous utilisez des polices de secours système, remplacez les déclarations tokenisées telles quefont-family: var(--f-body)par des piles sécurisées pour le rendu concrètes telles quesystem-ui, sans-serifouui-monospace, monospace; ne laissez pasvar(...)comme valeur de la famille de polices. - Auditez la source pour les mouvements de page atypiques, en particulier le comportement piloté par le défilement, la molette, le toucher, l'état du hash, le redimensionnement ou une boucle requestAnimationFrame. Traitez les viewports fixes avec des couches "monde" traduites/mise à l'échelle, le parallaxe, les panneaux épinglés, les défileurs horizontaux, les timelines défilées, l'accrochage de sections et les caméras zoom-to-element comme un comportement source. Le défilement est souvent le déclencheur de transition de la source, donc préservez la transition en extrayant ses points d'arrêt de progression, son easing et ses états de caméra/focus, puis réhébergez ce mouvement sur la navigation du diaporama via des positions de timeline, des fragments ou un crochet de lecteur/harnais réutilisable. Les wrappers autonomes qui sautent vers des points d'arrêt de diapositive ont toujours besoin d'un crochet de transition de caméra de navigation explicite ; le calcul des transformations de caméra par diapositive ne suffit pas. Ne simulez pas une transition littérale de défilement vers le bas de page à l'intérieur de la diapositive ; le spectateur doit ressentir un voyage/zoom de caméra d'un point focal à un autre, et non voir une page web en cours de défilement. Gardez chaque mouvement de caméra entre diapositives continu : évitez les arrêts de route intermédiaires qui inversent la direction x/y ou dézoome