Skill Claude

Convert to Copilot

convert-to-copilot/

4 views 0 downloads

Port a Claude Code agent, with its command and skills, to one GitHub Copilot agent. Maps tools, models and sub-agent calls, validates the result and ships scripts for both directions.

Convert to Copilot: Brain Lab skill for Claude Code

Port a Claude Code agent, with its command and skills, to one GitHub Copilot agent that works the same way.

Why use it

Your team uses both Claude Code and GitHub Copilot, and every agent has to be written twice.
Copilot has no skills or commands: a straight copy loses the knowledge and the triggers the agent depends on.
Hand-ported agents drift, wrong tool aliases (fetch instead of web), dead file paths, task tracking that fails silently.

What it does

Merges the agent + its launch command into one .github/agents/{name}.agent.md, with the command's trigger phrases in the description.
Splits every skill into .copilot_utils/{name}/context/ (what to use) and trees/ (how to decide), and rewrites each skill reference to a file path.
Maps tools, models and frontmatter: WebFetch → web, TaskCreate → manage_todo_list, opus → Claude Opus 4.5, drops color / memory / isolation / skills / allowed-tools.
Converts sub-agent calls to handoffs (VS Code) or runSubagent() (GitHub Copilot).
Validates the result, every referenced path exists, aliases are correct, body under 30,000 characters, and prints a conversion report.
Ships scaffold scripts for both directions (claude-to-copilot, copilot-to-claude) and a full worked example.

Benefits

Write the agent once. Claude Code stays the source; Copilot gets a faithful port.
No lost knowledge. Skills become referenced context files, not a pasted wall of text.
Correct on the first run. The tool and model tables catch the aliases that break Copilot agents.
Reviewable. Each phase writes its output to .copilot-convert-results/, so you can see every decision.

Install

Download this skill and copy the convert-to-copilot folder to .claude/skills/convert-to-copilot/ in your project, or to ~/.claude/skills/convert-to-copilot/ to use it in every project. Claude Code finds it on its own; you can also call it with /convert-to-copilot.

Part of the Agent Engineering bundle. To get the whole set as a Claude Code plugin: /plugin marketplace add endorphin-ai/hasbrains-agent-kit, then /plugin install agent-engineering@hasbrains-agent-kit.

Source: endorphin-ai/hasbrains-agent-kit. License: MIT.

Files (17)

# Tool & Model Mapping Reference

Source: https://github.com/endorphin-ai/vs-code-copilot-agents/blob/main/COPILOT_AGENTS_GUIDE.md

---

## Claude → Copilot Tool Mapping

### Standard tool aliases

| Claude tool                 | Copilot `tools[]` value | Notes                                         |
| --------------------------- | ----------------------- | --------------------------------------------- |
| `Read`                      | `"read"`                | file reading                                  |
| `Write` / `Edit`            | `"edit"`                | file creation and editing                     |
| `Bash` / `Bash(*:*)`        | `"execute"`             | shell commands                                |
| `Grep` / `Glob`             | `"search"`              | content and file search                       |
| `WebFetch` / `WebSearch`    | `"web"`                 | ⚠️ NOT `"fetch"` — use `"web"`                |
| `TaskCreate` / `TaskUpdate` | `"todo"`                | converted to manage_todo_list (VS Code only)  |
| `Agent` (sub-agent spawn)   | `"agent"`               | for handoffs / runSubagent delegation         |
| `AskUserQuestion`           | —                       | not available; ask inline in response         |
| `Skill`                     | —                       | not applicable; replace with `**Reference:**` |

**Complete alias list from guide:** `['read', 'edit', 'search', 'execute', 'agent', 'web', 'todo']`

### Execute tool variants

| Copilot tool                  | When to use                                        |
| ----------------------------- | -------------------------------------------------- |
| `"execute"`                   | Generic shell — maps from all `Bash(*:*)` variants |
| `"execute/runInTerminal"`     | Run command in VS Code integrated terminal         |
| `"execute/getTerminalOutput"` | Read terminal output without running a new command |

### Wildcard MCP patterns

```yaml
tools: ['github/*']       # all GitHub operations
tools: ['atlassian/*']    # all Atlassian/Jira operations
tools: ['playwright/*']   # browser automation
tools: ['my-mcp/tool']    # specific tool from custom server
```

Use wildcards when agent needs broad service access.
Use explicit `mcp__*` IDs for least-privilege (small set of known operations).

### MCP tools (explicit)

```yaml
tools:
    - 'read'
    - 'execute'
    - 'mcp__atlassian__getJiraIssue'
```

`tools` is optional — omitting it grants all tools. Always list tools explicitly for least privilege.

---

## Model Expansion

| Claude `model:` | Copilot `model:`                         |
| --------------- | ---------------------------------------- |
| `opus`          | `"Claude Opus 4.5"`                      |
| `sonnet`        | `"Claude Sonnet 4.5"`                    |
| `haiku`         | `"Claude Haiku 4.5"`                     |
| `inherit`       | omit field or use most capable available |
| Full model ID   | keep as-is                               |

`model` is **Recommended** (not required). Omitting it lets Copilot choose.

**Selection guide:**

- Complex orchestrators with multi-phase reasoning → `"Claude Opus 4.5"`
- Standard agents → `"Claude Sonnet 4.5"`
- Lightweight / fast tasks → `"Claude Haiku 4.5"`

---

## Frontmatter Fields Reference

| Field           | Required?   | Values                           | Notes                    |
| --------------- | ----------- | -------------------------------- | ------------------------ |
| `description`   | **Yes**     | `'single-quoted string'`         | 50–150 chars             |
| `tools`         | Optional    | `['read', 'edit', ...]`          | Omit = all tools         |
| `model`         | Recommended | `'Claude Sonnet 4.5'`            | Full name required       |
| `name`          | Optional    | String                           | Defaults to filename     |
| `target`        | Optional    | `'vscode'` or `'github-copilot'` | See below                |
| `infer`         | Optional    | `true` / `false`                 | Auto-invoke from context |
| `argument-hint` | Optional    | String                           | VS Code only             |
| `handoffs`      | Optional    | List of delegations              | VS Code only             |

### `target` values

| Value              | When to use                                     |
| ------------------ | ----------------------------------------------- |
| `'vscode'`         | VS Code Copilot Chat agent (default)            |
| `'github-copilot'` | GitHub.com Copilot — PR review, issue workflows |

### `handoffs` (VS Code only)

```yaml
handoffs:
    - label: 'Validate File'
      agent: 'Validator-Agent'
      prompt: 'Analyze this file for anti-patterns and return violations'
```

### Fields to DROP from Claude frontmatter

| Claude field    | Action                                                |
| --------------- | ----------------------------------------------------- |
| `color`         | omit                                                  |
| `memory`        | omit                                                  |
| `isolation`     | omit                                                  |
| `skills`        | omit (content goes to `.copilot_utils/{agent_name}/`) |
| `allowed-tools` | omit (replaced by `tools` array)                      |

---

## Skill Classification Rules

### → `trees/{skill}.md` (decision/diagnosis logic)

Use when SKILL.md is primarily branching logic, classification flows, diagnosis trees, routing rules.
**Signal words:** "decision tree", "classification", "diagnosis", "when you see", "if.\*then"
Reference in body: `**Apply tree:** .copilot_utils/{agent_name}/trees/{skill}.md`

### → `context/{skill}.md` (reference knowledge)

Use when SKILL.md is primarily how-to guides, naming patterns, API patterns, workflow knowledge.
**Signal words:** "conventions", "patterns", "how to", "reference", "guide", "standards"
Reference in body: `**Reference:** .copilot_utils/{agent_name}/context/{skill}.md`

### Split when skill has both types

1. Copy full SKILL.md to `context/{skill}.md`
2. Extract only decision/branching sections to `trees/{skill}.md`
3. In `trees/{skill}.md`, add: `For full context see context/{skill}.md`