using-superpowers

À utiliser au début de toute conversation — établit comment trouver et utiliser les compétences, exigeant l'invocation d'une compétence avant TOUTE réponse, y compris les questions de clarification.

Qu'est-ce que using-superpowers ?

Cette compétence (skill) est essentielle pour tout agent IA opérant dans un environnement enrichi de compétences, comme Claude Code, Cursor, Codex, etc. Elle établit une règle fondamentale : avant toute réponse ou action — même poser une question de clarification, explorer le code, ou lancer un mode planification — l'agent doit d'abord vérifier si une compétence pertinente existe et l'invoquer. Le document fournit un système de priorité entre compétences process (comme brainstorming, débogage systématique) et compétences d'implémentation, ainsi qu'un tableau de drapeaux rouges pour éviter les rationalisations. Il adapte également son comportement en fonction de la plateforme (Claude Code, Codex, etc.) via des fichiers de référence dédiés. L'objectif est d'augmenter la rigueur et l'efficacité du travail de l'agent, en évitant les actions non structurées ou prématurées.

Compatible avec✓Claude Code✓Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/obra/superpowers/tree/main/skills/using-superpowers

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

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

Documentation

SI UNE COMPÉTENCE S'APPLIQUE À VOTRE TÂCHE, VOUS N'AVEZ PAS LE CHOIX. VOUS DEVEZ L'UTILISER.

Ce n'est pas négociable. Vous ne pouvez pas rationaliser pour vous en sortir.

La Règle

Invoquez les compétences pertinentes ou demandées AVANT toute réponse ou action — y compris les questions de clarification, l'exploration de la base de code ou la vérification de fichiers. Si cela s'avère inapproprié pour la situation, vous n'êtes pas obligé de l'utiliser.

Avant d'entrer en mode planification : si vous n'avez pas déjà fait un remue-méninges, invoquez d'abord la compétence brainstorming.

Annoncez ensuite « Utilisation de [compétence] pour [objectif] » et suivez la compétence exactement. Si elle contient une liste de contrôle, créez une todo pour chaque élément.

Priorité des Compétences

Lorsque plusieurs compétences s'appliquent, les compétences process passent en premier — elles définissent l'approche, puis les compétences d'implémentation (frontend-design, etc.) les exécutent. Le brainstorming et le débogage systématique sont les compétences process les plus courantes des Superpowers, mais la règle s'applique à toutes.

  • « Construisons X » → superpowers:brainstorming d'abord, puis compétences d'implémentation.
  • « Corrige ce bug » → superpowers:systematic-debugging d'abord, puis compétences de domaine.

Drapeaux Rouges

Ces pensées signifient STOP — vous rationalisez :

PenséeRéalité
« Ce n'est qu'une simple question »Les questions sont des tâches. Vérifiez les compétences.
« J'ai besoin de plus de contexte d'abord »La vérification des compétences vient AVANT les questions de clarification.
« Laissez-moi d'abord explorer la base de code »Les compétences vous disent COMMENT explorer. Vérifiez d'abord.
« Je peux vérifier git/les fichiers rapidement »Les fichiers manquent de contexte de conversation. Vérifiez les compétences.
« Laissez-moi d'abord rassembler des informations »Les compétences vous disent COMMENT rassembler des informations.
« Cela n'a pas besoin d'une compétence formelle »Si une compétence existe, utilisez-la.
« Je me souviens de cette compétence »Les compétences évoluent. Lisez la version actuelle.
« Cela ne compte pas comme une tâche »Action = tâche. Vérifiez les compétences.
« La compétence est excessive »Les choses simples deviennent complexes. Utilisez-la.
« Je vais juste faire cette petite chose d'abord »Vérifiez AVANT de faire quoi que ce soit.
« Cela semble productif »Les actions non disciplinées font perdre du temps. Les compétences l'empêchent.
« Je sais ce que cela signifie »Connaître le concept ≠ utiliser la compétence. Invoquez-la.

Adaptation à la Plateforme

Si votre harnais apparaît ici, lisez son fichier de référence pour des instructions spéciales :

  • Claude Code : references/claude-code-tools.md
  • Codex : references/codex-tools.md
  • Pi : references/pi-tools.md
  • Antigravity : references/antigravity-tools.md
  • Hermes Agent : references/hermes-tools.md
  • Muse : references/muse-tools.md

Instructions Utilisateur

Les instructions utilisateur (CLAUDE.md, AGENTS.md, GEMINI.md, etc., demandes directes) prévalent sur les compétences, qui à leur tour remplacent le comportement par défaut. Ne contournez les workflows ou instructions des compétences que lorsque votre partenaire humain vous l'a explicitement demandé.

Individual skills in this repo

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

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).

diagnosing-superpowers

Use when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.

dispatching-parallel-agents

Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies

executing-plans

Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available

finishing-a-development-branch

Use when implementation is complete, all tests pass, and you need to decide how to integrate the work

receiving-code-review

Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation

requesting-code-review

Use when completing tasks, implementing major features, or before merging to verify work meets requirements

subagent-driven-development

Use when executing implementation plans with independent tasks in the current session

systematic-debugging

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

test-driven-development

Use when implementing any feature or bugfix, before writing implementation code

using-git-worktrees

Use when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback

verification-before-completion

Use when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always

writing-plans

Use when you have a spec or requirements for a multi-step task, before touching code

writing-skills

Use when creating new skills, editing existing skills, or verifying skills work before deployment

Skills associés