using-superpowers

Enforces skill discovery and invocation before any agent response or action.

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/johsquaree/claude-basic-docs --skill using-superpowers-johsquaree
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-superpowers
Source: https://github.com/johsquaree/claude-basic-docs/tree/main/.claude/skills/using-superpowers
Command: npx skills add https://github.com/johsquaree/claude-basic-docs --skill using-superpowers-johsquaree

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? AI agents often skip available skills and improvise answers, leading to inconsistent workflows and missed process steps. This Skill establishes a mandatory rule that relevant skills must be invoked before any response, including clarifying questions or codebase exploration. ## Core Features & Use Cases - Mandatory Skill Invocation: Requires checking for and invoking applicable skills before any response or action, with a red-flags table that counters common rationalizations for skipping. - Skill Priority Ordering: Defines that process skills (like brainstorming or systematic-debugging) run before implementation skills when multiple skills apply. - Cross-Platform Tool Mapping: Ships reference files mapping skill actions (subagent dispatch, todo tracking, file operations) to concrete tools on Codex, Gemini CLI, Pi, and Antigravity harnesses. - Use Case: When a user says "fix this bug", the agent invokes the systematic-debugging skill first rather than jumping straight into editing code. ## Quick Start Start a new conversation and ask the agent to build or fix something, and it will invoke the relevant skill before responding.

Frequently Asked Questions about using-superpowers

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I make an AI agent always use skills before responding?

Install this skill so it loads at conversation start. It instructs the agent to invoke any relevant skill before responding, asking clarifying questions, or exploring files, and to announce which skill it is using.

What is skill priority ordering in agent workflows?

Process skills like brainstorming and systematic-debugging run first to set the approach, then implementation skills carry out the work. For example, "fix this bug" triggers systematic-debugging before any domain-specific skills.

Does this skill work with Gemini CLI and Codex?

Yes, it includes reference files mapping skill actions to platform tools. Gemini CLI uses invoke_agent and write_todos, while Codex requires enabling multi_agent in config.toml for subagent dispatch.

When should a skill be skipped during a task?

Skills are skipped only when dispatched as a subagent executing a specific task, or when explicit user instructions in files like CLAUDE.md or AGENTS.md override the skill workflow.

Why does the agent keep asking to invoke a skill for simple questions?

The skill treats every question as a task requiring a skill check, since simple requests often become complex. This prevents undisciplined action that wastes time on the wrong approach.