Orkas Orkas
Inicio Blog Skills en Codex y OpenCode
Producto

Cómo usar un mismo conjunto de skills en Claude Code, Codex y OpenCode

Las tres cargan el mismo formato SKILL.md, pero cada una busca en carpetas distintas. Aquí verás dónde busca cada herramienta, cómo mantener una sola copia que carguen las tres, qué no se traslada desde Claude Code y cómo Orkas 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 fichero SKILL.md dentro. Ese formato es el estándar abierto Agent Skills, que creó Anthropic y que pasó a ser un proyecto de la Linux Foundation el 4 de noviembre de 2026. Por eso, una misma skill puede funcionar en las tres herramientas. El problema es que cada herramienta busca en carpetas distintas y que algunos campos solo los entiende Claude Code. Esta guía explica dónde busca cada herramienta, cómo mantener una sola copia que carguen las tres, qué no se traslada y cómo Orkas da las mismas skills a todos los agentes de programación que ejecuta.

En resumen: guarda la carpeta de cada skill en ~/.agents/skills. Codex y OpenCode ya leen esa carpeta. Claude Code no, así que añade un enlace a cada skill en ~/.claude/skills. Limita el frontmatter a name y description, y ponle a cada skill el mismo nombre que a su carpeta. Comprobado el 8 de noviembre de 2026 con Claude Code 2.1.319, Codex 0.167.0 y OpenCode 2.2.6.

Dónde buscan las 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 en desusoNo
~/.config/opencode/skills, .opencode/skillsNoNoSí
Cómo se invoca una skill/skill-name$skill-name o /skills@skill-name

Las tres también eligen una skill por su cuenta cuando tu petición coincide con su descripción. En las carpetas de proyecto, cada herramienta revisa la carpeta desde la que la arrancas y todas las carpetas superiores hasta la raíz del repositorio.

  • Claude Code es el único que no encuentra .agents/skills. Su documentación de skills solo menciona carpetas .claude, y su documentación sobre memoria dice que no lee «nada que esté dentro de un directorio .agents/». La petición para cambiarlo, el issue #31005, sigue abierta con más de 450 votos a favor.
  • Codex se ha pasado a .agents/skills. Su documentación indica .agents/skills en el proyecto, ~/.agents/skills para tu usuario y /etc/codex/skills para los administradores. La antigua carpeta ~/.codex/skills está marcada como obsoleta en el código fuente, pero se sigue cargando. Codex no lee ninguna carpeta .claude.
  • OpenCode lo lee todo. Su documentación indica sus propias carpetas además de .claude/skills y .agents/skills, en ambos niveles. Esto vale tanto para la rama 2.2 como para la 1.19, que sigue recibiendo 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í. Después, Claude Code recibe un enlace a cada skill.

  1. Mueve tus skills a ~/.agents/skills. Por cada skill que hayas escrito 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. Enlaza cada skill en la carpeta de Claude Code. En macOS o Linux, ejecuta esto. Se salta 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 uniones de directorio (junctions). No necesitan 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. Comprueba cada herramienta. Abre una sesión nueva. En Claude Code, escribe / y busca la skill. En Codex, ejecuta /skills. En OpenCode, escribe @.

En un proyecto que comparte todo el equipo, haz lo mismo dentro del repositorio: guarda las skills en .agents/skills y enlaza cada una desde .claude/skills con un enlace relativo, como ln -s ../../.agents/skills/release-notes .claude/skills/release-notes.

Algunos detalles que conviene tener en cuenta:

  • Enlaza cada skill, no la carpeta entera. Si el propio ~/.claude/skills apunta a ~/.agents/skills, las carpetas synced y .trash de Claude Code acaban en la carpeta compartida, y Codex y OpenCode también pueden cargar las skills sincronizadas. A cambio, tienes que volver a ejecutar el bucle cada vez que añadas una skill.
  • Enlaza carpetas, no ficheros SKILL.md. Codex sigue una carpeta de skill enlazada, pero ignora un SKILL.md que sea en sí mismo un enlace. OpenAI cerró esa petición y no tiene previsto implementarla.
  • No hagas commit de enlaces si tienes compañeros en Windows. Git for Windows, por defecto, convierte los enlaces en pequeños ficheros de texto al hacer checkout. 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 de ~/.claude/skills como la carpeta de ~/.agents/skills. La versión 2.2 las fusiona sin avisar. La versión 1.19 registra un aviso de duplicado; define OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1 para que OpenCode deje de leer las carpetas de Claude.

Escribe una skill que puedan cargar las tres

Este SKILL.md se carga igual en Claude Code, Codex y OpenCode. Está en ~/.agents/skills/release-notes/SKILL.md, con una carpeta references y otra scripts al lado.

---
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 versión

1. Busca la última etiqueta: git describe --tags --abbrev=0
2. Lista los commits desde esa etiqueta: git log <tag>..HEAD --oneline --no-merges
3. Agrupa los commits en Added, Changed y Fixed, siguiendo references/format.md de la carpeta de esta skill.
4. Para guardar un fichero, ejecuta scripts/write_notes.sh desde la carpeta de esta skill.
  • Ponle a la skill el mismo nombre que a su carpeta. Usa minúsculas, números y guiones, hasta 64 caracteres. Codex se guía por name, OpenCode 2.2 por el nombre de la carpeta y Claude Code acepta cualquiera de los dos. Si no coinciden, invocarás la misma skill con nombres distintos en cada herramienta. Codex omite las skills cuyo nombre supera los 64 caracteres.
  • Mantén la descripción por debajo de 1024 caracteres y pon primero las palabras que usará la gente. Es el límite del estándar, y Codex recorta las descripciones más largas a esa longitud en su lista de skills.
  • Pon entre comillas cualquier valor que contenga dos puntos seguidos de un espacio. Si no, puede que el frontmatter no se analice. Codex corrige la mayoría de estos casos, Claude Code carga la skill como si no tuviera frontmatter y OpenCode puede saltarse la skill sin dar ningún error.
  • Haz que los scripts encuentren su propia carpeta. Las herramientas ejecutan los comandos desde la carpeta de tu proyecto, no desde la de la skill. Un script que empiece con cd "$(dirname "$0")" funciona desde cualquier sitio.
  • No incluyas "claude" en el nombre si es posible que subas la skill a claude.ai o a la Claude API. Ambos rechazan los nombres que contienen "claude" o "anthropic".

Qué no se traslada desde Claude Code

Codex solo lee name, description y una descripción corta dentro de metadata. OpenCode 2.2 lee además metadata y disable-model-invocation. Los dos ignoran todos los demás campos sin dar error, así que una skill de Claude Code se carga, pero se comporta de otra manera.

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 sustituyen por tus argumentosQuedan como textoQuedan como texto
!`command` en el textoSe ejecuta antes de que Claude lea la skillQueda como textoQueda como texto
${CLAUDE_SKILL_DIR}Se sustituye por la carpeta de la skillQueda como textoQueda como texto
  • Escribe pasos que funcionen sin estas funciones. Pon «ejecuta scripts/check.sh desde la carpeta de esta skill» en lugar de usar ${CLAUDE_SKILL_DIR}, y pide los datos que falten con palabras normales en lugar de usar $ARGUMENTS. Claude Code sigue esas mismas instrucciones sin problema.
  • Para que Codex no invoque una skill por su cuenta, añade agents/openai.yaml a la carpeta de la skill con allow_implicit_invocation: false dentro de policy. Podrás seguir invocándola con $skill-name.
  • allowed-tools no limita lo que pueden hacer Codex ni OpenCode. La tabla de compatibilidad de npx skills lo marca como compatible en ambos, pero el cargador de skills de ninguna de las dos herramientas lee ese campo. Fija los límites en la configuración de permisos de cada herramienta.

Herramientas que instalan skills para varios agentes

HerramientaCómo comparte las skillsQué vigilar
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 independientes.La misma estructura que esta guía. Ejecuta npx skills add owner/repo, con -g para tu carpeta de usuario.
skillshare (2900 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 se desincronizan de los originales. Además, cambia "claude" por "Codex" en el texto, incluso dentro de rutas de fichero (issue abierto #40147).
openskills (10.800 estrellas)Copia skills en .claude/skills y las enumera en AGENTS.md.Sin versiones nuevas desde enero de 2026. Su opción --universal escribe en .agent/skills, que no lee ninguna de las tres herramientas.

¿Y qué pasa con CLAUDE.md y AGENTS.md?

Codex y OpenCode leen AGENTS.md, y OpenCode recurre a CLAUDE.md cuando un proyecto no tiene AGENTS.md. Desde la versión 2.1.277, Claude Code también lee AGENTS.md, pero solo en proyectos que no tienen CLAUDE.md ni CLAUDE.local.md. Si mantienes ambos ficheros, abre /config en Claude Code y configura Project instructions para que cargue los dos. 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 aplicación de escritorio que ejecuta Claude Code, Codex, OpenCode, OpenClaw y Hermes como agentes en un mismo chat. Usa las copias instaladas en tu ordenador y las cuentas con las que ya has iniciado 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 anterior funciona tal cual. Orkas añade su propio servidor MCP junto a los tuyos, en lugar de sustituirlos.
  • Las skills que añades en Orkas llegan a todas las CLI. Cada CLI que inicia Orkas recibe un servidor MCP llamado orkas. Este servidor enumera tus skills de Orkas, carga una cuando la tarea encaja y ejecuta los scripts que trae la skill. Pídele a Claude Code que use una skill por su nombre o deja que encuentre la adecuada.
  • Orkas también lee tus skills de Claude Code y Codex. Las skills de ~/.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 anterior, encuentra tus skills a través de los enlaces de ~/.claude/skills.

Para añadir 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 lo pregunta antes. Las skills aparecen en Habilidades ▸ Paquetes externos. A partir de ahí, 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 tengas instaladas. Si quieres una guía completa para usar dos de ellas en paralelo, consulta Cómo ejecutar Claude Code y Codex juntos.

Ejecútalos desde Orkas Dales a Claude Code, Codex y OpenCode las mismas skills desde una sola aplicación. Orkas es gratis en macOS y Windows. Ejecuta las CLI que ya tienes, con tus propias cuentas.
Descargar Orkas — gratis

¿Qué configuración te conviene?

Tu situaciónQué hacer
Usas dos o tres de estas herramientas en el mismo ordenadorGuarda 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 a menudonpx skills add, que crea 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 sola vez en Orkas; todas las CLI que inicia pueden 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 enlázalas de vuelta 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, define OPENCODE_DISABLE_CLAUDE_CODE_SKILLS=1.

¿Claude Code lee .agents/skills?

No. A fecha de noviembre de 2026, Claude Code solo lee skills de carpetas .claude, y su documentación dice que ignora todo lo que haya dentro de un directorio .agents. La petición para añadirlo, 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 fichero SKILL.md que sea en sí mismo un enlace. Enlaza la carpeta entera. Un enlace relativo se resuelve desde la carpeta en la que está el enlace, así que comprueba que la ruta sea correcta desde ahí.

¿Por qué aparece una skill dos veces?

Normalmente, porque hay dos copias en carpetas que lee la herramienta. Codex sigue leyendo la antigua carpeta ~/.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 borra la otra.

Para comparar las tres herramientas más allá de las skills, consulta Claude Code frente a Codex frente a OpenCode.