# GitHub Copilot Tool Mapping

Skills in this repository are written with Claude Code tool names. When using Superpowers in GitHub Copilot, translate tool usage with the mapping below.

| Skill references | GitHub Copilot equivalent |
|-----------------|---------------------------|
| `Read` (file reading) | `read_file` |
| `Write` (file creation) | `create_file` |
| `Edit` (file editing) | `apply_patch` |
| `Bash` (run commands) | `execution_subagent` (preferred) or `run_in_terminal` |
| `Grep` (search file content) | `grep_search` |
| `Glob` (search files by name) | `file_search` |
| `TodoWrite` (task tracking) | `manage_todo_list` when available; otherwise maintain a checklist in chat |
| `Skill` tool (invoke a skill) | No direct equivalent - load the skill file with `read_file` and follow it directly |
| `Task` tool (dispatch subagent) | `runSubagent` when available |
| `WebSearch` / `WebFetch` | `fetch_webpage` |

## Skill Loading in Copilot

GitHub Copilot does not have a dedicated Skill tool. To invoke a skill:

1. Read the skill file directly (for example, `skills/brainstorming/SKILL.md` or `.superpowers/skills/brainstorming/SKILL.md`).
2. Announce which skill you are using and why.
3. Follow the skill instructions exactly.

## Subagent Support

Subagent support varies by Copilot environment:

- VS Code agent mode supports subagent dispatch (`runSubagent`).
- Other Copilot surfaces (JetBrains, Visual Studio, Xcode, Eclipse, and GitHub.com cloud contexts) may have different tool availability.
- If subagent dispatch is unavailable, use `superpowers:executing-plans` and execute tasks in the current session.

## Customization Files Used by Copilot

- `.github/copilot-instructions.md` - repository-wide always-on instructions
- `.github/instructions/*.instructions.md` - path-scoped instructions
- `.github/agents/*.agent.md` - workspace custom agents (VS Code)
- `AGENTS.md`, `CLAUDE.md`, `GEMINI.md` - additional instruction files recognized by Copilot environments