From e24f65cf019b932e2cc24320cd984b36a8f9e282 Mon Sep 17 00:00:00 2001 From: Jesse Vincent Date: Wed, 24 Jun 2026 11:15:14 -0700 Subject: [PATCH] Continued pruning of tokens we shouldn't need for modern agents --- skills/using-superpowers/SKILL.md | 5 +---- .../references/antigravity-tools.md | 11 ---------- .../references/claude-code-tools.md | 21 ------------------ .../references/codex-tools.md | 22 +------------------ .../references/copilot-tools.md | 19 ---------------- .../using-superpowers/references/pi-tools.md | 8 ------- 6 files changed, 2 insertions(+), 84 deletions(-) delete mode 100644 skills/using-superpowers/references/claude-code-tools.md delete mode 100644 skills/using-superpowers/references/copilot-tools.md diff --git a/skills/using-superpowers/SKILL.md b/skills/using-superpowers/SKILL.md index 66c1af03..8a08873b 100644 --- a/skills/using-superpowers/SKILL.md +++ b/skills/using-superpowers/SKILL.md @@ -51,12 +51,9 @@ These thoughts mean STOP—you're rationalizing: ## Platform Adaptation -Skills name actions ("dispatch a subagent", "create a todo", "read a file"), not any one runtime's tools. For your harness's tool equivalents and instructions-file conventions, read the matching file: +If your harness appears here, read its reference file for special instructions: -- Claude Code: `references/claude-code-tools.md` - Codex: `references/codex-tools.md` -- Copilot CLI: `references/copilot-tools.md` -- Gemini CLI: `references/gemini-tools.md` (also auto-loaded via GEMINI.md) - Pi: `references/pi-tools.md` - Antigravity: `references/antigravity-tools.md` diff --git a/skills/using-superpowers/references/antigravity-tools.md b/skills/using-superpowers/references/antigravity-tools.md index 0f4c0b94..71155fde 100644 --- a/skills/using-superpowers/references/antigravity-tools.md +++ b/skills/using-superpowers/references/antigravity-tools.md @@ -4,18 +4,7 @@ Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). | Action skills request | Antigravity CLI equivalent | |----------------------|----------------------| -| Read a file | `view_file` | -| Create a new file | `write_to_file` | -| Edit a file | `replace_file_content` | -| Edit a file in several places at once | `multi_replace_file_content` | -| Run a shell command | `run_command` | -| Search file contents | `grep_search` | -| Find files by name / list a directory | `list_dir` (no dedicated glob tool — combine `list_dir` with `grep_search`) | -| Fetch a URL | `read_url_content` | -| Search the web | `search_web` | -| Pose a structured question to your human partner | `ask_question` | | Dispatch a subagent (`Subagent (general-purpose):` template) | `invoke_subagent` with a built-in `TypeName` — `self` for full-capability work, `research` for read-only (see [Subagent support](#subagent-support)) | -| Multiple parallel dispatches | Multiple entries in one `invoke_subagent` call's `Subagents` array | | Task tracking ("create a todo", "mark complete") | a **task artifact** — `write_to_file` with `IsArtifact: true` and `ArtifactType: "task"` (see [Task tracking](#task-tracking)). **Not** `manage_task`, which manages background processes. | ## Task tracking diff --git a/skills/using-superpowers/references/claude-code-tools.md b/skills/using-superpowers/references/claude-code-tools.md deleted file mode 100644 index 3070da67..00000000 --- a/skills/using-superpowers/references/claude-code-tools.md +++ /dev/null @@ -1,21 +0,0 @@ -# Claude Code Tool Mapping - -Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). On Claude Code these resolve to the tools below. - -## Tools - -| Action skills request | Claude Code tool | -|----------------------|------------------| -| Read a file | `Read` | -| Create a new file | `Write` | -| Edit a file | `Edit` | -| Run a shell command | `Bash` | -| Search file contents | `Grep` | -| Find files by name | `Glob` | -| Fetch a URL | `WebFetch` | -| Search the web | `WebSearch` | -| Invoke a skill | `Skill` | -| Dispatch a subagent (`Subagent (general-purpose):` template) | `Agent` (older releases named this `Task`) | -| Multiple parallel dispatches | Multiple `Agent` calls in one response | -| Task tracking ("create a todo", "mark complete") | `TaskCreate`, `TaskUpdate`, `TaskList`, `TaskGet`; `TodoWrite` in `claude -p` / Agent SDK unless `CLAUDE_CODE_ENABLE_TASKS=1` is set | -| Background-process / subagent lifecycle (read output, cancel) | `TaskOutput`, `TaskStop` — these are distinct from the todo tools above and apply to running shells, agents, and remote sessions | diff --git a/skills/using-superpowers/references/codex-tools.md b/skills/using-superpowers/references/codex-tools.md index 8fa15efc..1897cc3b 100644 --- a/skills/using-superpowers/references/codex-tools.md +++ b/skills/using-superpowers/references/codex-tools.md @@ -1,23 +1,3 @@ -# Codex Tool Mapping - -Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). On Codex these resolve to the tools below. - -| Action skills request | Codex equivalent | -|----------------------|------------------| -| Read a file | `shell` (e.g., `cat`, `head`, `tail`) — Codex reads files via shell | -| Create / edit / delete a file | `apply_patch` (structured diff for create, update, delete) | -| Run a shell command | `shell` | -| Search file contents | `shell` (e.g., `grep`, `rg`) | -| Find files by name | `shell` (e.g., `find`, `ls`) | -| Fetch a URL | `shell` with `curl` / `wget` — Codex has no native fetch tool | -| Search the web | `web_search` (enabled by default; configurable in `config.toml` via the top-level `web_search` setting — `live`, `cached`, or `disabled`) | -| Invoke a skill | Skills load natively — just follow the instructions | -| Dispatch a subagent (`Subagent (general-purpose):` template) | `spawn_agent` (see [Subagent dispatch requires multi-agent support](#subagent-dispatch-requires-multi-agent-support)) | -| Multiple parallel dispatches | Multiple `spawn_agent` calls in one response | -| Wait for subagent result | `wait_agent` | -| Free up subagent slot when done | `close_agent` | -| Task tracking ("create a todo", "mark complete") | `update_plan` | - ## Subagent dispatch requires multi-agent support Add to your Codex config (`~/.codex/config.toml`): @@ -27,7 +7,7 @@ Add to your Codex config (`~/.codex/config.toml`): multi_agent = true ``` -This enables `spawn_agent`, `wait_agent`, and `close_agent` for skills like `dispatching-parallel-agents` and `subagent-driven-development`. +This enables `spawn_agent`, `wait_agent`, and `close_agent` for skills like `dispatching-parallel-agents` and `subagent-driven-development`. When using subagent-driven-development, you should always close implementer and reviewer subagents when they have finished all their work. ## Environment Detection diff --git a/skills/using-superpowers/references/copilot-tools.md b/skills/using-superpowers/references/copilot-tools.md deleted file mode 100644 index 798703de..00000000 --- a/skills/using-superpowers/references/copilot-tools.md +++ /dev/null @@ -1,19 +0,0 @@ -# Copilot CLI Tool Mapping - -Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). On Copilot CLI these resolve to the tools below. - -| Action skills request | Copilot CLI equivalent | -|----------------------|----------------------| -| Read a file | `view` | -| Create / edit / delete a file | `apply_patch` (Copilot CLI has no separate create/edit/write tools) | -| Run a shell command | `bash` | -| Search file contents | `rg` (ripgrep; Copilot CLI does not expose a `grep` tool) | -| Find files by name | `glob` | -| Fetch a URL | `web_fetch` | -| Search the web | `web_search` | -| Invoke a skill | `skill` | -| Dispatch a subagent (`Subagent (general-purpose):` template) | `task` with `agent_type: "general-purpose"` (other accepted types: `explore`, `task`, `code-review`, `research`, `configure-copilot`) | -| Multiple parallel dispatches | Multiple `task` calls in one response | -| Subagent status/output/control | `read_agent`, `list_agents`, `write_agent` | -| Task tracking ("create a todo", "mark complete") | `update_todo` | -| Enter / exit plan mode | No equivalent — stay in the main session | diff --git a/skills/using-superpowers/references/pi-tools.md b/skills/using-superpowers/references/pi-tools.md index 4dbd651f..0c1f2171 100644 --- a/skills/using-superpowers/references/pi-tools.md +++ b/skills/using-superpowers/references/pi-tools.md @@ -4,14 +4,6 @@ Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). | Action skills request | Pi equivalent | | --- | --- | -| Invoke a skill | Pi native skills: load the relevant `SKILL.md` with `read`, or let the human use `/skill:name` | -| Read a file | `read` | -| Create a file | `write` | -| Edit a file | `edit` | -| Run a shell command | `bash` | -| Search file contents | `grep` when active; otherwise `bash` with `rg`/`grep` | -| Find files by name | `find` or `bash` with shell globs | -| List files and subdirectories | `ls` when active; otherwise `bash` with `ls` | | Dispatch a subagent (`Subagent (general-purpose):` template) | Use an installed subagent tool such as `subagent` from `pi-subagents` if available | | Task tracking ("create a todo", "mark complete") | Use an installed todo/task tool if available, otherwise track tasks in the plan or `TODO.md` |