Superpowers pour Claude Code : installation, skills et workflow
Ce que le plugin Superpowers ajoute à Claude Code, les commandes d'installation exactes du dépôt, les 15 skills livrés en v7.0.2 et ce qui change par rapport à Claude Code seul.
L'essentiel
- Superpowers est un plugin open source de 15 skills composables — brainstorming, plans, TDD, débogage, worktrees, revue de code — que Claude Code charge automatiquement une fois installé.
- Depuis le marketplace officiel : /plugin install superpowers@claude-plugins-official. Ou ajouter obra/superpowers-marketplace puis installer superpowers@superpowers-marketplace.
- Le billet de l'auteur cite Claude Code 2.0.13 environ comme minimum ; le manifeste du plugin dans le dépôt est en v7.0.2, publié le 2026-11-03.
- Le déroulé : brainstorming → worktree → plan écrit → exécution par subagents ou en ligne avec TDD → revue → fin de branche. L'agent cherche un skill pertinent avant chaque tâche.
État du dépôt vérifié le 2026-11-11 : 315,938 étoiles sur GitHub, dernière version v7.0.2 publiée le 2026-11-03, dernier commit 22f0b463. Le nombre d'étoiles bouge chaque jour — à lire comme un instantané. Les commandes, noms de skills et numéros de version de cette page sont recopiés de ces sources, pas reformulés.
Ce qu'est vraiment Superpowers
Superpowers est un plugin open source sous licence MIT — v7.0.2 au moment de la rédaction — qui donne à Claude Code une méthodologie de développement plutôt qu'une boîte à outils de plus. Ce n'est ni un modèle, ni un proxy d'API, ni un fork : c'est une bibliothèque de 15 skills plus un bootstrap qui ordonne à l'agent de les chercher et de les suivre.
Un skill est un dossier contenant un fichier SKILL.md : un frontmatter YAML avec un name et une description, puis des instructions markdown. La description est le déclencheur — Claude Code la lit et décide si le skill s'applique. Superpowers ajoute un hook de démarrage de session qui injecte le bootstrap using-superpowers : l'agent cherche un skill avant de répondre, pas après avoir écrit du code.
Il est écrit par Jesse Vincent (obra) chez Prime Radiant et publié le 2025-10-09, le jour même où Anthropic a livré le système de plugins de Claude Code. Le même dépôt s'installe aussi dans Codex, Cursor, Gemini CLI, Copilot CLI, OpenCode et d'autres : une bibliothèque de skills, plusieurs harnais.
- Version
- v7.0.2 · 2026-11-03
- Dernier commit
- 22f0b463
- Licence
- MIT
Installer Superpowers dans Claude Code
Deux voies prises en charge, toutes deux recopiées du README du dépôt. Exécutez-les dans une session Claude Code : ce sont des commandes slash, pas des commandes shell.
Voie 1 — le marketplace officiel (une ligne)
Le marketplace claude-plugins-official d'Anthropic est ajouté automatiquement au premier lancement d'une session interactive, il ne reste donc que la ligne d'installation. Le README renvoie aussi à une page de présentation, claude.com/plugins/superpowers.
/plugin install superpowers@claude-plugins-officialVoie 2 — le marketplace Superpowers
Utile si vous voulez le marketplace de l'auteur, qui porte aussi des plugins liés comme superpowers-chrome et elements-of-style. La première ligne enregistre le marketplace, la seconde installe le plugin par son nom.
/plugin marketplace add obra/superpowers-marketplace/plugin install superpowers@superpowers-marketplaceCe qu'il faut avant que ça marche
- 1Claude Code 2.0.13 ou plus récent — le minimum cité par le billet de l'auteur pour le parcours plugin.
- 2Un redémarrage après l'installation : quittez puis relancez claude pour que le hook de démarrage injecte le bootstrap.
- 3Un dépôt git pour le workflow complet : l'étape worktree crée une branche isolée, et la fin propose merge, pull request ou abandon.
Les autres harnais, même dépôt
Le README donne une ligne d'installation par agent de code. Elles sont recopiées telles quelles — relisez le README avant de les lancer, les commandes changent d'une version à l'autre.
| Harnais | Commande d'installation |
|---|---|
| Codex CLI | /plugins |
| Cursor | /add-plugin superpowers |
| Gemini CLI | gemini extensions install https://github.com/obra/superpowers |
| Copilot CLI | copilot plugin marketplace add obra/superpowers-marketplace |
| Antigravity | agy plugin install https://github.com/obra/superpowers |
| Qwen Code | qwen extensions install obra/superpowers |
| Kimi Code | /plugins install https://github.com/obra/superpowers |
| Factory Droid | droid plugin marketplace add https://github.com/obra/superpowers |
| Grok Build | grok plugin install superpowers@xai-official --trust |
| Pi | pi install git:github.com/obra/superpowers |
| Hermes | hermes plugins install obra/superpowers --enable |
Le workflow qu'il impose
C'est la partie qui change réellement le comportement de Claude Code. Sept étapes tirées de la section Basic Workflow du README, plus une règle : l'agent vérifie s'il existe un skill pertinent avant toute tâche.
- 1
brainstorming
Avant de construire quoi que ce soit, l'agent demande ce que vous voulez vraiment et pourquoi, reformule sa compréhension pour correction, et rédige un document de conception au-delà d'une petite modification.
- 2
using-git-worktrees
Après validation du design, il crée un espace isolé sur une nouvelle branche, lance l'installation du projet et vérifie une base de tests propre avant de toucher au code.
- 3
writing-plans
Le design validé devient des tâches de 2 à 5 minutes, chacune avec chemins de fichiers exacts, code complet et étapes de vérification.
- 4
subagent-driven-development ou executing-plans
Deux modes : un subagent neuf par tâche avec une revue après chacune (le plus minutieux), ou une exécution en ligne dans la session courante avec une seule revue de toute la branche à la fin (le moins cher).
- 5
test-driven-development
Pendant l'implémentation, RED-GREEN-REFACTOR : écrire le test qui échoue, le voir échouer, écrire le minimum de code, le voir passer, committer. Le code écrit avant son test est supprimé.
- 6
requesting-code-review
Entre les tâches, le travail est relu par rapport au plan et les problèmes signalés par gravité — un problème critique bloque la suite.
- 7
finishing-a-development-branch
À la fin, il vérifie les tests, propose merge, pull request, conservation ou abandon, exécute votre choix et nettoie le worktree.
Les 15 skills de la v7.0.2
Les noms de dossiers sont les identifiants que l'agent compare, ils ne sont donc pas traduits. Chaque description reformule le frontmatter de ce skill au commit 22f0b463.
Tests
test-driven-development
Écrire le test d'abord, le voir échouer, puis n'écrire que le code nécessaire pour passer — avec une référence des anti-patterns de test.
Débogage
systematic-debugging
Un processus de cause racine en quatre phases pour tout bug, test en échec ou comportement inattendu, avant de proposer un correctif. Corriger le symptôme compte comme un échec.
verification-before-completion
Lancer la commande de vérification et lire sa sortie avant d'annoncer qu'un travail est terminé, corrigé ou au vert.
diagnosing-superpowers
Quand une session s'est mal passée, lire sa transcription et rapporter ce qui s'est produit avec des preuves ligne par ligne, en pouvant empaqueter un bundle nettoyé pour un rapport de bug.
Collaboration
brainstorming
Obligatoire avant tout travail créatif : fait émerger l'intention par des questions et reformule la compréhension avant de construire.
writing-plans
Transforme une spec en plan exécutable par un ingénieur qui n'a jamais vu le code : fichiers, noms, signatures et tests exacts pour chaque tâche.
executing-plans
Exécution en ligne du plan : vous implémentez tâche par tâche dans la session courante, avec une seule revue de toute la branche à la fin.
subagent-driven-development
Un subagent implémenteur neuf par tâche, une revue spec plus qualité après chacune, et une revue large de toute la branche à la fin.
dispatching-parallel-agents
Pour deux tâches indépendantes ou plus sans état partagé, déléguer chacune à un agent avec son propre contexte plutôt que d'enchaîner.
requesting-code-review
Envoie un subagent relecteur avec un contexte précisément construit pour que les problèmes apparaissent entre les tâches, pas à la fin.
receiving-code-review
Comment traiter les retours de revue : vérifier avant d'implémenter, demander plutôt que supposer, éviter l'accord de façade.
using-git-worktrees
Garantir un espace isolé, en préférant les outils worktree natifs de la plateforme et en retombant sur git worktree en dernier recours.
finishing-a-development-branch
Vérifier les tests, détecter l'environnement, proposer merge, PR, conservation ou abandon, exécuter le choix et nettoyer.
Méta
writing-skills
Créer et modifier des skills en appliquant le TDD à la documentation de process, y compris comment tester qu'un skill se déclenche vraiment.
using-superpowers
Le skill d'amorçage : comment trouver les skills, comment les charger et pourquoi il faut les invoquer avant toute réponse.
Superpowers face à Claude Code seul
Claude Code seul a déjà le plan mode, des skills natifs, des subagents, les worktrees et les plugins. Superpowers n'ajoute pas de primitives : il ajoute des opinions sur le moment de les utiliser, et un hook qui rend ces opinions difficiles à contourner.
| Sujet | Claude Code seul | Avec Superpowers |
|---|---|---|
| D'où vient le workflow | Vous choisissez à chaque session : plan mode, convention dans CLAUDE.md, ou prompt collé à la main. | Un hook de démarrage injecte un bootstrap de skills obligatoire : la séquence devient le comportement par défaut. |
| Planification | Le plan mode produit un plan que vous validez, puis l'implémentation démarre dans le même contexte. | brainstorming → document de conception → writing-plans transforme le plan en tâches de 2 à 5 minutes avec chemins et tests. |
| Isolation et exécution | Worktrees et subagents existent, mais c'est vous qui décidez quand y recourir. | using-git-worktrees se déclenche après le design ; subagent-driven-development ou executing-plans vous est proposé. |
| Gardes-fous qualité | Vous demandez les tests et la revue, ou vous câblez hooks et CI vous-même. | TDD, verification-before-completion et requesting-code-review se déclenchent entre les tâches ; un problème critique bloque la suite. |
Ce que ça apporte
- Le défaut passe de « coder tout de suite » à « demander d'abord » — la différence pratique majeure, et le fil rouge du billet de l'auteur.
- Des skills petits et lisibles : chaque comportement est un fichier markdown qu'on ouvre, qu'on diffe et qu'on modifie.
- Une bibliothèque de skills pour plusieurs harnais : le même dépôt s'installe dans Claude Code, Codex, Cursor, Gemini CLI et d'autres.
Ce que ça coûte
- Plus de tokens et de tours : questions, document de conception, plan et revues par tâche arrivent avant la première ligne de code de production.
- Volontairement opinionné : YAGNI, TDD strict et invocation obligatoire conviennent à un projet neuf, moins à un correctif urgent en legacy.
- Un objet de plus à maintenir à jour, et le bénéfice complet suppose un dépôt git et un harnais doté de subagents.
Quand une session dérape
Si un skill se déclenche à tort, reste muet quand il devrait parler, ou si l'agent ignore son plan, le dépôt fournit justement un skill diagnosing-superpowers. Demandez-le dans la session — ajoutez « in session <id> » pour une session passée — et il lit la transcription, rapporte ce qui s'est passé avec des preuves et peut empaqueter un bundle nettoyé pour un rapport de bug.
figure out what went wrong with superpowers in session <id>Télémétrie, et comment la couper
Le README est explicite : le compagnon visuel optionnel du skill brainstorming charge un logo depuis le site de Prime Radiant, qui transporte la version de Superpowers mais aucune donnée de projet, de prompt ou d'agent. Mettez SUPERPOWERS_DISABLE_TELEMETRY à n'importe quelle valeur vraie pour la désactiver ; DISABLE_TELEMETRY et CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC de Claude Code sont aussi respectés.