endorphin-ai/hasbrains-agent-kit / agent-engineering/skills/convert-to-copilot
convert-to-copilot
VerifiedThis skill should be used when converting a Claude Code agent (+ its launch command + its skills) into a single GitHub Copilot agent (.github/agents/*.agent.md) with supporting context files under .copilot_utils/{agent_name}/. Load when someone says 'convert to copilot', 'make copilot agent', 'copilot version of this agent', 'port this agent to copilot', or when /convert-to-copilot is invoked with an agent file path.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 1.9 KB |
| SKILL.md | skill md | 11.3 KB |
| assets/copilot-agent-template.md | markdown | 1.6 KB |
| examples/pr-reviewer.md | markdown | 5.2 KB |
| references/advanced-patterns.md | markdown | 3.6 KB |
| references/advanced-subagents.md | markdown | 4.0 KB |
| references/conversion-body.md | markdown | 4.4 KB |
| references/conversion-output.md | markdown | 3.1 KB |
| references/conversion-phases.md | markdown | 4.6 KB |
| references/tool-mapping.md | markdown | 6.1 KB |
| scripts/claude-to-copilot.sh | script | 4.6 KB |
| scripts/convert-agents.sh | script | 1.3 KB |
| scripts/copilot-to-claude.sh | script | 5.6 KB |
| scripts/lib-extract.sh | script | 1.8 KB |
README.md
View on GitHub# convert-to-copilot
> Port a Claude Code agent — with its command and skills — to one GitHub Copilot agent that works the same way.
**Plugin:** `agent-engineering` — `/plugin install agent-engineering@hasbrains-agent-kit`
## 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.
---
Made by **HasBrains** — https://hasbrains.com/
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |