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 |
scripts/claude-to-copilot.sh
View on GitHub#!/usr/bin/env bash
# claude-to-copilot.sh — scaffold Claude Code agent → Copilot structure
# Sourced by convert-agents.sh. Requires lib-extract.sh to be sourced first.
#
# Creates:
# .github/agents/{name}.agent.md ← placeholder (Claude transforms content)
# .copilot_utils/{name}/context/ ← skill knowledge files
# .copilot_utils/{name}/trees/ ← skill decision tree files
# .copilot_utils/{name}/scripts/ ← scripts from skills
# .copilot_utils/{name}/memory/ ← agent memory files
claude_to_copilot() {
local agent_file="$AGENT_FILE"
local cmd_file="${CMD_FILE:-}"
local agent_name
agent_name=$(extract_fm "$agent_file" "name")
[[ -z "$agent_name" ]] && agent_name=$(norm "$(basename "$agent_file" .md)")
echo -e "${B}=== Claude → Copilot: ${agent_name} ===${NC}\n"
local agent_dir=".copilot_utils/${agent_name}"
mkdir -p ".github/agents" \
"${agent_dir}/context" \
"${agent_dir}/trees" \
"${agent_dir}/scripts" \
"${agent_dir}/memory"
# --- Copy agent as placeholder ---
cp "$agent_file" ".github/agents/${agent_name}.agent.md"
echo -e " ${G}✅${NC} → .github/agents/${agent_name}.agent.md (scaffold — /convert-to-copilot to finish)"
# --- Note command to absorb ---
if [[ -n "$cmd_file" && -f "$cmd_file" ]]; then
local cmd_name; cmd_name=$(extract_fm "$cmd_file" "name")
local arg_hint; arg_hint=$(extract_fm "$cmd_file" "argument-hint")
echo -e " ${Y}🔗${NC} /${cmd_name} (${arg_hint:-no argument-hint}) → merge into agent description"
fi
# --- Process skills ---
local skills=()
while IFS= read -r skill; do
[[ -n "$skill" ]] && skills+=("$skill")
done < <(extract_skills "$agent_file")
if [[ ${#skills[@]} -eq 0 ]]; then
echo -e " ${Y}⚠️${NC} No skills: in frontmatter — provide skill paths manually"
fi
local dst="${CLAUDE_DIR:-$HOME/.claude}"
for skill in "${skills[@]}"; do
local sd=""
for sp in "$dst/skills/$skill" ".claude/skills/$skill"; do
[[ -d "$sp" ]] && sd="$sp" && break
done
if [[ -z "$sd" ]]; then
echo -e " ${R}❌${NC} Skill '$skill' not found"; continue
fi
echo -e " ${G}📦${NC} Skill: $skill"
# SKILL.md → classify as context or trees
if [[ -f "$sd/SKILL.md" ]]; then
local dest_type; dest_type=$(classify_skill "$sd/SKILL.md")
cp "$sd/SKILL.md" "${agent_dir}/${dest_type}/${skill}.md"
echo -e " ${G}$([ "$dest_type" = "trees" ] && echo "🌳" || echo "📄")${NC} SKILL.md → ${dest_type}/${skill}.md"
fi
# references/ → flatten into context/ (appended)
if [[ -d "$sd/references" ]]; then
for f in "$sd/references"/*.md; do
[[ -f "$f" ]] || continue
local bn; bn=$(basename "$f")
if echo "$bn" | grep -qiE 'template|schema|format'; then
cat "$f" >> "${agent_dir}/context/${skill}-templates.md"
echo -e " ${G}📎${NC} references/${bn} → context/${skill}-templates.md"
else
cat "$f" >> "${agent_dir}/context/${skill}.md"
echo -e " ${G}📎${NC} references/${bn} → appended to context/${skill}.md"
fi
done
fi
# assets/ → context/*-templates.md
if [[ -d "$sd/assets" ]]; then
for f in "$sd/assets"/*.md; do
[[ -f "$f" ]] || continue
local bn; bn=$(basename "$f")
cat "$f" >> "${agent_dir}/context/${skill}-templates.md"
echo -e " ${G}📄${NC} assets/${bn} → context/${skill}-templates.md"
done
fi
# trees/ subdirectory
if [[ -d "$sd/trees" ]]; then
for f in "$sd/trees"/*.md; do
[[ -f "$f" ]] || continue
cp "$f" "${agent_dir}/trees/"
echo -e " ${G}🌳${NC} trees/$(basename "$f") → trees/"
done
fi
# scripts/
if [[ -d "$sd/scripts" ]]; then
for f in "$sd/scripts"/*; do
[[ -f "$f" ]] || continue
cp "$f" "${agent_dir}/scripts/"
echo -e " ${G}🔧${NC} scripts/$(basename "$f") → scripts/"
done
fi
done
# --- Memory ---
local mem_dir="${CLAUDE_DIR:-$HOME/.claude}/agent-memory/${agent_name}"
if [[ -d "$mem_dir" ]]; then
cp "$mem_dir"/*.md "${agent_dir}/memory/" 2>/dev/null || true
echo -e " ${G}📝${NC} agent-memory → .copilot_utils/${agent_name}/memory/"
fi
echo -e "\n${B}Scaffold complete.${NC}"
echo -e "Created:"
echo -e " .github/agents/${agent_name}.agent.md"
find "${agent_dir}" -type f | sort | while read -r f; do
echo -e " ${f#.copilot_utils/${agent_name}/}"
done
echo ""
echo -e "${Y}Next: /convert-to-copilot ${agent_file}${NC} in Claude Code to finish.\n"
}
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 |