Orkas Orkas
Inicio Blog Skills en Codex y OpenCode
Producto

Cómo usar las mismas skills en Claude Code, Codex y OpenCode

Las tres cargan el mismo formato SKILL.md, pero cada una busca en carpetas diferentes. Aquí verás 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 todas las CLI que ejecuta.

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

CarpetaClaude CodeCodexOpenCode
~/.agents/skillsNoSíSí
.agents/skills en un proyectoNoSíSí
~/.claude/skillsSíNoSí
.claude/skills en un proyectoSíNoSí
~/.codex/skillsNoSí, pero obsoletaNo
~/.config/opencode/skills, .opencode/skillsNoNoSí
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/skills en el proyecto, ~/.agents/skills para tu usuario y /etc/codex/skills para 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/skills y .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.

  1. Mueve tus skills a ~/.agents/skills. Por cada skill que escribiste en ~/.claude/skills o ~/.codex/skills, mueve su carpeta, por ejemplo mv ~/.claude/skills/release-notes ~/.agents/skills/. Deja ~/.claude/skills/synced donde está: ahí guarda Claude Code las skills de tu cuenta de claude.ai.
  2. 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
  1. 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 }
}
  1. 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/skills en sí apunta a ~/.agents/skills, las carpetas synced y .trash de 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/skills como la carpeta en ~/.agents/skills. La versión 2.2 las combina sin avisar. La versión 1.19 registra una advertencia de duplicado; configura OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 para 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 CodeClaude CodeCodexOpenCode 2.2
allowed-toolsFuncionaSe ignoraSe ignora
disable-model-invocation: trueFuncionaSe ignora; usa agents/openai.yamlFunciona
context: fork, agent, model, hooks, argument-hintFuncionaSe ignoraSe ignora
$ARGUMENTS y $1 en el textoSe reemplazan con tus argumentosSe dejan como textoSe dejan como texto
!`command` en el textoSe ejecuta antes de que Claude lea la skillSe deja como textoSe deja como texto
${CLAUDE_SKILL_DIR}Se reemplaza con la carpeta de la skillSe deja como textoSe 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.yaml a la carpeta de la skill con allow_implicit_invocation: false dentro de policy. Aun así, puedes llamarla con $skill-name.
  • allowed-tools no limita lo que pueden hacer Codex u OpenCode. La tabla de compatibilidad de npx skills lo 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

HerramientaCómo comparte las skillsQué 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 /importCopia 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/skills y ~/.codex/skills aparecen 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/skills directamente, 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.

Ejecútalos desde Orkas Dales las mismas skills a Claude Code, Codex y OpenCode desde una sola app. Orkas es gratis en macOS y Windows. Ejecuta las CLI que ya tienes, con tus propios inicios de sesión.
Descarga Orkas gratis

¿Qué configuración deberías elegir?

Tu situaciónQué hacer
Usas dos o tres de estas herramientas en una misma computadoraGuarda las skills en ~/.agents/skills y enlaza cada una en ~/.claude/skills
Un equipo comparte skills en un repositorioHaz commit de .agents/skills; crea los enlaces de .claude/skills con un script de configuración
Instalas skills de GitHub con frecuencianpx skills add, que configura esos mismos enlaces por ti
Solo usas Claude Code y OpenCodeSigue usando ~/.claude/skills; OpenCode ya la lee
Ejecutas las CLI desde OrkasInstala 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.