Skip to content
cccskills
FreePublished on GitHubEnglish overview

using-superpowers

Guide an agent to check and invoke relevant skills before replying or taking action. It sets the order for choosing workflow and implementation skills, with reference guides for adapting the process to different agent environments.

OriginalShow the original description

Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions

AI rating90/ 100See how to install

Good for

  • Checking relevant skills at the start of a conversation
  • Choosing skills before building a feature
  • Choosing skills before investigating a bug
  • Adapting skill use to an agent environment

Overview

What it does

Defines how an agent checks for relevant skills at the start of a conversation and loads them before replying or working. This includes asking clarifying questions and inspecting files. The procedure also requires telling you which skill is being used and why.

When several skills apply, skills that determine the approach come first, followed by skills that carry out implementation. If a skill includes a checklist, each checklist item is treated as a task.

When it helps

Use it when an agent starts working without checking skills you have installed. The examples put superpowers:brainstorming before feature development and superpowers:systematic-debugging before bug fixes. It also connects the process to guidance for the agent environment being used.

Example requests

  • “Check the relevant skills before building this feature.”
  • “Choose the skills for investigating this bug before proceeding.”

Notes

Environment-specific reference files are available for Claude Code, Codex, Pi, Antigravity, Hermes Agent, and Muse. Your direct requests and instruction files take precedence over skills. Subagents assigned a specific task are exempt from this procedure.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Objective evaluation

AI rated this skill on four points using only the contents of its SKILL.md. Stars and popularity are not taken into account.

Clear instructionsIs it clear when to use it and what it does?
AGoodIt specifies use at conversation start and requires invoking relevant skills before questions or file inspection.
Concrete stepsAre steps, inputs, outputs, and examples spelled out?
AGoodIt specifies skill priority, an announcement format, and conversion of checklist items into tasks.
SafetyAre sending data, deleting files, and running commands disclosed?
AGoodIts instructions concern skill references and task organization; no external transmission or deletion operations are specified.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingIt lists references for six environments but does not include setup instructions for skill invocation in the main text.

The total counts each point as A = 25, B = 15, C = 5. Rated by AI (OpenAI Codex) as of Oct 19, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (8)

  • SKILL.md3.1 KB
  • references/antigravity-tools.md1.5 KB
  • references/claude-code-tools.md1.4 KB
  • references/codex-tools.md4.7 KB
  • references/gemini-tools.md4.5 KB
  • references/hermes-tools.md1.9 KB
  • references/muse-tools.md1.9 KB
  • references/pi-tools.md1.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

<SUBAGENT-STOP> If you were dispatched as a subagent to execute a specific task, ignore this skill. </SUBAGENT-STOP> <EXTREMELY-IMPORTANT> If you think there is even a 1% chance a skill might apply to what you are doing, you ABSOLUTELY MUST invoke the skill.

IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.

This is not negotiable. You cannot rationalize your way out of this. </EXTREMELY-IMPORTANT>

The Rule

Invoke relevant or requested skills BEFORE any response or action — including clarifying questions, exploring the codebase, or checking files. If it turns out wrong for the situation, you don't have to use it.

Before entering plan mode: if you haven't already brainstormed, invoke the brainstorming skill first.

Then announce "Using [skill] to [purpose]" and follow the skill exactly. If it has a checklist, create a todo per item.

Skill Priority

When multiple skills apply, process skills come first — they set the approach, then implementation skills (frontend-design, etc.) carry it out. Brainstorming and systematic-debugging are Superpowers' most common process skills, but the rule holds for any of them.

  • "Let's build X" → superpowers:brainstorming first, then implementation skills.
  • "Fix this bug" → superpowers:systematic-debugging first, then domain skills.

Red Flags

These thoughts mean STOP—you're rationalizing:

ThoughtReality
"This is just a simple question"Questions are tasks. Check for skills.
"I need more context first"Skill check comes BEFORE clarifying questions.
"Let me explore the codebase first"Skills tell you HOW to explore. Check first.
"I can check git/files quickly"Files lack conversation context. Check for skills.
"Let me gather information first"Skills tell you HOW to gather information.
"This doesn't need a formal skill"If a skill exists, use it.
"I remember this skill"Skills evolve. Read current version.
"This doesn't count as a task"Action = task. Check for skills.
"The skill is overkill"Simple things become complex. Use it.
"I'll just do this one thing first"Check BEFORE doing anything.
"This feels productive"Undisciplined action wastes time. Skills prevent this.
"I know what that means"Knowing the concept ≠ using the skill. Invoke it.

Platform Adaptation

If your harness appears here, read its reference file for special instructions:

  • 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

User Instructions

User instructions (CLAUDE.md, AGENTS.md, GEMINI.md, etc, direct requests) take precedence over skills, which in turn override default behavior. Only skip skill workflows or instructions when your human partner has explicitly told you to.

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

brainstorming

FreeSummaryAI rating 90

Clarifies the purpose, preferences, and constraints of a new feature or project through conversation. When useful, it offers mockups or temporary prototypes, then captures an agreed description or written design before implementation begins.

  • Clarifying the purpose of a new feature
  • Organizing ideas for a talk or business
  • Comparing screen or room layouts visually
obra/superpowers301.6KUpdated Oct 10, 2026

diagnosing-superpowers

FreeSummaryAI rating 90

Examine superpowers session records to document repeated work, departures from plans, delays, and token usage. Produce an evidence-based report with file and line references, and prepare bug-report material when requested.

  • Investigating repeated work or departures from a plan
  • Checking session duration and token usage
  • Tracing whether a skill was invoked
obra/superpowers301.6KUpdated Oct 10, 2026

dispatching-parallel-agents

FreeSummaryAI rating 90

Assign independent bugs or test failures to separate agents that work at the same time. Define each agent’s scope and expected report, then check for conflicting changes and run the full test suite before integrating fixes.

  • Investigating test failures with unrelated causes
  • Fixing independent problems in separate subsystems
  • Defining focused tasks for multiple agents
obra/superpowers301.6KUpdated Oct 10, 2026

executing-plans

FreeSummaryAI rating 90

Carry out an existing implementation plan in one session, task by task. Verify each step with tests, record progress and decisions in a file, and finish with a review of all changes on the branch.

  • Implementing a prepared development plan
  • Executing tasks without implementer subagents
  • Resuming work from a progress record
obra/superpowers301.6KUpdated Oct 10, 2026

finishing-a-development-branch

FreeSummaryAI rating 90

Finish completed development work by checking the full test suite and presenting integration choices: merge locally, create a Pull Request, or keep the branch. It carries out the selected path and handles workspace cleanup accordingly.

  • Merging a completed feature locally
  • Pushing a branch and creating a Pull Request
  • Keeping completed work for later integration
obra/superpowers301.6KUpdated Oct 10, 2026

receiving-code-review

FreeSummaryAI rating 80

Evaluate code review feedback against the actual code, supported environments, and existing behavior. Clarify uncertain requests, respond with technical evidence, and implement valid changes one at a time with tests for each fix.

  • Clarifying ambiguous code review comments
  • Checking whether suggested changes preserve compatibility
  • Assessing whether a requested feature is actually used
obra/superpowers301.6KUpdated Oct 10, 2026

See all skills by obra

Report a problem with this skill