Guías

Agent Skills (SKILL.md) en todos los agentes de programación con IA: Claude Code, Codex, Cline, Amp y OpenHands (2026)

¿Dónde busca cada agente de programación con IA las skills SKILL.md, y puede una misma carpeta de skill funcionar en todos?

Todos estos agentes leen una carpeta con un archivo SKILL.md cuyo frontmatter YAML tiene un name y una description. Claude Code usa .claude/skills/ y ~/.claude/skills/. Codex, Amp y OpenHands usan .agents/skills/ en el repo y ~/.agents/skills/ para ti. Cline usa .cline/skills/ y ~/.cline/skills/, y también lee .claude/skills/. Amp también lee .claude/skills/. Así, una skill en .agents/skills/ cubre Codex, Amp y OpenHands, y una copia en .claude/skills/ cubre Claude Code, Cline y Amp.

Esta página es una traducción de la guía en inglés. Los comandos, claves de configuración y el código no se modifican; si hay diferencias, prevalece la versión en inglés. Leer en inglés → · Otros idiomas: 简体中文 · 日本語 · 한국어 · Português (Brasil)

Entérate cuando cambie la configuración

Cuando cambie un ajuste, flag o regla de permisos de estas herramientas, te avisamos en un correo semanal (en inglés), verificado con la documentación oficial.

Respuesta rápida: ubicación de las carpetas de skills

  • Claude Code: .claude/skills/NAME/SKILL.md (proyecto) y ~/.claude/skills/NAME/SKILL.md (personal). Los plugins también incluyen skills, que se invocan como /plugin-name:skill-name.
  • OpenAI Codex: .agents/skills en la carpeta donde inicias Codex, sus carpetas superiores hasta la raíz del repo, ~/.agents/skills, /etc/codex/skills (admin) y las skills de sistema incluidas.
  • Cline: .cline/skills/ (recomendado), .clinerules/skills/ o .claude/skills/ en el proyecto, y ~/.cline/skills/ a nivel global.
  • Amp: .agents/skills/ y .claude/skills/ en el proyecto y en las carpetas superiores, ~/.config/agents/skills/, ~/.agents/skills/, ~/.config/amp/skills/, ~/.claude/skills/ y las carpetas indicadas en amp.skills.path.
  • OpenHands: .agents/skills/NAME/SKILL.md en el repo (los antiguos .openhands/skills y .openhands/microagents siguen funcionando) y ~/.agents/skills para el usuario.

Un SKILL.md que funciona en todas partes

Los cinco agentes aceptan el mismo archivo mínimo: frontmatter YAML con name y description, y después instrucciones en Markdown. Mantén el name igual al nombre de la carpeta, porque Cline y OpenHands exigen que coincidan.

.agents/skills/release-notes/SKILL.md

---
name: release-notes
description: Draft release notes from recent commits. Use when the user asks for release notes or a changelog.
---

1. Read the commits since the last tag.
2. Group changes into Features, Fixes and Other.
3. Write the notes in plain Markdown.
  • Ponlo en .agents/skills/release-notes/ para Codex, Amp y OpenHands.
  • Pon la misma carpeta en .claude/skills/ para Claude Code. Cline y Amp también leen esa carpeta.
  • Escribe la description como un disparador: qué hace la skill y cuándo usarla. Claude Code, Codex, Cline y Amp deciden si cargan una skill a partir de ese texto.

Cómo se ejecuta una skill

  • Claude Code: escribe /skill-name, o deja que Claude la cargue cuando tu petición coincida con la description. El texto después del nombre rellena $ARGUMENTS.
  • Codex: ejecuta /skills o escribe $ y el nombre de la skill, o deja que Codex la elija a partir de la description.
  • Cline: escribe / y elige la skill, o deja que Cline la cargue cuando tu petición coincida.
  • Amp: el modelo ve el name y la description de cada skill y carga el SKILL.md completo cuando se invoca la skill. Instala skills con amp skill add <source>.
  • OpenHands: añade una lista triggers al frontmatter para cargar una skill solo cuando una de esas palabras clave aparezca en un mensaje.

Evitar que el agente use una skill por su cuenta

  • Claude Code: disable-model-invocation: true en el frontmatter. Así solo tú puedes ejecutarla.
  • Codex: policy.allow_implicit_invocation: false en agents/openai.yaml. Las llamadas explícitas con $skill siguen funcionando. Para desactivar una skill por completo, añade una entrada [[skills.config]] con enabled = false a ~/.codex/config.toml.
  • Cline: desactiva la skill en la pestaña Skills del menú con el icono de balanza debajo del chat.
  • Amp: configura amp.skills.disableClaudeCodeSkills para omitir las carpetas compatibles con Claude.
  • OpenHands: usa una lista triggers para que la skill solo se cargue con palabras clave coincidentes.

Qué copia gana cuando los nombres coinciden

  • Claude Code: enterprise se impone a personal, y personal se impone a proyecto. Una skill se impone a un archivo de .claude/commands/ con el mismo nombre.
  • Codex: las skills con el mismo nombre no se fusionan; ambas aparecen en el selector.
  • Cline: una skill global se impone a una skill de proyecto con el mismo nombre.
  • Amp: gana la primera skill que encuentra en su orden de búsqueda.

Errores comunes

  • Codex limita la lista inicial de skills al 2% de la ventana de contexto (8,000 caracteres si se desconoce el tamaño) y acorta primero las descripciones cuando tienes muchas skills.
  • Cline sugiere mantener SKILL.md por debajo de 5k tokens; los metadatos de cada skill cuestan unos 100 tokens al inicio.
  • Amp no recarga las skills en un thread en ejecución cuando ejecutas amp skills list en otro lugar. Pídele a Amp que recargue tus skills.
  • Claude Code integró los comandos personalizados en las skills, así que los archivos .claude/commands/*.md siguen creando comandos /name.

Guía completa de skills para cada agente

Fuentes

Documentación oficial (en inglés) con la que se verificó esta guía. Versión en inglés revisada el: 2026-10-18

Más guías en español