
Using Superpowers
FreeEnsure skills are utilized for effective task handling.
Free · Opens the source repo
What Using Superpowers does
The 'Using Superpowers' skill is designed to enforce a disciplined approach to task management when interacting with AI coding agents. It emphasizes the necessity of checking for applicable skills before proceeding with any response, including clarifying questions. By establishing this rule, users are guided to invoke the Skill tool at the outset, ensuring that they leverage the full capabilities of available skills effectively. This skill is particularly useful for developers and designers who often navigate complex tasks that may benefit from specialized skills.
The core principle of this skill is that even a slight possibility—just a 1% chance—that a skill may apply to a task mandates its invocation. This approach minimizes the risk of overlooking valuable resources that could streamline workflows or enhance productivity. The skill provides a structured flow for decision-making, starting from receiving a user message, assessing the relevance of skills, and ultimately guiding the user through the necessary steps to ensure tasks are executed correctly.
This skill is especially beneficial for teams or individuals who frequently engage with AI tools for coding, debugging, or project management. It instills a habit of thoroughness and discipline, which is crucial in environments where precision and efficiency are paramount. By adhering to the guidelines set forth in this skill, users can avoid common pitfalls of rationalization that may lead to inefficient practices.
In summary, 'Using Superpowers' serves as a foundational skill for effective engagement with AI coding agents, ensuring that users are equipped to handle tasks with the appropriate tools and methodologies. It is a must-have for anyone looking to optimize their interaction with AI in a coding context.
When to use it
Use this skill at the beginning of any task or inquiry to confirm if a relevant skill should be invoked.
When not to use it
This skill is not suitable for scenarios where no skills exist or when tasks are purely manual and do not involve AI tools.
What you can build with it
Starting a New Project
When initiating a new project, use this skill to ensure all relevant skills are considered before proceeding.
Debugging Code
Invoke this skill to determine if any debugging skills are applicable to your current issue.
Collaborating with Team Members
Use this skill to guide discussions and ensure that all team members are aware of the skills that can assist in their tasks.
How to install Using Superpowers
View source1. Install with the skills CLI
npx skills add davila7/claude-code-templates/using-superpowers --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by davila7IF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.
This is not negotiable. This is not optional. You cannot rationalize your way out of this. </EXTREMELY-IMPORTANT>
Using Skills
The Rule
Check for skills BEFORE ANY RESPONSE. This includes clarifying questions. Even 1% chance means invoke the Skill tool first.
digraph skill_flow {
"User message received" [shape=doublecircle];
"Might any skill apply?" [shape=diamond];
"Invoke Skill tool" [shape=box];
"Announce: 'Using [skill] to [purpose]'" [shape=box];
"Has checklist?" [shape=diamond];
"Create TodoWrite todo per item" [shape=box];
"Follow skill exactly" [shape=box];
"Respond (including clarifications)" [shape=doublecircle];
"User message received" -> "Might any skill apply?";
"Might any skill apply?" -> "Invoke Skill tool" [label="yes, even 1%"];
"Might any skill apply?" -> "Respond (including clarifications)" [label="definitely not"];
"Invoke Skill tool" -> "Announce: 'Using [skill] to [purpose]'";
"Announce: 'Using [skill] to [purpose]'" -> "Has checklist?";
"Has checklist?" -> "Create TodoWrite todo per item" [label="yes"];
"Has checklist?" -> "Follow skill exactly" [label="no"];
"Create TodoWrite todo per item" -> "Follow skill exactly";
}
Red Flags
These thoughts mean STOP—you're rationalizing:
| Thought | Reality |
|---|---|
| "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. |
Skill Priority
When multiple skills could apply, use this order:
- Process skills first (brainstorming, debugging) - these determine HOW to approach the task
- Implementation skills second (frontend-design, mcp-builder) - these guide execution
"Let's build X" → brainstorming first, then implementation skills. "Fix this bug" → debugging first, then domain-specific skills.
Skill Types
Rigid (TDD, debugging): Follow exactly. Don't adapt away discipline.
Flexible (patterns): Adapt principles to context.
The skill itself tells you which.
User Instructions
Instructions say WHAT, not HOW. "Add X" or "Fix Y" doesn't mean skip workflows.
Frequently asked questions about Using Superpowers
Similar skills
Skill Creator
Efficiently create and manage skills for Gemini CLI.
Agent Development
Create and manage autonomous agents for Claude Code.
Math Olympiad Solver
Solve and verify competition math problems effectively.
Microsoft Skill Creator
Create specialized skills for Microsoft technologies.
Doublecheck
A verification pipeline for AI-generated claims.
Skill Development for Claude Code
Create and enhance skills for Claude Code plugins.
