Newsletter para devsEntra

Migra tu setup de GitHub Copilot a Claude Code, Codex u opencode sin empezar de cero

Una skill que recoge tus instrucciones, prompts, agentes y MCP de GitHub Copilot —ese .github que llevas tiempo afinando— y los reescribe en el formato del agente al que te mudas. Traduce en vez de copiar, y te dice qué quedó fuera.

Invócala con un comando

  • /migrate-copilot-instructions

    Auto-detecta el agente destino mirando tu repo (.claude/, .codex/, .opencode/) y migra todas tus capas de Copilot: instrucciones globales, reglas por ruta, prompts, agentes, skills y MCP.

  • /migrate-copilot-instructions "a Claude Code"

    Le dices el destino cuando tienes varios setups o aún no existe ninguno. Genera CLAUDE.md + .claude/ a partir de tus archivos .github.

  • /migrate-copilot-instructions "solo a AGENTS.md"

    Produce un AGENTS.md tool-agnóstico, sin adaptadores específicos, para que cualquier agente compatible lo lea sin atarte a uno.

Qué es esta skill

¿Qué es migrate-copilot-instructions?

migrate-copilot-instructions coge toda la configuración que tienes montada para GitHub Copilot —ese .github/copilot-instructions.md que has ido afinando, las reglas por ruta, los prompts, los agentes y hasta tus servidores MCP— y la reescribe en el formato del agente al que te mudas. No copia y pega: traduce. Quita lo específico de VS Code, normaliza nombres de modelo y rutas, y deja tu setup funcionando en Claude Code, Codex u opencode.

No es un script de migración a ciegas. Mira tu repo, entiende qué tienes y a dónde vas, y te avisa de lo que no ha podido convertir en vez de dejártelo a medias.

Cómo funciona

Qué migra exactamente

Copilot reparte tu configuración en varias capas. La skill las recorre todas, una a una, y las traslada al sistema del agente destino:

  • Instrucciones globales. Tu .github/copilot-instructions.md se convierte en la base común (AGENTS.md) o en el CLAUDE.md del destino, sin el lenguaje atado a VS Code.
  • Reglas por ruta. Las .github/instructions/*.instructions.md con sus globs applyTo se reinterpretan en el sistema de reglas por carpeta del agente destino.
  • Prompts, agentes y skills. Tus .github/prompts, .github/agents y .github/skills pasan al formato y la estructura de carpetas nativa del destino.
  • MCP. Tu .vscode/mcp.json se traduce a la forma en que el agente destino declara sus servidores MCP.
Por qué engancha

Por qué no pierdes nada por el camino

Mudarte de agente suele significar reconstruir tu configuración desde cero. Esta skill existe justo para que no tengas que hacerlo:

  • Detecta el destino sola. Mira si ya tienes .claude/, .codex/ o .opencode/ en el repo y deduce a dónde vas. Solo te pregunta cuando la cosa es ambigua.
  • Traduce, no calca. Normaliza los nombres de modelo y las referencias a herramientas al formato nativo del destino, en vez de arrastrar lo específico de Copilot.
  • Te dice qué quedó fuera. Al terminar verifica la migración y te lista lo que no ha podido convertir, para que no descubras el hueco dos semanas más tarde.
Instalación

Cómo instalar migrate-copilot-instructions

Funciona con cualquier agente compatible con el estándar abierto de Agent Skills (Claude Code, Cursor, Codex, OpenCode, Gemini CLI…). Pega esto en tu terminal y listo:

npx skills add webreactiva/skills --skill migrate-copilot-instructions

¿La quieres disponible en todos tus proyectos? Añade -g para instalarla global en la carpeta de skills de tu agente (~/.agents/skills, o ~/.claude/skills si usas Claude Code):

npx skills add webreactiva/skills --skill migrate-copilot-instructions -g

Es open source. Puedes ver el código fuente en GitHub antes de instalarla.

Preguntas frecuentes

¿A qué agentes puedo migrar?

A Claude Code (CLAUDE.md + .claude/), Codex (AGENTS.md + .codex/) y opencode (AGENTS.md + .opencode/). Y si prefieres no atarte a ninguno, puede generar un AGENTS.md tool-agnóstico que cualquier agente compatible sabe leer.

¿Borra mi configuración de Copilot?

No. Lee tus archivos .github de origen y escribe la configuración nueva en el formato del destino. Tu setup de Copilot se queda donde está; tú decides si lo retiras después o lo mantienes en paralelo.

¿Con qué agentes funciona la skill y en qué idioma trabaja?

Con cualquier agente compatible con el estándar abierto de Agent Skills: Claude Code, Cursor, OpenAI Codex, OpenCode, Gemini CLI y más. Y trabaja en tu idioma: si le pides la migración en español, te explica los pasos y los avisos en español.

¿Tiene coste?

Es open source. La descargas e instalas gratis; el código está en GitHub.

¿Cómo se usa?

No necesitas el comando: tu agente también la activa sola cuando le dices algo como…

  • migra mi configuración de Copilot
  • pasa mis copilot-instructions a Claude Code
  • convierte mi .github en un AGENTS.md
  • me estoy mudando de Copilot a Codex
  • migrate my copilot instructions
  • port my .github/copilot-instructions.md

Siguiente paso

Ya sabes instalar skills. Aprende a crearlas.

Si te ha gustado tener un copiloto a demanda, el siguiente paso es escribir las tuyas. En la guía de skills aprendes la anatomía de un SKILL.md, a redactar descripciones que la disparan sola y a validarla.

Ir a la guía de skills →