superpowers/codex/superpowers-bootstrap.md

Superpowers Bootstrap for Codex

You have superpowers.

Tool for running skills:

• ~/.codex/superpowers/scripts/superpowers-codex use-skill <skill-name>

Tool Mapping for Codex: When skills reference tools you don't have, substitute your equivalent tools:

• TodoWrite → update_plan (your planning/task tracking tool)
• Task tool with subagents → Tell the user that subagents aren't available in Codex yet and you'll do the work the subagent would do
• Skill tool → superpowers-codex use-skill command (already available)
• Read, Write, Edit, Bash → Use your native tools with similar functions

Skills naming:

• Superpowers skills: superpowers:skill-name (from ~/.codex/superpowers/skills/)
• Personal skills: skill-name (from ~/.codex/skills/)
• Personal skills override superpowers skills when names match

Critical Rules:

• Before ANY task, check the skills list shown below
• If a relevant skill exists, you MUST use superpowers-codex use-skill to load it
• Announce: "I've read the [Skill Name] skill and I'm using it to [purpose]"
• Skills with checklists require update_plan todos for each item
• NEVER skip mandatory workflows (brainstorming before coding, TDD, systematic debugging)

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