Skip to main content
Superpowers integrates with Gemini CLI as a native extension. Skill metadata loads at session start; full skill content activates on demand via the activate_skill tool.

Installation

gemini extensions install https://github.com/obra/superpowers

Verify installation

Start a new Gemini CLI session and ask:
Tell me about your superpowers
Or trigger a skill naturally:
Help me plan this feature
The agent should invoke the brainstorming skill automatically.

How it works

Gemini CLI loads gemini-extension.json to register the extension, which points to GEMINI.md as the context file:
gemini-extension.json
{
  "name": "superpowers",
  "description": "Core skills library: TDD, debugging, collaboration patterns, and proven techniques",
  "version": "5.0.6",
  "contextFileName": "GEMINI.md"
}
GEMINI.md provides Gemini with the bootstrap context and tool mapping so skills written for Claude Code work correctly in Gemini CLI.

Skills in Gemini CLI

Skills activate via the activate_skill tool. Gemini loads skill metadata (name and description) at session start and activates full skill content on demand. Tool names map automatically via GEMINI.md:
Claude Code toolGemini CLI equivalent
Skillactivate_skill
TodoWriteGemini’s task tracking
Task (subagents)Gemini’s agent dispatch

Updating

gemini extensions update superpowers
Run the update command to pull the latest skills. Gemini CLI does not auto-update extensions on launch.

Build docs developers (and LLMs) love