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 |
references/conversion-output.md
View on GitHub# Conversion Phases 5–7: Write, Validate, Report
See also: `conversion-phases.md` (phases 1–3) · `conversion-body.md` (phase 4)
---
## Phase 5: Write Output Files
Write all files in this order:
1. `.github/agents/{agent_name}.agent.md`
- Frontmatter from Phase 3
- PROGRESS TRACKING section (from Phase 4.3) at top of body
- Converted body from Phase 4
2. All `.copilot_utils/{agent_name}/context/*.md` — knowledge files
3. All `.copilot_utils/{agent_name}/trees/*.md` — decision tree files
4. Any `.copilot_utils/{agent_name}/scripts/*` — script files
5. `.copilot_utils/{agent_name}/memory/` — copy memory files found in Phase 1
---
## Phase 6: Validate → `{output_folder}/6-validation.md`
Run the full checklist. Write PASS/FAIL for each item:
```markdown
# Validation Results
| Check | Status | Notes |
| -------------------------------------------------- | ------ | ------------- |
| {output_agent} exists | ✅/❌ | |
| Frontmatter: description with triggers | ✅/❌ | |
| Frontmatter: tools array (no "fetch") | ✅/❌ | |
| Frontmatter: model (expanded) | ✅/❌ | |
| No separate command file created | ✅/❌ | |
| No .prompt.md or .instructions.md | ✅/❌ | |
| Task tracking uses manage_todo_list with operation | ✅/❌ | |
| All .copilot_utils/ refs resolve to real files | ✅/❌ | |
| Scripts executable + paths correct | ✅/❌ | |
| Memory paths updated | ✅/❌ | |
| MCP calls preserved | ✅/❌ | |
| Agent body ≤ 30,000 chars | ✅/❌ | {count} chars |
```
If any check FAILS, fix before proceeding to Phase 7.
---
## Phase 7: Conversion Report (console output)
```markdown
## Conversion Report
### Agent Created
- ✅ .github/agents/{name}.agent.md — {N} phases, tools: [{tools}], model: {model}
### Command Absorbed
- 🔗 /{command-name} → merged into agent description + argument-hint
### Skill Context Created (.copilot_utils/{agent-name}/)
| File | Type | Source skill |
| ---------------------------- | ------------- | ------------------- |
| context/{skill}.md | knowledge | {skill} SKILL.md |
| trees/{skill}.md | decision tree | {skill} SKILL.md |
| context/{skill}-templates.md | templates | {skill} references/ |
### Memory
- 📝 .copilot_utils/{agent-name}/memory/ — {N files copied / none}
### Task Tracking
- 🔄 TaskCreate/TaskUpdate → manage_todo_list ({N} todos)
### Preserved As-Is
- ✅ MCP tool calls
- ✅ Bash commands and git workflow
- ✅ Phase structure and numbering
- ✅ Error handling
- ✅ ALWAYS_DO / NEVER_DO rules
- ✅ Final report format
### Not Created (by design)
- ❌ No .prompt.md (command absorbed into agent)
- ❌ No .instructions.md
- ❌ No .github/skills/
```
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: 471k | 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 |