Installation du plugin : Avant les commandes de configuration ou de mise à jour, suivez les règles d'exécution du plugin lorsque cette compétence se trouve dans un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.
D'abord, maintenez 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 de base du domaine dont elle dépend avant que vous ne les utilisiez.
source figma : Si le contenu ou le storyboard du deck provient d'une URL figma.com, exécutez
/figmad'abord — export des actifs, tokens de marque et reconstruction du storyboard si la source est une série d'images 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 liaison desvar()des tokens de marque, donc 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 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). Cette compétence ne couvre que ce qui est nouveau : le schéma de l'îlot, les règles d'écriture des diapositives, fragments, embranchements, 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 transfert ci-dessous.
N'utilisez pas hyperframes render sur un diaporama pour le transformer en un seul MP4. Un deck est créé comme plusieurs compositions de scènes de premier niveau (un data-composition-id par diapositive) sans composition racine maîtresse les encapsulant, donc render résout uniquement la première composition et émet un MP4 tronqué silencieusement (par exemple, 6 secondes d'un deck de 40 secondes). Un export linéaire principal (diapositives principales seulement, séquences d'embranchements exclues) est différé — 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, exposez 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 cette compétence. Lorsque la demande arrive via /hyperframes, le tri de la couche d'intention gère cette confirmation — être aiguillé ici signifie déjà confirmé, donc ne redemandez pas ; les questions de mise en forme de la couche d'exécution 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 connexe telle que « présentation », « pitch deck », « deck », « deck interactif » ou « convertir cette page », faites une pause avant de créer et encadrez 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 des médias de la page d'origine tout en traduisant le mouvement de la page en transitions entre diapositives.
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, cessez d'utiliser cette compétence — lisez /hyperframes et laissez la couche d'intention réorienter. Cette confirmation est une décision de routage, pas une porte de préférence — conformément à ../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 choix 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 d'embranchement (accessibles uniquement via une zone interactive, exclues de la ligne principale) sont déclarées exactement de la même manière — elles apparaissent seulement dans une entrée slideSequences de l'îlot, pas dans le tableau principal slides.
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 interactives et les séquences d'embranchement. Placez-le près du début du <body>, avant les divs des scènes, pour qu'il 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'îlot. La commande present lit le HTML de la composition de manière statique et s'attend à ce que l'îlot réel 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 d'embranchement 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 des 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 (en secondes) dans la plage [start, end] de la diapositive — voir Fragments ci-dessous. |
hotspots | non | Superpositions interactives qui déclenchent un embranchement — voir Embranchement ci-dessous. |
startTime | non | Optionnel. Remplace les limites temporelles de la scène correspondante ; par défaut, début/fin de la scène. |
endTime | non | Optionnel. Remplace les limites temporelles 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 au sein de 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 interactive comme un bouton plein écran. |
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 zones interactives imbriquées 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 en phrase complète, pas une étiquette. Écrivez « Les PME consacrent 14 heures/semaine à la planification manuelle » pas « Problème de planification ». La phrase doit pouvoir tenir seule 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 chute. 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 × taux de prélèvement.
- Taille de police minimale équivalente à 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 apparence, 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 simple>" --jsonet lisez les meilleurs résultats avant de créer les clips de la diapositive. La recherche n'a besoin de rien 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 vrai bloc surpasse 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 à moins que l'utilisateur ne demande explicitement une refonte.
- Préservez la conception visuelle, le langage d'animation, le comportement interactif, le comportement des médias 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 les 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 : joueurs personnalisés, visualiseurs canvas, timelines, têtes de lecture, stems, 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 média personnalisé, visualiseur canvas, forme d'onde, grille de battements ou tête de lecture. Connectez les événements média 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 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 à la diapositive ; pour les vidéos de preuve contrôlées par l'utilisateur qui peuvent être lues depuis 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 préservez 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 concrètes sûres pour le rendu 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 de la souris, 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, le parallaxe, 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 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 hébergez ce mouvement sur la navigation du diaporama via des positions de timeline, des fragments ou un hook de lecteur/harnais réutilisable. Les wrappers autonomes qui sautent aux points d'arrêt des diapositives ont toujours besoin d'un hook 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 vers le bas de la page dans...
… [tronqué pour la traduction]