Compétences en scénarisation : 24 compétences d’agent pour l’écriture de films et de séries TV

Les logiciels d’écriture peuvent générer rapidement des scènes. Écrire un scénario qui entretient le conflit, maîtrise l’information, respecte le format et résiste aux révisions est bien plus difficile. Le dépôt open source jtydhr88/screenwriting-skills répond à cette lacune avec une bibliothèque structurée de 24 compétences d’agent pour la scénarisation, l’écriture télévisuelle, le théâtre et la dramaturgie.

Le projet transforme les idées issues de 45 ouvrages consacrés à l’écriture et de 23 scénarios, partitions et pièces publiés en fichiers SKILL.md réutilisables. Ces fichiers sont conçus pour Claude Code et OpenAI Codex, mais ils suivent le format indépendant des agents de openagentskills.io, de sorte que tout agent compatible peut potentiellement les utiliser.

À quel problème cela répond-il ?

Un modèle de langage généraliste peut savoir qu’un scénario a besoin d’un protagoniste, d’un conflit, de scènes et de dialogues. Il peut néanmoins produire des conversations saturées d’exposition, des fins d’acte faibles, des motivations de personnages incohérentes ou des épisodes de série dépourvus de moteur narratif reproductible.

Ces compétences proposent un processus de travail plus rigoureux. Au lieu de demander à un agent de « rendre le scénario meilleur », un auteur peut invoquer une capacité ciblée pour :

Trouver l’idée directrice et tester une prémisse
Construire la structure d’un long métrage ou d’une série
Concevoir un réseau de personnages générateur de conflits
Réécrire les dialogues comme des actions plutôt que comme une simple transmission d’informations
Découper un épisode en actes et fins d’acte
Créer une bible de série et des documents de présentation
Adapter un roman en drame en plusieurs épisodes
Analyser des scénarios publiés et des traditions dramatiques
Conserver l’état d’un projet au fil de plusieurs sessions d’écriture

Le résultat se rapproche davantage d’un assistant d’écriture attentif aux principes du métier que d’un générateur de texte générique.

Installation

Installation depuis la marketplace de Claude Code

L’installation recommandée dans Claude Code utilise la marketplace de plugins :

/plugin marketplace add jtydhr88/screenwriting-skills
/plugin install screenwriting@screenwriting-skills

Les compétences sont ensuite disponibles dans l’espace de noms /screenwriting:<skill>. Par exemple :

/screenwriting:sw-dialogue

Pour voir les compétences chargées dans l’environnement actuel, exécutez :

/skills

Claude Code : installation pour tous les projets

git clone https://github.com/jtydhr88/screenwriting-skills.git
cp -r screenwriting-skills/plugins/screenwriting/skills/* ~/.claude/skills/

Claude Code : installation dans un seul projet

mkdir -p .claude/skills
cp -r screenwriting-skills/plugins/screenwriting/skills/* .claude/skills/

Installation dans Codex

Pour Codex CLI, l’application de bureau ChatGPT ou une extension d’IDE, ajoutez la marketplace et installez le plugin :

codex plugin marketplace add jtydhr88/screenwriting-skills

Choisissez ensuite Plugins → Screenwriting Skills → Install.

Les mêmes 24 fichiers SKILL.md sont distribués via le répertoire partagé skills/ du plugin. Il n’existe pas d’édition Codex réécrite séparément.

Pour une installation personnelle de Codex :

git clone https://github.com/jtydhr88/screenwriting-skills.git
cp -r screenwriting-skills/plugins/screenwriting/skills/* ~/.agents/skills/

Pour une installation propre à un projet :

mkdir -p .agents/skills
cp -r screenwriting-skills/plugins/screenwriting/skills/* .agents/skills/

Vous pouvez invoquer explicitement une compétence avec une commande telle que $sw-story-structure, ou laisser l’agent détecter automatiquement le contexte pertinent.

Une architecture en quatre couches

Le dépôt organise ses compétences en quatre couches. Cette distinction est importante, car un long métrage, une série en streaming, une pièce de théâtre et un opéra chinois peuvent partager certains principes dramatiques tout en exigeant des structures et des règles d’écriture très différentes.

1. Dramaturgie générale

La couche indépendante du médium couvre les fondements utilisés dans tous les projets :

sw-workflow : orchestration du projet, livrables, jalons de validation et fichiers story-bible.md persistants
sw-story-structure : points de l’intrigue, paradigmes, beats, complications, crises, climax, intrigues secondaires, ouvertures et dénouements
sw-premise-theme : tests de prémisse, idées directrices, loglines, conflit thématique et cœur de l’histoire
sw-character-conflict : psychologie des personnages, opposition, orchestration et conflit croissant
sw-dialogue : dialogue comme action, sous-texte, exposition, vocabulaire des personnages et problèmes au niveau de la réplique
sw-scene-craft : renversements de valeur, analyse de scène, rythme, transitions, accessoires et entrée tardive ou sortie précoce
sw-format-adaptation : formatage de scénario, sortie Fountain, conventions des scénarios chinois et japonais, adaptation et révision

Un workflow utile pour un long métrage peut aller de la prémisse à la structure, puis aux personnages, aux scènes, au brouillon, à la révision et à la soumission. La compétence de workflow nomme la compétence pertinente à chaque étape et définit des contrôles de sortie indicatifs.

2. Écriture propre au médium

La deuxième couche ajoute des règles que les ouvrages généraux sur la scénarisation ne peuvent pas enseigner entièrement :

sw-series-structure : teasers, cold opens, grilles d’actes pour la diffusion, tests d’actes pour le streaming, fins d’acte, cliffhangers, tissage des intrigues A/B/C, beats de pilote et construction de la saison
sw-series-engine-bible : moteurs de série reproductibles, réseaux de personnages, types de pilotes, pièges narratifs et documents de présentation
sw-writers-room : élaboration des histoires, responsabilités du showrunner, rôles de l’équipe, chaînes de documents, notes, calendriers et contraintes de production
sw-sitcom-comedy : comédie d’une demi-heure, mécanique des blagues, running gags, cold opens, tags, multi-caméra, caméra unique, animation et dramédie
sw-chinese-series-practice : formats télévisuels chinois, suspense des épisodes, processus d’adaptation, étapes de production, contrats et limites de contenu
sw-chinese-opera-banqiang : système vocal banqiang utilisé dans des traditions telles que l’opéra de Pékin, le Yuju, le Yueju, le Qinqiang, le Pingju et l’opéra Hu
sw-chinese-opera-qupai : systèmes de mélodies fixes utilisés dans des formes telles que le théâtre Yuan, le chuanqi des dynasties Ming et Qing, le kunqu et le style aigu de l’opéra du Sichuan

La couche consacrée aux séries comprend des repères temporels concrets, notamment des repères de pages pour la diffusion autour des pages 17–18, 30, 45 et 60, ainsi que des découpages de pilotes indiquant les minutes. Elle couvre également la différence pratique entre une histoire qui fonctionne une fois et un moteur de série capable de générer de nombreux épisodes supplémentaires.

3. Tradition et industrie

La troisième couche replace la technique dans un contexte culturel et commercial :

Études de cas de longs métrages américains
Méthodes de scénarisation japonaises
Approches d’écriture coréennes et françaises
Pratiques de production télévisuelle chinoises
Industrie, présentation de projets, options, crédits, agents, contexte de la WGA et développement destiné aux acheteurs

Cette couche est particulièrement utile lorsqu’un agent doit comparer des méthodes plutôt que présenter une formule prétendument universelle. Le dépôt conserve les désaccords entre les sources, comme la grille en quatre actes de Douglas et l’argument d’Oberg selon lequel les ruptures d’acte sont avant tout déterminées par la pression de l’histoire et les réalités de production.

4. Corpus principaux

La dernière couche traite les œuvres complètes comme du matériau de travail plutôt que comme de simples exemples inspirants. Elle comprend :

Les pièces en plusieurs actes et en un acte de Tchekhov
Six scénarios d’Ozu
Les quatre saisons de Succession, couvrant 39 scénarios de tournage
Des études de cas de The West Wing, The Sopranos, Downton Abbey, Fleabag et d’autres séries

La compétence succession-series-writing, par exemple, examine les chambres de pression, les épisodes construits autour de cérémonies, l’humiliation descendante, les indications scéniques porteuses de sous-texte, les renversements déclenchés par un seul mot, les répliques alternatives et la difficulté de construire une fin lorsque le moteur principal perd de sa pression.

Exemples d’utilisation pratique

Un auteur peut utiliser la bibliothèque avec des demandes en langage naturel :

Découpe ma série de 12 épisodes en actes et place les fins d’acte.

Cela devrait orienter vers sw-series-structure.

Mes dialogues sont tous trop explicites. Diagnostique le problème et réécris la scène.

Cela combine sw-dialogue et sw-scene-craft.

Transforme ce roman de 400 000 mots en synopsis d’une série chinoise de 40 épisodes.

Cela nécessite sw-chinese-series-practice et sw-series-engine-bible, les choix d’adaptation devant être explicités plutôt que de compresser silencieusement la source.

Mets en place un projet et aide-moi à suivre son avancement.

C’est le rôle de sw-workflow, qui utilise une convention de bible d’histoire pour conserver l’état du projet d’une session à l’autre.

Pourquoi la conception multilingue utilise-t-elle un arbre source unique ?

Le contenu des compétences est rédigé en chinois, car une grande partie des sources se compose d’œuvres chinoises originales ou de traductions chinoises. Cependant, la langue de réponse de l’agent suit la demande de l’auteur. Celui-ci peut poser sa question en anglais, japonais, coréen ou français et recevoir une réponse dans cette langue.

Cela évite de maintenir des arbres de compétences traduits séparés. Le projet possédait auparavant une édition anglaise, mais la maintenance d’arbres parallèles crée un problème de synchronisation à long terme : dès qu’une traduction existe, les utilisateurs demandent logiquement le japonais, le coréen, le français, le russe et bien d’autres langues. Cinq arbres linguistiques représenteraient des centaines de fichiers susceptibles d’évoluer indépendamment.

La terminologie est gérée par des correspondances dans sw-workflow/terms.md. Des concepts tels que « logline », « act out », « beat sheet », « showrunner » et « staff writer » restent ancrés dans leurs termes professionnels d’origine. Les termes sans équivalent satisfaisant peuvent conserver le mot original accompagné d’une explication.

Cette approche implique un compromis : les lecteurs qui ne lisent pas le chinois ne peuvent pas auditer directement les fichiers d’instructions sous-jacents. Les README traduits fournissent les informations relatives à l’installation, à la structure et aux règles, tandis que les tableaux complets des compétences et la bibliographie restent dans la documentation principale et chinoise.

Des références détaillées sans fichiers de compétences surdimensionnés

Chaque compétence contient un fichier SKILL.md avec des principes, des workflows et des listes de contrôle. Presque toutes les compétences comprennent également un fichier reference.md contenant des tableaux, des exemples, des extraits et des analyses détaillées.

Certaines sections plus volumineuses sont réparties entre plusieurs fichiers de référence. Par exemple, les études de cas de séries divisent le contenu entre des collections de scénarios anglophones, des découpages de pilotes et des textes asiatiques. La compétence consacrée au moteur de série sépare les analyses de moteurs, les tableaux de champs documentaires et les exemples achevés.

Cette séparation permet de conserver des instructions opérationnelles faciles à gérer. Le dépôt vise également à maintenir les fichiers SKILL.md en dessous d’environ 40 Ko et les descriptions des compétences sous la limite de 1 024 caractères imposée par les conventions du projet.

Ajouter de nouveaux médias sans affaiblir le socle

Le dépôt applique une règle stricte pour déterminer si un nouveau genre mérite sa propre compétence : il doit modifier les règles de structure, de format ou de langage de l’écriture. Une catégorie thématique comme le thriller d’espionnage ou le drame familial ne suffit pas automatiquement. Ces catégories relèvent des études de cas, sauf si un corpus complet et distinctif justifie un traitement dédié.

Un nouveau médium doit ajouter :

Une nouvelle compétence
Un tableau de démarcation expliquant quelles méthodes générales sont transposables
Une entrée dans le tableau de routage du workflow

Les compétences générales ne doivent pas être réécrites chaque fois qu’un nouveau médium est ajouté. Cette architecture a permis à la couche consacrée aux séries et à celle consacrée à l’opéra chinois de s’étendre sans modifier les compétences fondamentales liées à la prémisse, à la structure, au dialogue et aux scènes.

L’opéra chinois illustre l’importance de cette séparation. Le banqiang et le qupai sont traités comme deux systèmes, car leurs structures vocales, leurs méthodes lyriques et leurs unités scéniques diffèrent. Les traditions régionales au sein d’un même système peuvent souvent être traitées dans des annexes de référence plutôt que dans des compétences distinctes, ce qui évite de créer des centaines de compétences presque identiques pour chaque genre régional.

Sources et licence

Le projet s’appuie sur 17 ouvrages consacrés à l’écriture de scénarios, 15 ouvrages sur l’écriture télévisuelle, des scénarios et pièces publiés, ainsi que sur une importante théorie de l’opéra chinois, des scripts et des partitions. Parmi les sources figurent les travaux de Syd Field, Blake Snyder, Robert McKee, Lajos Egri, Lisa Cron, Neil Landau, Pamela Douglas, William Rabkin, Jesse Armstrong, Aaron Sorkin, Phoebe Waller-Bridge, Tchekhov, Ozu et de nombreux auteurs et théoriciens chinois.

Le dépôt est distribué sous une licence autorisant l’étude personnelle. Les citations restent la propriété de leurs auteurs et traducteurs d’origine ; il est donc préférable de le considérer comme un outil d’apprentissage et de développement plutôt que comme un substitut aux sources sous licence.

À qui s’adresse-t-il ?

Cette collection convient particulièrement aux :

Scénaristes développant des longs métrages ou des pilotes
Auteurs de télévision construisant une bible de série
Showrunners et membres d’équipes d’écriture
Chercheurs comparant les traditions dramatiques
Développeurs testant des compétences d’agent spécialisées par domaine
Auteurs adaptant des romans, des pièces ou des propriétés intellectuelles existantes
Enseignants concevant des exercices d’écriture structurés

Elle convient moins aux utilisateurs qui recherchent une commande « écris-moi un scénario » en un clic. Sa valeur réside dans le développement par étapes, les choix d’écriture explicites, les alternatives étayées par les sources et la révision répétée.

Avec 1 000 étoiles et 118 forks indiqués sur GitHub, le dépôt a suscité un intérêt important en tant qu’exemple de mise en forme de connaissances spécialisées pour des agents de programmation. Son idée la plus importante est architecturale : au lieu de demander à un modèle généraliste de retenir simultanément toutes les règles de la scénarisation, il vaut mieux lui donner de petites compétences composables, sélectionnées en fonction du problème d’écriture rencontré.

Source

jtydhr88/screenwriting-skills : compétences d’agent professionnelles pour la scénarisation, l’écriture télévisuelle et la dramaturgie