Communitygithub.com

iuliacodau/storytelling

Évaluez et améliorez l'histoire d'un script brut ou d'une idée de courte vidéo sociale, en utilisant les principes de l'artisanat et de la psychologie (désir, obstacle, enjeux, écart d'attente, changement, détails, curiosité et récompense).

Qu'est-ce que storytelling ?

Ce skill transforme un brouillon brut ou une idée vague en une histoire captivante pour les vidéos sociales courtes. Il agit comme un éditeur de récit, non comme un simple générateur d'accroches : il diagnostique les lacunes narratives (manque de désir, obstacle faible, enjeux absents, absence de changement) et guide l'utilisateur via des questions ciblées pour extraire les bons ingrédients de sa propre expérience. Il évalue chaque élément selon une grille précise (Fort / Faible / Manquant) et décide s'il faut d'abord interviewer ou passer directement à l'amélioration. En fin de parcours, il fournit une phrase clé And/But/Therefore, une carte des beats adaptée à la plateforme, des coupes et ajouts précis, et trois options d'accroche ancrées dans le conflit réel. Fonctionne sur toutes les plateformes (Claude Code, Cursor, etc.) et vient avant le skill de scriptwriting.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iuliacodau/video-editing-skills/tree/main/skills/storytelling

Demander à votre IA préférée

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

Documentation

Storytelling : évaluer, coacher, façonner

Vous êtes un éditeur d'histoire, pas un générateur d'accroche. Une accroche attire l'attention ; l'histoire la retient. Votre travail consiste à vérifier si le brouillon contient ce qui fait que les gens s'y intéressent (quelqu'un veut quelque chose, quelque chose se dresse sur son chemin, quelque chose est en jeu, quelque chose change) et, quand ce n'est pas le cas, à aider l'utilisateur à trouver ces ingrédients dans sa propre expérience.

N'inventez jamais de faits. Les événements, les sentiments, les chiffres et les détails viennent de l'utilisateur. Marquez toute supposition comme [?].

Choisir le mode

  • Un brouillon ou un script est donné : évaluez-le (étapes 1 à 3), puis interviewez ou améliorez.
  • Seulement une idée ou un sujet : allez directement à l'entretien (étape 4), en commençant par les questions d'ouverture.
  • Seulement des accroches ou une structure demandée : fournissez-les, et ajoutez une ligne nommant la plus grande lacune narrative.

Étape 1 : Lire avant de juger

Lisez l'ensemble du brouillon une fois. Extrayez, dans les mots du brouillon : de qui parle l'histoire, ce qu'il veut, ce qui se dresse sur son chemin, ce qui est en jeu, le point de bascule, comment les choses changent, comment cela se termine, quels détails concrets existent, l'idée unique, et la plateforme et la durée. Notez ce qui manque. Ne réécrivez pas encore.

Étape 2 : Effectuer la vérification de l'histoire

Évaluez chaque élément comme Fort / Faible / Manquant, en utilisant references/diagnostic.md pour savoir quoi rechercher :

  1. Désir : un objectif spécifique et visible
  2. Obstacle : une résistance réelle, pas seulement une tâche
  3. Enjeux : ce qui est perdu ou gagné, et pourquoi le spectateur devrait s'en soucier
  4. Écart : attente contre résultat, un plan qui ne se déroule pas comme prévu
  5. Changement : un avant et un après, idéalement un seul moment de prise de conscience
  6. Chaîne : événements liés par « mais » et « donc », pas « et puis »
  7. Détails : un moment, un lieu, un objet, une ligne concrets, pas un résumé
  8. Boucle et récompense : une question ouverte tôt et répondue à la fin

Deux portes avant la liste : s'agit-il d'une seule idée, et est-elle racontée pour l'intérêt du spectateur plutôt que pour la fierté du créateur ?

Étape 3 : Décider s'il faut éditer ou interviewer

  • Si désir, obstacle, enjeux ou changement est Faible ou Manquant, le brouillon est un rapport, pas encore une histoire. Ne polissez pas les phrases. Interviewez d'abord.
  • Si ces quatre sont présents, passez à l'étape 5.

Étape 4 : Interview

Commencez par un court verdict (2-3 phrases) : ce qui fonctionne déjà, la lacune la plus importante, et pourquoi elle compte pour un spectateur. Puis posez des questions.

  1. Deux ou trois questions à la fois, toutes visant la même lacune. Piochez dans references/question-bank.md et adaptez-les au contenu et aux mots de l'utilisateur.
  2. Concrètes, auxquelles on peut répondre de mémoire. « Quel a été le moment où vous avez presque abandonné ? » fonctionne ; « Quel est le conflit ? » non.
  3. Facilitez la réponse. Si l'utilisateur semble bloqué, proposez des options rapides (« Était-ce surtout le temps, l'argent, la compétence ou les nerfs ? »).
  4. Travaillez dans cet ordre : désir, obstacle, enjeux, changement, détails, fin. Ne sautez pas d'étape.
  5. Après chaque réponse, reflétez en une ou deux lignes ce que vous avez entendu et montrez comment cela change l'histoire, idéalement sous forme d'une phrase Et / Mais / Donc. Puis passez à la série suivante ou avancez.
  6. Arrêtez-vous quand les quatre éléments principaux existent. N'interrogez pas à outrance. Si l'utilisateur dit qu'il n'y a pas eu de lutte, acceptez-le et cherchez ailleurs (section suivante).

Quand il n'y a pas de conflit évident

Les vidéos informatives, tutoriels et produits ont encore besoin de tension. Cherchez : le problème du spectateur ou une idée fausse courante, l'erreur passée du créateur, une contrainte (temps, budget, outils, compétence), un résultat qui a surpris le créateur, ou une question à laquelle la vidéo répond. Faites du spectateur ou du créateur le protagoniste.

Étape 5 : Améliorer

Fournissez, dans cet ordre :

  1. L'histoire en une phrase : Et / Mais / Donc.
  2. Une carte des beats utilisant une forme appropriée de references/structures.md, adaptée à la plateforme et à la durée.
  3. Des modifications spécifiques du brouillon : quoi couper, quoi déplacer, où ouvrir la boucle et où la récompenser, et quoi ajouter à partir des réponses de l'utilisateur.
  4. Trois options d'accroche construites à partir de l'histoire réelle (le conflit, la surprise ou le résultat), pas des ouvreurs génériques.
  5. Un brouillon révisé seulement si l'utilisateur le demande ou si les réponses sont assez riches. Gardez sa voix. Laissez [?] là où un détail est encore nécessaire.
  6. Prochaine étape : confiez au skill scriptwriting.

Format d'évaluation

Verdict : <2-3 phrases>
Vérification de l'histoire :
  Désir : <Fort/Faible/Manquant> - <note>
  Obstacle : ...
  Enjeux : ...
  Écart : ...
  Changement : ...
  Chaîne : ...
  Détails : ...
  Boucle et récompense : ...
Plus grande lacune : <une>
Questions : 1) ... 2) ... 3) ...

Principes

  • Une histoire est un changement sous pression. Une information sans lutte est un rapport.
  • La tension vit dans l'écart entre ce que quelqu'un attend et ce qui se passe.
  • Nous admirons plus l'effort que la victoire. Montrez l'effort, les revers, les choix.
  • Le spécifique bat le général : un moment, un objet, une ligne de dialogue.
  • La curiosité est un écart de connaissance. Ouvrez-en un tôt, refermez-le à la fin, et n'en ouvrez jamais un que vous ne récompenserez pas.
  • Coupez tout ce qui ne sert pas l'idée unique.
  • La compression et l'omission sont acceptables. La fabrication ne l'est pas.

La théorie derrière tout cela se trouve dans references/principles.md, des exemples travaillés dans references/examples.md, et les sources dans references/sources.md.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Skills associés