Claude Code, Codex y OpenCode cargan las skills en el mismo formato: una carpeta con un archivo SKILL.md adentro. Ese formato es el estándar abierto Agent Skills, que creó Anthropic y que se convirtió en un proyecto de la Linux Foundation el 4 de noviembre de 2026. Así que una misma skill puede funcionar en las tres herramientas. El detalle es que cada herramienta busca en carpetas diferentes, y hay campos que solo entiende Claude Code. Esta guía muestra dónde busca cada herramienta, cómo tener una sola copia que carguen las tres, qué no funciona fuera de Claude Code y cómo Orkas les da las mismas skills a todos los agentes de programación que ejecuta.
La respuesta corta: guarda la carpeta de cada skill en ~/.agents/skills. Codex y OpenCode ya leen esa carpeta. Claude Code no, así que agrega un enlace a cada skill en ~/.claude/skills. Deja en el frontmatter solo name y description, y dale a cada skill el mismo nombre que su carpeta. Verificado el 8 de noviembre de 2026 con Claude Code 2.1.319, Codex 0.167.0 y OpenCode 2.2.6.
Dónde buscan skills Claude Code, Codex y OpenCode
| Carpeta | Claude Code | Codex | OpenCode |
|---|---|---|---|
~/.agents/skills | No | Sí | Sí |
.agents/skills en un proyecto | No | Sí | Sí |
~/.claude/skills | Sí | No | Sí |
.claude/skills en un proyecto | Sí | No | Sí |
~/.codex/skills | No | Sí, pero obsoleta | No |
~/.config/opencode/skills, .opencode/skills | No | No | Sí |
| Cómo llamar a una skill | /skill-name | $skill-name o /skills | @skill-name |
Las tres también eligen una skill por sí solas cuando tu solicitud coincide con su descripción. En las carpetas de proyecto, cada herramienta revisa la carpeta desde donde la inicias y cada carpeta superior hasta la raíz del repositorio.
- Claude Code es el que no encuentra
.agents/skills. Su documentación de skills solo menciona carpetas.claude, y su documentación de memoria dice que no lee «nada que esté dentro de un directorio.agents/». La solicitud para cambiar esto, el issue #31005, sigue abierta con más de 450 votos a favor. - Codex se pasó a
.agents/skills. Su documentación menciona.agents/skillsen el proyecto,~/.agents/skillspara tu usuario y/etc/codex/skillspara administradores. La carpeta anterior,~/.codex/skills, está marcada como obsoleta en el código fuente, pero todavía se carga. Codex no lee ninguna carpeta.claude. - OpenCode lee todo. Su documentación menciona sus propias carpetas, además de
.claude/skillsy.agents/skills, en los dos niveles. Esto aplica a la línea 2.2 y a la línea 1.19, que todavía recibe versiones nuevas.
Configura una carpeta compartida
Usa ~/.agents/skills como la única copia real. Codex y OpenCode la leen sin configurar nada, y tanto npx skills como el importador de Codex escriben ahí. Luego, Claude Code recibe un enlace a cada skill.
- Mueve tus skills a
~/.agents/skills. Por cada skill que escribiste en~/.claude/skillso~/.codex/skills, mueve su carpeta, por ejemplomv ~/.claude/skills/release-notes ~/.agents/skills/. Deja~/.claude/skills/synceddonde está: ahí guarda Claude Code las skills de tu cuenta de claude.ai. - Crea un enlace a cada skill en la carpeta de Claude Code. En macOS o Linux, ejecuta esto. Omite cualquier skill que ya tenga ahí una carpeta o un enlace.
mkdir -p ~/.agents/skills ~/.claude/skills
for d in ~/.agents/skills/*/; do
n=$(basename "$d")
[ -e ~/.claude/skills/"$n" ] || ln -s ~/.agents/skills/"$n" ~/.claude/skills/"$n"
done- En Windows, usa junctions. No requieren permisos de administrador. En PowerShell:
New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null
Get-ChildItem "$HOME\.agents\skills" -Directory | ForEach-Object {
$link = "$HOME\.claude\skills\$($_.Name)"
if (-not (Test-Path $link)) { New-Item -ItemType Junction -Path $link -Target $_.FullName | Out-Null }
}- Verifica cada herramienta. Inicia una sesión nueva. En Claude Code, escribe
/y busca la skill. En Codex, ejecuta/skills. En OpenCode, escribe@.
Para un proyecto que comparte el equipo, haz lo mismo dentro del repositorio: guarda las skills en .agents/skills y crea un enlace a cada una desde .claude/skills con un enlace relativo, por ejemplo ln -s ../../.agents/skills/release-notes .claude/skills/release-notes.
Algunos puntos para hacerlo bien:
- Enlaza cada skill, no la carpeta completa. Si
~/.claude/skillsen sí apunta a~/.agents/skills, las carpetassyncedy.trashde Claude Code terminan en la carpeta compartida, y Codex y OpenCode podrían cargar también las skills sincronizadas. La desventaja es que tienes que volver a ejecutar el ciclo cuando agregas una skill. - Enlaza carpetas, no archivos SKILL.md. Codex sigue una carpeta de skill enlazada, pero ignora un SKILL.md que sea en sí un enlace. OpenAI cerró esa solicitud como no planeada.
- No hagas commit de enlaces si tu equipo tiene gente en Windows. De forma predeterminada, Git for Windows hace checkout de los enlaces como pequeños archivos de texto. Crea los enlaces con un script de configuración o haz commit de copias reales.
- OpenCode ve cada skill dos veces y se queda con una. Lee tanto el enlace en
~/.claude/skillscomo la carpeta en~/.agents/skills. La versión 2.2 las combina sin avisar. La versión 1.19 registra una advertencia de duplicado; configuraOPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1para que OpenCode deje de leer las carpetas de Claude.
Escribe una skill que las tres puedan cargar
Este SKILL.md se carga de la misma forma en Claude Code, Codex y OpenCode. Está en ~/.agents/skills/release-notes/SKILL.md, junto a una carpeta references y una carpeta scripts.
---
name: release-notes
description: "Drafts release notes from git commits since the last tag. Use when the user asks for a changelog, release notes, or what changed since the last release."
license: MIT
---
# Notas de la versión
1. Encuentra el último tag: git describe --tags --abbrev=0
2. Lista los commits posteriores: git log <tag>..HEAD --oneline --no-merges
3. Agrupa los commits en Added, Changed y Fixed, según references/format.md en la carpeta de esta skill.
4. Para guardar un archivo, ejecuta scripts/write_notes.sh desde la carpeta de esta skill.- Dale a la skill el mismo nombre que su carpeta. Usa minúsculas, números y guiones, con un máximo de 64 caracteres. Codex usa
name, OpenCode 2.2 usa el nombre de la carpeta y Claude Code acepta cualquiera. Si son distintos, llamas a la misma skill con nombres diferentes en cada herramienta. Codex omite una skill cuyo nombre tenga más de 64 caracteres. - Mantén la descripción en menos de 1,024 caracteres y pon primero las palabras que la gente va a usar. Ese es el límite del estándar, y Codex recorta a esa longitud las descripciones más largas en su lista de skills.
- Escribe entre comillas cualquier valor que tenga dos puntos seguidos de un espacio. De lo contrario, es posible que el frontmatter no se pueda analizar. Codex corrige la mayoría de estos casos, Claude Code carga la skill como si no tuviera frontmatter y OpenCode puede omitir la skill sin mostrar un error.
- Haz que los scripts encuentren su propia carpeta. Las herramientas ejecutan los comandos desde la carpeta de tu proyecto, no desde la carpeta de la skill. Un script que empieza con
cd "$(dirname "$0")"funciona desde cualquier lugar. - No uses "claude" en el nombre si es posible que subas la skill a claude.ai o a la Claude API. Los dos rechazan nombres que contengan "claude" o "anthropic".
Qué no funciona fuera de Claude Code
Codex lee solo name, description y una descripción corta dentro de metadata. OpenCode 2.2 también lee metadata y disable-model-invocation. Los dos ignoran cualquier otro campo sin mostrar error, así que una skill de Claude Code se carga, pero se comporta distinto.
| En una skill de Claude Code | Claude Code | Codex | OpenCode 2.2 |
|---|---|---|---|
allowed-tools | Funciona | Se ignora | Se ignora |
disable-model-invocation: true | Funciona | Se ignora; usa agents/openai.yaml | Funciona |
context: fork, agent, model, hooks, argument-hint | Funciona | Se ignora | Se ignora |
$ARGUMENTS y $1 en el texto | Se reemplazan con tus argumentos | Se dejan como texto | Se dejan como texto |
!`command` en el texto | Se ejecuta antes de que Claude lea la skill | Se deja como texto | Se deja como texto |
${CLAUDE_SKILL_DIR} | Se reemplaza con la carpeta de la skill | Se deja como texto | Se deja como texto |
- Escribe pasos que funcionen sin estas funciones. Escribe «ejecuta scripts/check.sh desde la carpeta de esta skill» en vez de usar
${CLAUDE_SKILL_DIR}, y pide los datos que falten con palabras sencillas en vez de usar$ARGUMENTS. Claude Code sigue esas mismas instrucciones sin problema. - Para evitar que Codex llame a una skill por sí solo, agrega
agents/openai.yamla la carpeta de la skill conallow_implicit_invocation: falsedentro depolicy. Aun así, puedes llamarla con$skill-name. allowed-toolsno limita lo que pueden hacer Codex u OpenCode. La tabla de compatibilidad denpx skillslo muestra como compatible en los dos, pero el cargador de skills de ninguna de las dos herramientas lee ese campo. Define los límites en la configuración de permisos de cada herramienta.
Herramientas que instalan skills para varios agentes
| Herramienta | Cómo comparte las skills | Qué revisar |
|---|---|---|
npx skills (Vercel, 38,500 estrellas) | Copia una skill en .agents/skills y enlaza a ella la carpeta de cada agente. En Windows usa junctions. --copy crea copias separadas. | La misma estructura de esta guía. Ejecuta npx skills add owner/repo, con -g para tu carpeta de usuario. |
| skillshare (2,900 estrellas) | Mantiene una carpeta de origen y la enlaza en la carpeta de cada herramienta; junctions en Windows. | Actualizado el 6 de noviembre de 2026. Se instala con Homebrew o con un script de shell. |
Codex /import | Copia skills de .claude/skills a .agents/skills. | Las copias dejan de coincidir con los originales. También cambia "claude" por "Codex" en el texto, incluso dentro de rutas de archivo (issue abierto #40147). |
| openskills (10,800 estrellas) | Copia skills en .claude/skills y las lista en AGENTS.md. | Sin versiones desde enero de 2026. Su opción --universal escribe en .agent/skills, que ninguna de las tres herramientas lee. |
¿Y qué hay de CLAUDE.md y AGENTS.md?
Codex y OpenCode leen AGENTS.md, y OpenCode usa CLAUDE.md como alternativa cuando un proyecto no tiene AGENTS.md. Desde la versión 2.1.277, Claude Code también lee AGENTS.md, pero solo en un proyecto que no tenga CLAUDE.md ni CLAUDE.local.md. Si tienes los dos archivos, abre /config en Claude Code y configura Project instructions para que cargue ambos. Pon en AGENTS.md las reglas que debe seguir cualquier agente, y deja CLAUDE.md para lo que solo necesita Claude Code.
Usa las mismas skills desde Orkas
Orkas es una app de escritorio que ejecuta Claude Code, Codex, OpenCode, OpenClaw y Hermes como agentes en un solo chat. Usa las copias instaladas en tu computadora y tus propios inicios de sesión. Así es como tus skills llegan a esos agentes.
- La carpeta compartida sigue funcionando. Cada CLI sigue leyendo sus propias carpetas de skills cuando Orkas la inicia, así que la configuración de arriba funciona sin cambios. Orkas agrega su propio servidor MCP junto a los tuyos, en lugar de reemplazarlos.
- Las skills que agregas en Orkas llegan a todas las CLI. Cada CLI que inicia Orkas recibe un servidor MCP llamado
orkas. Este servidor lista tus skills de Orkas, carga una cuando la tarea coincide y ejecuta los scripts que incluye la skill. Pídele a Claude Code que use una skill por su nombre, o deja que encuentre la correcta. - Orkas también lee tus skills de Claude Code y Codex. Las skills en
~/.claude/skillsy~/.codex/skillsaparecen en Habilidades ▸ Carpetas globales, y el Commander puede usarlas en sus propias tareas. Orkas solo lee estas carpetas y nunca las modifica. No lee~/.agents/skillsdirectamente, así que con la configuración de arriba encuentra tus skills a través de los enlaces en~/.claude/skills.
Para agregar un paquete de skills desde GitHub, pega el enlace del repositorio en un chat con el Commander y pídele que instale el paquete. Si el paquete necesita instalar dependencias, Orkas te pregunta primero. Las skills aparecen en Habilidades ▸ Paquetes externos. A partir de ese momento, Claude Code, Codex y OpenCode pueden usarlas cuando los ejecutas desde Orkas, sin copiar nada en tres carpetas. Para empezar, elige Conectar agentes en la barra lateral y selecciona las CLI que tienes instaladas. Para ver paso a paso cómo usar dos de ellas lado a lado, consulta Cómo ejecutar Claude Code y Codex juntos.
¿Qué configuración deberías elegir?
| Tu situación | Qué hacer |
|---|---|
| Usas dos o tres de estas herramientas en una misma computadora | Guarda las skills en ~/.agents/skills y enlaza cada una en ~/.claude/skills |
| Un equipo comparte skills en un repositorio | Haz commit de .agents/skills; crea los enlaces de .claude/skills con un script de configuración |
| Instalas skills de GitHub con frecuencia | npx skills add, que configura esos mismos enlaces por ti |
| Solo usas Claude Code y OpenCode | Sigue usando ~/.claude/skills; OpenCode ya la lee |
| Ejecutas las CLI desde Orkas | Instala los paquetes de skills una vez en Orkas; cualquier CLI que inicie puede usarlos |
Preguntas frecuentes
¿Puedo usar skills de Claude en Codex?
Sí. Codex lee el mismo formato SKILL.md, pero busca en ~/.agents/skills y .agents/skills, no en ~/.claude/skills. Mueve ahí las carpetas de las skills y crea enlaces de regreso para Claude Code, o ejecuta /import en Codex para copiarlas. Campos como allowed-tools y funciones como $ARGUMENTS solo funcionan en Claude Code.
¿OpenCode lee las skills de Claude Code?
Sí. OpenCode lee ~/.claude/skills y .claude/skills, además de ~/.agents/skills y sus propias carpetas, así que las skills de Claude Code aparecen sin configurar nada. Para desactivarlo, configura OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1.
¿Claude Code lee .agents/skills?
No. A noviembre de 2026, Claude Code solo lee skills de carpetas .claude, y su documentación dice que ignora todo lo que esté dentro de un directorio .agents. La solicitud para agregarlo, el issue #31005, sigue abierta. Mientras tanto, enlaza cada skill desde ~/.claude/skills.
¿Por qué Codex no ve mi skill enlazada?
Codex sigue una carpeta de skill enlazada, pero ignora un archivo SKILL.md que sea en sí un enlace. En su lugar, enlaza la carpeta completa. Un enlace relativo se resuelve desde la carpeta donde está el enlace, así que revisa que la ruta sea correcta desde ahí.
¿Por qué una skill aparece dos veces?
Por lo general, porque hay dos copias en carpetas que la herramienta lee. Codex todavía lee la carpeta anterior ~/.codex/skills además de ~/.agents/skills, y muestra las dos copias de una skill con el mismo nombre. Deja una copia en ~/.agents/skills y elimina la otra.
Para comparar las tres herramientas más allá de las skills, consulta Claude Code frente a Codex frente a OpenCode.