Aller au contenu

Skill Writing Plans

Transformez une conception approuvée en tâches vérifiables, avec interfaces et contrôles.

Communauté · Jesse Vincent / Prime Radiant
AuteurJesse Vincent / Prime Radiant
LicenceMIT
Sourceobra/superpowers · SKILL.md sur GitHub
Site du projetprimeradiant.com/superpowers
Fonctionne dansClaude Code · Codex, Gemini CLI, Cursor, Copilot
Lu à la source le

writing-plans transforme une spécification approuvée en plan pour un ingénieur sans contexte préalable : chemins exacts, interfaces, contraintes et commandes de vérification.

Le plan est un document de transmission, pas une réalisation achevée. Les tâches regroupent des changements cohérents avec entrées et sorties explicites.

Extrait du SKILL.md du skill : writing-plans

Ceci est un skill de la communauté créé par Jesse Vincent / Prime Radiant, vérifié ni par nous ni par Anthropic. Un skill peut demander à l’agent d’exécuter du code, de lire des fichiers ou d’accéder au réseau. Avant de l’installer, lisez son SKILL.md et chaque script du dossier, et cherchez tout ce qui ne correspond pas à ce qu’il prétend faire.

Ce qu’il fait

  1. Lisez la spécification approuvée et examinez le code concerné.
  2. Définissez contraintes globales, interfaces et tâches révisables.
  3. Relisez le plan et convenez du mode d’exécution.

Ce que vous obtenez

  • Plan dans docs/superpowers/plans/YYYY-MM-DD-<feature>.md, avec étapes et vérifications.

Quand l’utiliser

  • Transmettre un changement à plusieurs étapes à un ingénieur absent de cette conversation.

Quand ne pas l’utiliser

  • Exigences encore ouvertes : commencez par brainstorming.

Ce qu’il faut

  • Spécification approuvée, agent avec fichiers et accès au projet.
  • Exécution, tests et commits exigent outils et autorisations du projet.

Fichiers du skill

Fichier ou dossierÀ quoi il sert
SKILL.mdStructure du plan, granularité et transmission.

Licence trouvée dans le dépôt le 2026-11-19 : MIT.

Exemples de prompts

Tapez l’un de ces prompts après l’installation ; nommer le skill garantit qu’il sera utilisé.

  • Transformez cette conception approuvée en plan avec interfaces et commandes de vérification.
  • Vérifiez que les tâches sont cohérentes plutôt qu’une par fichier.
  • Planifiez cette migration pour un nouvel ingénieur avec contraintes globales.

Comment installer writing-plans

Installation et autorisations

Le plugin complet conserve les liens vers brainstorming et l’exécution. Le dossier de planification contient seulement SKILL.md.

La source inclut tests préalables et commits. Adaptez-les aux règles du dépôt ; écrire le plan n’exécute pas ces étapes.

Un skill est un dossier contenant un fichier SKILL.md. Vous l’installez une fois ; l’agent lit sa courte description au début de chaque session et ne charge les instructions complètes que si une demande correspond. Choisissez l’environnement que vous utilisez :

Claude Code : depuis la marketplace de plugins

  1. Lancez Claude Code dans un terminal avec claude.
  2. Ce plugin se trouve dans la marketplace officielle d’Anthropic, que Claude Code ajoute pour vous au premier lancement.
  3. Installez le plugin. Claude Code affiche d’abord ses détails : vérifiez ce qu’il va ajouter (skills, hooks, serveurs MCP), puis choisissez s’il est pour vous, pour toutes les personnes de ce dépôt, ou pour vous seul dans ce dépôt.
    /plugin install superpowers@claude-plugins-official
  4. Tapez / et cherchez /superpowers:writing-plans, ou demandez simplement la tâche.

Depuis votre shell plutôt que dans une session :

claude plugin install superpowers@claude-plugins-official

Claude Code : copier le dossier dans votre dossier de skills

Placez le dossier du skill dans ~/.claude/skills/ pour l’utiliser dans tous les projets de cet ordinateur, ou dans .claude/skills/ à l’intérieur d’un dépôt pour le partager avec toutes les personnes qui y travaillent (committez-le).

git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p ~/.claude/skills
cp -R superpowers/skills/writing-plans ~/.claude/skills/

Claude Code détecte pendant la session les skills nouveaux ou modifiés dans ces dossiers. Si le dossier de skills n’existait pas au démarrage de la session, lancez /reload-skills une fois. Tapez ensuite /writing-plans ou décrivez simplement la tâche.

Sous Windows, lancez les commandes dans Git Bash ou WSL, ou copiez le dossier au même endroit avec l’Explorateur de fichiers.

Codex, Gemini CLI, Cursor et GitHub Copilot

Ces agents lisent les mêmes dossiers SKILL.md. Le seul dossier que les quatre acceptent dans un projet est .agents/skills/ ; cette commande y copie donc le skill :

git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p .agents/skills
cp -R superpowers/skills/writing-plans .agents/skills/
AgentDossier du projetVotre dossier utilisateurRemarques
OpenAI Codex
.agents/skills/
~/.agents/skills/
Tapez $ ou lancez /skills pour choisir un skill ; Codex en choisit aussi un quand votre tâche correspond.
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
Ou installez-le depuis Git avec gemini skills install <git URL> --path <folder> --consent. Le 18 juin 2026, Google a remplacé Gemini CLI par Antigravity CLI pour les utilisateurs de l’offre gratuite et de Google One ; Antigravity utilise .agents/skills/ dans un projet et ~/.gemini/config/skills/ pour vous.
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
Tapez / dans le chat Agent pour choisir un skill. Cursor lit aussi les dossiers .claude/skills/ de Claude Code.
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
Fonctionne dans Copilot CLI, l’agent cloud et le mode agent de VS Code, Visual Studio et JetBrains (la prise en charge dans l’IDE dépend de la version). Ou lancez gh skill install OWNER/REPOSITORY SKILL (préversion publique, GitHub CLI 2.90.0 ou ultérieure).
N’installez que des skills de confiance. Anthropic conseille de n’utiliser que des skills provenant de sources de confiance, et de lire chaque fichier de tout autre skill avant de l’utiliser : un skill peut amener l’agent à exécuter des commandes, lire des fichiers ou envoyer des données d’une manière que sa description ne mentionne pas.

Sources de ces étapes

Vérifiées dans la documentation de chaque éditeur le 2026-11-14 :

Un plan qui survit aux changements de contexte

Les contraintes globales traversent les tâches. Les interfaces précisent entrées et sorties et limitent les hypothèses cachées lors de la transmission.

Relisez avant d’exécuter. Même détaillée, une commande reste une proposition tant que son résultat n’est pas vérifié.

Questions sur writing-plans

Exécute-t-il le plan ?

Non. Il l’écrit, le révise puis transmet au mode d’exécution convenu.

Quel contexte inclure dans une tâche ?

Chemins exacts, interfaces, contraintes, étapes et commandes concrètes de vérification.

Un fichier correspond-il à une tâche ?

Non. Une tâche doit être un changement cohérent et révisable ; les fichiers ne suffisent pas.

Faut-il un service payant ?

Aucun service supplémentaire n’est spécifié, mais l’agent ou l’API peut être facturé.

Plus de skills IA

Skills similaires

Catégories de skills