An agentic skills framework & software development methodology that works.
Add Gemini CLI tool mapping and update using-superpowers references
Jesse Vincent21a774e95c06
diff --git a/skills/using-superpowers/SKILL.md b/skills/using-superpowers/SKILL.mdindex 1a7d7b211..41bd25af5 100644--- a/skills/using-superpowers/SKILL.md+++ b/skills/using-superpowers/SKILL.md@@ -19,21 +19,23 @@ This is not negotiable. This is not optional. You cannot rationalize your way ouSuperpowers skills override default system prompt behavior, but **user instructions always take precedence**:-1. **User's explicit instructions** (CLAUDE.md, AGENTS.md, direct requests) — highest priority+1. **User's explicit instructions** (CLAUDE.md, GEMINI.md, AGENTS.md, direct requests) — highest priority2. **Superpowers skills** — override default system behavior where they conflict3. **Default system prompt** — lowest priority-If CLAUDE.md or AGENTS.md says "don't use TDD" and a skill says "always use TDD," follow the user's instructions. The user is in control.+If CLAUDE.md, GEMINI.md, or AGENTS.md says "don't use TDD" and a skill says "always use TDD," follow the user's instructions. The user is in control.## How to Access Skills**In Claude Code:** Use the `Skill` tool. When you invoke a skill, its content is loaded and presented to you—follow it directly. Never use the Read tool on skill files.+**In Gemini CLI:** Skills activate via the `activate_skill` tool. Gemini loads skill metadata at session start and activates the full content on demand.+**In other environments:** Check your platform's documentation for how skills are loaded.## Platform Adaptation-Skills use Claude Code tool names. Non-CC platforms: see `references/codex-tools.md` for tool equivalents.+Skills use Claude Code tool names. Non-CC platforms: see `references/codex-tools.md` (Codex) or `references/gemini-tools.md` (Gemini CLI) for tool equivalents.# Using Skillsdiff --git a/skills/using-superpowers/references/gemini-tools.md b/skills/using-superpowers/references/gemini-tools.mdnew file mode 100644index 000000000..f8698033b--- /dev/null+++ b/skills/using-superpowers/references/gemini-tools.md@@ -0,0 +1,33 @@+# Gemini CLI Tool Mapping++Skills use Claude Code tool names. When you encounter these in a skill, use your platform equivalent:++| Skill references | Gemini CLI equivalent |+|-----------------|----------------------|+| `Read` (file reading) | `read_file` |+| `Write` (file creation) | `write_file` |+| `Edit` (file editing) | `replace` |+| `Bash` (run commands) | `run_shell_command` |+| `Grep` (search file content) | `grep_search` |+| `Glob` (search files by name) | `glob` |+| `TodoWrite` (task tracking) | `write_todos` |+| `Skill` tool (invoke a skill) | `activate_skill` |+| `WebSearch` | `google_web_search` |+| `WebFetch` | `web_fetch` |+| `Task` tool (dispatch subagent) | No equivalent — Gemini CLI does not support subagents |++## No subagent support++Gemini CLI has no equivalent to Claude Code's `Task` tool. Skills that rely on subagent dispatch (`subagent-driven-development`, `dispatching-parallel-agents`) will fall back to single-session execution via `executing-plans`.++## Additional Gemini CLI tools++These tools are available in Gemini CLI but have no Claude Code equivalent:++| Tool | Purpose |+|------|---------|+| `list_directory` | List files and subdirectories |+| `save_memory` | Persist facts to GEMINI.md across sessions |+| `ask_user` | Request structured input from the user |+| `tracker_create_task` | Rich task management (create, update, list, visualize) |+| `enter_plan_mode` / `exit_plan_mode` | Switch to read-only research mode before making changes |