using-superpowers

using-superpowers - Superpowers Skill System Usage Guide

Skill Overview

using-superpowers is the core introductory skill of the Superpowers skill system. It is used to establish the correct method for finding and using skills at the start of any conversation, ensuring that the Skill tool is called before any response (including clarification questions).

Applicable Scenarios

Starting a new conversation - Before beginning any task, use this skill to learn how to find and call applicable skills

Searching for applicable skills - When you are unsure which skills are needed for the current task, use this skill’s framework to make a determination

Understanding skill priorities - When conflicts arise between user instructions, skill content, and default system behavior, refer to the priority rules

Core Functions

Skill discovery and invocation standards - Provides a systematic method for identifying when skills need to be used and how to correctly call the Skill tool, ensuring that no potentially applicable skill is overlooked

Skill priority assessment framework - Establishes a clear three-level priority system: user instructions take highest priority, Superpowers skills come next, and default system behavior has the lowest priority, resolving instruction conflicts

Skill usage process guidance - Uses flowcharts and red-flag checklists to help developers and users avoid common erroneous thought patterns, such as “This is just a simple question” and “I need to gather information first”

Frequently Asked Questions

What is the using-superpowers skill?

using-superpowers is the core entry skill of the Superpowers skill system. Its purpose is to establish the correct method for using skills at the beginning of any conversation. When starting a new conversation or handling a new task, you should first refer to this skill to learn how to find and call relevant skills. This skill emphasizes an important principle: even if there is only a 1% chance that a skill applies to the current task, you must call that skill first to check.

How do I know which skill the current task requires?

According to the using-superpowers process, after receiving a user message, first ask yourself, “Could any skill possibly apply?” If the answer is yes—even if there is only a 1% chance—you must call the Skill tool to load the skill. Once loaded, the skill will clearly tell you whether it applies to the current task. When making this determination, be careful to avoid red-flag thinking such as “This is just a simple question” or “I can gather information first.” These ideas are usually incorrect; skill checking should take place before any exploration or action.

What should I do when user instructions conflict with skill content?

According to the priority rules of using-superpowers, user instructions always have the highest priority. If the user’s CLAUDE.md, GEMINI.md, or AGENTS.md file says “Do not use TDD,” while a skill says “Always use TDD,” you should follow the user’s instruction. This principle ensures that users always retain ultimate control over their own working environment. Superpowers skills only override default system behavior; they do not override the user’s explicit instructions.