using-superpowers

Guides discretionary invocation of superpowers skills across AI coding harnesses.

Updated Jan 2, 2025
One-click install
npx skills add https://github.com/mcinnisd/gymbro --skill using-superpowers-mcinnisd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: using-superpowers
Source: https://github.com/mcinnisd/gymbro/tree/main/.agents/skills/using-superpowers
Command: npx skills add https://github.com/mcinnisd/gymbro --skill using-superpowers-mcinnisd

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? AI agents often over-trigger skill workflows for trivial tasks or fail to map skill actions to the correct tools on different harnesses, causing wasted effort and inconsistent behavior. ## Core Features & Use Cases - Discretionary Skill Policy: Establishes that superpowers skills are advisory and optional, prioritizing direct user instructions and repository rules over automatic skill invocation. - Harness Tool Mapping: Provides reference files that translate skill actions (subagent dispatch, task tracking, file operations) into concrete tools for Codex, Gemini CLI, Pi, and Antigravity. - Use Case: An agent running on Gemini CLI receives a request to dispatch a subagent; it reads the gemini-tools reference and correctly uses invoke_agent with the generalist agent instead of fabricating unsupported calls. ## Quick Start Ask the agent to follow the superpowers usage policy and consult the appropriate harness reference before invoking any skill workflow.

Frequently Asked Questions about using-superpowers

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

FAQPage Schema
When should superpowers skills be invoked?

Superpowers skills are advisory and optional, invoked only when they genuinely add value or the user explicitly requests them. Simple tasks like minor bug fixes or direct instructions should be executed directly without triggering skill workflows.

How do I dispatch a subagent on Gemini CLI?

Use the invoke_agent tool with agent_name set to generalist, or type @generalist followed by your prompt in chat. Fill any prompt template placeholders completely before dispatching, and issue multiple invoke_agent calls in one response for parallel work.

Does Codex support subagent dispatch for skills?

Yes, but it requires enabling multi-agent support by adding multi_agent = true under [features] in ~/.codex/config.toml. This enables spawn_agent, wait_agent, and close_agent for skills like subagent-driven-development.

How do I track tasks on Antigravity CLI?

Antigravity has no todo tool, so create a task artifact using write_to_file with IsArtifact true and ArtifactType task. Maintain a markdown checklist and edit it with replace_file_content as steps complete.

What takes priority over skill recommendations?

Direct user instructions and repository rules in files like AGENTS.md, CLAUDE.md, or GEMINI.md take top priority over skill recommendations. Skills in turn override default agent behavior.