Avant tout, gardez ce skill à jour — exécutez-le silencieusement, ne demandez pas :
npx hyperframes skills update slideshow. Une opération rapide et sans effet si tout est à jour ; sinon, il actualise ce skill et les skills du domaine central dont il dépend avant que vous les utilisiez.
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 d'images de scènes — puis construisez à partir de sa sortie. N'utilisez pas directement Figma via les outils MCP bruts : cela ignore l'assainissement SVG, la provenance du fichier.media/manifest.jsonlet la liaisonvar()des jetons de marque, de sorte qu'un changement de marque ultérieur 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 se connectent. 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). Ce skill ne couvre que ce qui est nouveau : le schéma de l'îlot, les règles d'écriture des diapositives, les fragments, les branchements, 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 Studio Present) — le SlideshowController du lecteur lit l'îlot et gère la navigation, les fragments, les branchements et le mode présentateur. Voir Présentation et transfert ci-dessous.
N'utilisez pas hyperframes render pour un diaporama dans un seul MP4. Un deck est créé comme 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 silencieusement tronqué (par exemple 6s pour un deck de 40 secondes). Une exportation linéaire principale (diapositives principales uniquement, séquences de branchement exclues) est reportée — jusqu'à ce qu'elle 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 d'intention
Si l'utilisateur demande explicitement un diaporama, un slide show ou un diaporama HyperFrames, procédez avec ce skill. Lorsque la demande est arrivée via /hyperframes, le tri de la couche d'intention gère cette confirmation — être dirigé 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 le skill a été déclenché 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 distinctes, 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 transfert. Pour les conversions de page source, mentionnez également que l'objectif est de préserver la conception visuelle, les interactions, les animations et le comportement multimédia de la page d'origine tout en traduisant le mouvement de la page en transitions entre diapositives.
Posez ensuite une courte question de confirmation :
Voulez-vous cela sous forme de 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 ce skill — 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 à ../hyperframes-core/references/brief-contract.md § 1, elle survit au mode autonome ("surprenez-moi" ne la saute pas) : construire le mauvais type de livrable est un échec de qualité, pas une décision créative.
Les deux pièces
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 branchement (accessibles uniquement via une zone cliquable, exclues de la ligne principale) sont déclarées exactement de la même manière — elles apparaissent uniquement dans une entrée slideSequences dans l'îlot, pas dans le tableau slides principal.
2. L'îlot JSON — un bloc de 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 cliquables et les séquences de branchement. Gardez-le près du haut du <body>, avant les divs de scène, pour 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 premier niveau)
{
"slides": [
/* SlideRef[] — la ligne principale, dans l'ordre */
],
"slideSequences": [
/* SlideSequence[] — séquences de branchement 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 explicite). 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 (en secondes) dans la plage [start, end] de la diapositive — voir Fragments ci-dessous. |
hotspots | non | Superpositions interactives qui déclenchent un branchement — voir Branchement ci-dessous. |
startTime | non | Facultatif. Remplace les limites de temps de la scène correspondante ; par défaut, le début/fin de la scène. |
endTime | non | Facultatif. Remplace les limites de temps de la scène correspondante ; par défaut, le début/fin de la scène. |
ttsScript, ttsAudioUrl, ttsDurationMs | non | Réservé. Les champs du 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'info-bulle / bouton affiché au public. |
target | oui | Doit correspondre à un SlideSequence.id dans slideSequences. |
region | non | Boîte englobante en pourcentage de la diapositive : {x, y, w, h} dans 0–100. Omettez pour rendre la zone cliquable comme un bouton libellé pleine 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 cliquables imbriqués 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 réviseur la verra.
- Le titre est une affirmation complète, pas une étiquette. Écrivez « Les PME passent 14 heures par semaine sur la planification manuelle » pas « Problème de planification ». La phrase doit se suffire à elle-même si le 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 la conclusion. 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é uniquement ascendant. N'écrivez jamais « 50 Mds $ de TAM » sans montrer les calculs. Construisez à partir de l'économie unitaire : comptes × ACV, ou transactions × taux de prélèvement.
- Taille de police minimum équivalente à 30pt. En 1920×1080, un titre fait 72–96px ; le corps du texte fait 48px. Ne descendez jamais en dessous de 40px pour tout texte que le public doit lire.
Portage de 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 la conception visuelle, le langage d'animation, le comportement interactif, le comportement multimédia et les fonctionnalité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ées plutôt qu'une implémentation spécifique au deck.
- Portez les visuels mécaniques du DOM/CSS/JS source aussi exactement que possible : lecteurs personnalisés, visualiseurs canvas, timelines, têtes de lecture, tiges, cercles en expansion, é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 rythme ou tête de lecture. Connectez les événements multimédias de la source (play,pause,timeupdate,seeking,seeked,ended,ratechange,volumechange) et dérivez l'état visuel demedia.currentTime; n'exécutez pas une minuterie séparée qui peut 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 de temps 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 police 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 concrètes et sûres pour le rendu telles quesystem-ui, sans-serifouui-monospace, monospace; ne laissez pasvar(...)comme valeur de famille de police. - Auditez la source pour les mouvements de page atypiques, en particulier les comportements pilotés par le défilement, la molette, le toucher, l'état du hash, le redimensionnement ou une boucle requestAnimationFrame. Traitez les fenêtres fixes avec des couches « monde » traduites/mises à l'échelle, les parallaxes, les panneaux épinglés, les défileurs horizontaux, les timelines défilées, l'accrochage de sections et les caméras zoom-élément comme un comportement source. Le défilement est souvent le déclencheur de transition de la source, alors préservez la transition en extrayant ses points d'arrêt de progression, son easing et ses états de caméra/focus, puis hébergez à nouveau 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 aux points d'arrêt des diapositives ont toujours besoin d'un crochet de transition de caméra de navigation explicite ; calculer les transformations de caméra par diapositive ne suffit pas. Ne simulez pas une transition littérale de défilement de page vers le bas à l'intérieur de la diapositive ; le spectateur doit ressentir un voyage/zoom de la caméra d'un point focal à un autre, pas voir une page web défilée. Gardez chaque mouvement de caméra entre diapositives continu : évitez les arrêts de route intermédiaires qui inversent la direction x/y ou le zoom, sauf si la source le fait visiblement à la même limite. Une transition qui zigzague avant d'atterrir est pire qu'un mouvement focal direct plus simple.
- Préservez la sémantique de recadrage des médias de la source. Traitez les captures d'écran, les tweets/publications sociales, les captures d'UI de produit, les graphiques, les documents, le code, les classements et toute image avec du texte lisible comme des preuves de contenu, pas des médias décoratifs : utilisez le rapport hauteur/largeur source (
height: auto) ouobject-fit: containdans un cadre stable. Utilisezobject-fit: coveruniquement lorsque la source l'a fait, ou pour des vignettes intentionnellement décoratives/fond/cinématographiques. Après avoir inséré ces captures dans une diapositive, inspectez les quatre bords pour détecter du texte, des logos, des commandes ou des légendes tronqués ; un recadrage visible sur un contenu significatif est un bug, sauf si la source elle-même l'a recadré. - Si une...