Skip to content

endorphin-ai/hasbrains-agent-kit / agent-engineering/skills/convert-to-copilot

convert-to-copilot

Verified

This 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.

# 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/
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: 472kUpdated Claude CodeCodexVerifiedInstall
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: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
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 availableStars: 322kUpdated Claude CodeCodexVerifiedInstall