Communitygithub.com

deck-narrative

Architectez l'histoire, le contrat de perception du public et la thèse diapositive par diapositive d'une présentation avant de construire une diapositive ou un visuel. Utilisez-le au début de tout nouveau deck ou refonte de deck pour produire NARRATIVE.md, sélectionnez l'arc narratif approprié (Keynote, Pyramid, SCQA, Tech Walkthrough, Pitch), et justifiez chaque visuel planifié ou transition Morph au service de l'histoire.

Qu'est-ce que deck-narrative ?

Deck Narrative (Story Architect) est une compétence d'IA agent conçue pour les professionnels créant des présentations avec des outils comme Claude Code, Cursor ou Codex. Elle garantit que la narration guide chaque décision visuelle avant même de construire une diapositive. Le skill produit un fichier `NARRATIVE.md` structuré qui spécifie l'audience, le mode de livraison (live ou pré-lecture), un contrat de perception (ce que le public doit penser, ressentir, faire et ne pas ressentir), et la sélection d'un format d'expérience (par exemple, voyage 3D continu, documentaire, toile spatiale infinie ou bento asymétrique) aligné sur le travail narratif. Il se termine par un storyboard diapositive par diapositive où chaque diapositive a une thèse claire, une justification visuelle et une transition. La compétence est particulièrement utile pour les refontes et les nouveaux decks où l'histoire doit être solide avant que les visuels ne soient finalisés, évitant les présentations génériques ou encombrées.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SwePalm/deckcraft-skills/tree/HEAD/skills/deck-narrative

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Deck Narrative (Architecte d'histoire)

La narration est le phare. Les rendus 3D cool, les shaders et les transitions Morph ne rendent un deck génial que lorsqu'ils aiguisent la compréhension et la prise émotionnelle du public. Chaque deck commence par verrouiller NARRATIVE.md avant de toucher à deck-visuals ou deck-builder.

Ce que NARRATIVE.md doit contenir

Écrivez NARRATIVE.md avec quatre sections obligatoires :

  1. Audience et mode de livraison

    • Qui est dans la salle (dirigeants, ingénieurs, investisseurs, clients) ?
    • Mode de livraison : live (le présentateur parle ; les diapositives restent sous ~40 mots et portent un punch visuel) ou preread (lecture en solo/asynchrone ; les diapositives portent des takeaways complets jusqu'à ~100 mots).
    • Durée cible et budget de diapositives (~1,5 à 2 min par diapositive pour les decks live).
  2. Contrat de perception (Alimente deck-eval Gate 2 !)

    • Penser : Quelle thèse unique le public doit-il croire à la fin ?
    • Ressentir : Quel ton émotionnel le deck doit-il évoquer (ex. autorité technique calme, urgence momentum, clarté éditoriale) ?
    • Faire : Quelle décision ou action concrète doit se produire juste après la dernière diapositive ?
    • Anti-Perception (Ne jamais ressentir comme) : 2 à 3 choses que ce deck ne doit pas ressembler (ex. IA hype bâclée, dump de feuille de calcul dense, pitch corporate générique).
  3. Travail narratif → Format d'expérience (Briser la grammaire de diapositive par défaut) Ne supposez jamais que chaque histoire appartient à des diapositives Kicker + En-tête + Boîte de contenu. Laissez le Travail narratif sélectionner le Format d'expérience :

    • Découverte et Intuition (percée scientifique, mystère, "comment ça marche vraiment") → Voyage Continu en Caméra 3D + Beats de film (un monde 3D vivant, zéro en-tête de diapositive, survols de caméra entre les arrêts).
    • Révélation de Produit / Changement de Vision → Beats documentaires montés en film (plan large atmosphérique → statistique de tension monumentale 120pt+ → démo animée en direct → fermeture silencieuse).
    • Système Complexe / Stratégie → Toile Spatiale Infinie (une carte unifiée se déplaçant et zoomant sur les sous-systèmes via Morph).
    • Décision Exécutive / Pré-lecture → Magazine Éditorial / Bento Asymétrique (arc pyramidal, visualisation de données D3, décisions nettes).
    • Exploration Auto-rythmée → Histoire Web Interactive Double-Artéfact → Compilé .pptx.

    Choisissez également l'Arc narratif (voir references/narrative-patterns.md) :

    • Pyramide (Exec / Décision) : Réponse en premier → piliers de soutien → preuves → décision/prochaines étapes.
    • SCQA (Stratégique / Pitch) : Situation → Complication → Question → Réponse + Preuve.
    • Keynote Tension-Relâchement : Statu quo → Faille/Insight → Nouveau Monde → Preuve/Démo → Appel à l'aventure.
    • Parcours Technique : Problème/Contrainte → Modèle Mental du Système → Zoom Morph dans les Sous-systèmes → Compromis et Résultats.
  4. Tableau de storyboard diapositive par diapositive Pour chaque diapositive, spécifiez :

    • # de la diapositive et Rôle (Titre, Tension, Aperçu Pilier, Zoom Morph, Preuve de Données, Architecture, Fermeture)
    • Titre (Thèse, pas une étiquette de sujet) : ex. "Morph transforme l'architecture statique en focus guidé" plutôt que "Aperçu de l'architecture". Ne terminez jamais les titres par un point.
    • Point central et Indice pour les notes du présentateur : Ce que le public lit vs. ce que le présentateur dit.
    • Justification du Visuel / Mouvement : Pourquoi cette diapositive utilise une transition Morph, un visuel 3D Three.js, un graphique éditorial, ou une typographie pure. Si un visuel ne clarifie pas ou n'élève pas la thèse, supprimez-le.

Garde-fous narratifs

  • Un message par diapositive. Si une diapositive a deux affirmations concurrentes, divisez-la en deux diapositives.
  • Pas de diapositives orphelines. Lisez uniquement les titres des diapositives en séquence — ils doivent raconter toute l'histoire du début à la fin sans lacunes.
  • Gagnez chaque visuel. Chaque objet 3D, graphique ou mouvement Morph doit répondre : "Qu'est-ce que le public comprend plus rapidement ou ressent plus profondément parce que ceci est là ?"

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills associés