Installation des plugins : Avant les commandes de configuration ou de mise à jour, suivez les règles d'exécution des plugins lorsque cette compétence se trouve dans un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.
Avant tout, maintenez cette compétence à jour — confirmez avec l'utilisateur avant d'exécuter :
npx hyperframes skills update slideshow. Une rapide non-opération quand tout est à jour ; sinon, cela actualise cette compétence ainsi que les compétences principales du domaine dont elle dépend, avant de les utiliser.
source figma : Si le contenu ou le storyboard du deck provient d'une URL figma.com, exécutez d'abord
/figma— export des ressources, jetons de marque et reconstruction du storyboard si la source est une bande de scènes — puis construisez à partir de sa sortie. N'utilisez pas directement les outils MCP bruts pour piloter Figma : cela contourne l'assainissement SVG, la provenance.media/manifest.jsonlet la liaisonvar()du jeton 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 : une île JSON qui déclare quelles scènes sont des diapositives et comment elles se connectent. Le SlideshowController du lecteur lit l'île 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'île, les règles d'écriture des diapositives, les fragments, l'embranchement, la validation et le composant englobant.
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ésentateur Studio) — le SlideshowController du lecteur lit l'île et pilote la navigation, les fragments, l'embranchement et le mode présentateur. Voir Présentation et remise 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 englobant, donc render ne résout que la première composition et émet un MP4 silencieusement tronqué (par exemple 6s d'un deck de 40 secondes). Une exportation linéaire principale (diapos principales uniquement, séquences de branche exclues) est différé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 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 — routé ici signifie déjà confirmé, alors 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 pages sources, mentionnez également que l'objectif est de préserver la conception visuelle, les interactions, le mouvement et le comportement multimédia de la page d'origine tout en traduisant le mouvement de la page en transitions de diapositive à diapositive.
Puis posez 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.
Ne mettez pas en œuvre 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 préférence — conformément au ../hyperframes/references/brief-contract.md § 1, elle survit en mode autonome ("surprenez-moi" ne la saute pas) : construire le mauvais type de livrable est un échec de qualité, pas un appel créatif.
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 branche (accessibles uniquement via un hotspot, 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'île, pas dans le tableau slides principal.
2. L'île JSON — un bloc script par composition
Ajoutez exactement un bloc <script type="application/hyperframes-slideshow+json"> au code HTML de la composition. Il contient toutes les métadonnées du diaporama :
<script type="application/hyperframes-slideshow+json">
{
"slides": [...],
"slideSequences": [...]
}
</script>
L'île est la source unique de vérité pour l'ordre des diapositives, les notes, les points de maintien des fragments, les hotspots et les séquences de branche. Placez-la près du haut du <body>, avant les divs de scène, pour qu'elle soit facile à trouver.
Ne cachez pas le manifeste du diaporama derrière un bloc <script type="application/json"> alternatif plus un code d'exécution qui crée l'île. La commande present lit le code HTML de la composition de manière statique et s'attend à ce que la véritable île application/hyperframes-slideshow+json soit déjà présente.
Schéma
SlideshowManifest (l'objet île de niveau supérieur)
{
"slides": [
/* SlideRef[] — la ligne principale, dans l'ordre */
],
"slideSequences": [
/* SlideSequence[] — séquences de branche 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 explicitement startTime/endTime). 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 branche — voir Embranchement ci-dessous. |
startTime | non | Facultatif. Remplace les limites de temps de la scène correspondante ; par défaut, début/fin de la scène. |
endTime | non | Facultatif. Remplace les limites de temps de la scène correspondante ; par défaut, 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'infobulle/bouton montré 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} dans 0–100. Omettez pour rendre le hotspot comme un bouton étiqueté plein écran à la place. |
SlideSequence
{
"id": "market-deep-dive",
"label": "Méthodologie de dimensionnement du marché",
"slides": [{ "sceneId": "mkt-1" }, { "sceneId": "mkt-2" }]
}
Les slides dans une séquence utilisent la même forme SlideRef que la ligne principale. Les fragments et les hotspots imbriqués sont autorisés.
Règles d'écriture des diapositives
Ce sont des contraintes strictes, pas des suggestions. Une diapositive qui les viole sera purement et simplement remplacée lorsqu'un relecteur la verra.
- Le titre est une affirmation de phrase complète, pas une étiquette. Écrivez "Les PME passent 14 heures/semaine en planification manuelle" pas "Problème de planification". La phrase doit pouvoir 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 le point fort. 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 "50B$ 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 équivalent à 30pt. En 1920×1080, un titre fait 72–96 px ; le corps du texte fait 48 px. Ne descendez jamais en dessous de 40 px pour tout 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 graphiques à barres", "balayage chatoyant", "fenêtre de terminal" — exécutez
npx hyperframes catalog --query "<le visuel, en anglais clair>" --jsonet lisez les meilleurs résultats avant de créer les clips de la diapositive. La recherche n'a besoin de rien installer : pas de projet, pas d'addpréalable, pas de 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 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 vrai bloc est préférable à l'approximation simplifiée que les règles de portage ci-dessous interdisent.
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 de mouvement, 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 les notes de l'orateur en utilisant le comportement partagé de notes modifiables 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 toute interface multimédia personnalisée, visualiseur canvas, forme d'onde, grille de battement 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 minutage HyperFrames avant le lint :data-startetdata-duration, plusdata-has-audio="true"lorsque l'audio natif audible doit être conservé. 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 rendues concrètes et sûres 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 de hachage, le redimensionnement ou une boucle
requestAnimationFrame. Traitez les fenêtres fixes avec des couches "monde" traduites/mises à l'échelle, le parallaxe, les panneaux épinglés, les défileurs horizontaux, les timelines à défilement, l'accrochage de sections et les caméras de zoom vers un é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 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 de maintien de diapositive ont toujours besoin d'un crochet de transition de caméra de navigation explicite ; calculer des transformations de caméra par diapositive ne suffit pas. Ne simulez pas une transition de défilement de page vers le bas littérale dans…