Cómo sincronizar skills en Claude Code, Codex, Cursor y OpenCode

Dónde busca cada herramienta

Según la documentación de cada herramienta, consultada el 4 de noviembre de 2026. Cada carpeta contiene una subcarpeta por skill, con un SKILL.md dentro.

Dos carpetas cubren las cuatro: ~/.claude/skills (Claude Code, Cursor, OpenCode) y ~/.agents/skills (Codex, Cursor, OpenCode).

Una copia en tu computadora: enlaces simbólicos

Guarda los archivos reales en una carpeta y apunta las dos ubicaciones a ella. En macOS o Linux:

mkdir -p ~/skills
# move existing skills in first, then:
ln -s ~/skills ~/.claude/skills
ln -s ~/skills ~/.agents/skills

Si alguna de las dos carpetas ya existe, mueve su contenido a ~/skills y borra la carpeta vacía antes de enlazar. Cursor y OpenCode leen las dos ubicaciones, así que llegan a los mismos archivos por dos rutas. Si alguno muestra una skill dos veces, sigue siendo un solo archivo: edítalo una vez en ~/skills.

Para un repositorio, haz lo mismo con .claude/skills y .agents/skills, haz commit de la carpeta real, y todos los que lo clonen tendrán las skills.

Una copia para el equipo: un servidor MCP

Los enlaces simbólicos y los repositorios sirven para desarrolladores. No llegan al compañero que trabaja en Claude o ChatGPT desde el navegador, y necesitan un git pull para actualizarse. Los cuatro agentes de programación también se conectan a servidores MCP remotos:

• Claude Code: claude mcp add --transport http <name> <url>
• Codex: una entrada de servidor con url = "…" en su configuración (Streamable HTTP).
• Cursor: un servidor Streamable HTTP en su configuración de MCP.
• OpenCode: un servidor con "type": "remote" en su configuración.

Un servidor que guarda las skills del equipo les da a los agentes de programación, a Claude y a ChatGPT la misma copia actual, sin nada que actualizar ni volver a enlazar.

Comprueba que una herramienta ve tu skill

1. Revisa la estructura: <folder>/<skill-name>/SKILL.md, con la carpeta llamada igual que el campo name.
2. Revisa el frontmatter: un name con letras minúsculas, números y guiones, de hasta 64 caracteres, y una description que no esté vacía. El conversor de SKILL.md escribe los dos.
3. Inicia una sesión nueva y pregúntale al agente qué skills tiene, o pídele la tarea que nombra la descripción.

Preguntas

¿Cómo sincronizo las skills de Claude Code con Claude Desktop y claude.ai?

Claude Code lee carpetas del disco; Claude Desktop y claude.ai guardan en tu cuenta las skills que subes. Sube la misma carpeta como ZIP en la sección de skills de Personalizar, o conecta los dos a un servidor MCP que sirva las skills.

¿Por qué Claude Code no ve mi carpeta .agents/skills?

Claude Code lee ~/.claude/skills y .claude/skills, no .agents/skills. Enlaza la carpeta dentro de ~/.claude/skills, como en los pasos de enlaces simbólicos de arriba.