Claude Code es donde nacieron las skills, y sigue siendo donde más se les saca partido: allí las skills pueden ejecutar scripts con acceso total a la red, recibir argumentos, ejecutarse en su propio subagente y reemplazar los comandos slash personalizados que ya tengas. Esta guía cubre específicamente el lado de Claude Code. Para el formato en general y de dónde vienen las skills, consulta Claude skills y agent skills.
Leímos la documentación y la referencia de comandos de Claude Code el 14 de noviembre de 2026. La lista que aparece encima de esta guía incluye todas las skills del catálogo de HostedMCP con el comando para instalarlas en Claude Code.
Dónde busca Claude Code
| Ámbito | Carpeta | Quién lo recibe |
|---|---|---|
| Personal | ~/.claude/skills/<name>/SKILL.md |
Tú, en todos los proyectos |
| Proyecto | .claude/skills/<name>/SKILL.md |
Todos los que clonen el repositorio |
| Anidado | <subfolder>/.claude/skills/<name>/SKILL.md |
Trabajo en esa parte de un monorepo |
| Plugin | <plugin>/skills/<name>/SKILL.md |
Cualquiera que tenga el plugin, como /plugin:name |
| Organización | La carpeta de ajustes administrados | Todos los que estén bajo esa política |
Si dos skills comparten nombre, gana el de la organización sobre el tuyo, y el tuyo sobre el del proyecto. Los skills que habilitas en claude.ai se sincronizan en ~/.claude/skills/synced/.
Crea una
mkdir -p .claude/skills/release-notes
Luego escribe .claude/skills/release-notes/SKILL.md:
---
name: release-notes
description: Write release notes from merged pull requests. Use when the user asks for release notes, a changelog entry or a summary of what shipped.
---
1. List pull requests merged since the last tag with `gh pr list --state merged`.
2. Group them under Added, Changed and Fixed.
3. Write one plain sentence per change, for users rather than developers.
Esa es una skill funcional. Claude Code la detecta sin reiniciar. Pide las notas de la versión y la usará, o escribe /release-notes.
Mantén SKILL.md por debajo de 500 líneas y mueve el material extenso a archivos junto a él a los que apunten las instrucciones. El plugin skill-creator de Anthropic, /plugin install skill-creator@claude-plugins-official, puede probar una skill con y sin ella cargada y ajustar su descripción.
Invocarlo
| Frontmatter | Puedes escribir /name |
Claude lo usa por su cuenta | Descripción en el contexto |
|---|---|---|---|
| Predeterminado | Sí | Sí | Siempre |
disable-model-invocation: true |
Sí | No | No |
user-invocable: false |
No | Sí | Siempre |
/name solo funciona al inicio de un mensaje, y se pueden encadenar hasta seis. Las skills aceptan argumentos: $ARGUMENTS en el cuerpo se convierte en lo que escribas después del nombre, y argument-hint muestra una pista en el menú.
Otros campos que Claude Code añade al estándar: when_to_use para una descripción de activación aparte, model y effort para ejecutar una skill con otro modelo u otro nivel de esfuerzo, allowed-tools y disallowed-tools, y context: fork para ejecutar la skill en un subagente y que su trabajo no llene tu conversación principal.
Los comandos de barra personalizados se han fusionado con las skills. .claude/commands/deploy.md y .claude/skills/deploy/SKILL.md crean ambos /deploy, y los archivos de comandos antiguos siguen funcionando.
Las skills que vienen con Claude Code
La referencia de comandos de Claude Code marca 20 comandos como skills. Estas son las que más vas a encontrar:
| Skill | Qué hace |
|---|---|
/code-review |
Revisa un diff, una rama o un pull request en busca de bugs con el nivel de esfuerzo que elijas, y puede corregir o comentar |
/simplify |
Cuatro agentes de revisión buscan problemas de reutilización, simplificación, eficiencia y abstracción, y luego aplican las correcciones |
/batch |
Divide un cambio grande en 5 a 30 unidades y ejecuta un agente en segundo plano por unidad |
/debug |
Activa el registro de depuración para la sesión y lee el log |
/loop |
Vuelve a ejecutar un prompt a intervalos, o se autorregula |
/run y /verify |
Inician la app y comprueban que un cambio funciona de verdad |
/doctor |
Revisa la instalación, la configuración, las extensiones y CLAUDE.md |
/fewer-permission-prompts |
Convierte los comandos de solo lectura que apruebas a menudo en una lista de permitidos |
/update-config |
Edita settings.json a partir de una descripción en lenguaje natural |
/claude-api |
Carga la referencia actual de la API y el SDK de Claude |
/dataviz |
Guía para gráficos y dashboards con un validador de paletas |
/init, que escribe un CLAUDE.md para un proyecto nuevo, es un comando integrado y no una skill, y /review es un alias de /code-review. Claude Code no incluye las skills de documentos de Anthropic para Word, PDF, PowerPoint y Excel; instálalas desde el repositorio anthropics/skills.
Cuánto cuestan las skills
Cada skill que Claude puede invocar por su cuenta coloca su descripción en el contexto en cada turno. Claude Code limita esto de dos maneras:
- Cada descripción, junto con
when_to_use, se recorta a 1.536 caracteres en el listado. - Todas las descripciones juntas comparten un presupuesto de aproximadamente el 1% de la ventana de contexto del modelo. Si se supera, Claude Code descarta las descripciones empezando por las skills menos usadas y conserva solo sus nombres.
Una vez usada, el contenido de una skill permanece en la conversación. Tras una compactación automática, se vuelve a adjuntar el uso más reciente de cada skill, hasta 5.000 tokens por skill y 25.000 en total.
/skills lista tus skills y puede ordenarlas por coste en tokens; /skill-doctor informa el coste de contexto de cada skill y con qué frecuencia se usa. Una skill que solo invocas a mano debería tener disable-model-invocation: true, lo que elimina su descripción del contexto por completo.
Skill, hook, subagent, MCP o plugin
| Quieres | Usa | Por qué |
|---|---|---|
| Hechos que Claude necesita en cada sesión | CLAUDE.md | Se carga siempre; mantenlo por debajo de 200 líneas |
| Conocimientos para algunas tareas | Un skill | Se carga solo cuando es relevante |
| Que algo ocurra siempre | Un hook | Determinista, sin coste de contexto; "pon las barandillas de seguridad en los hooks" |
| Mantener el trabajo pesado fuera de tu contexto | Un subagent | Contexto aparte, devuelve un resumen |
| Herramientas o datos de otro sistema | Un MCP server | Un skill puede enseñarle a Claude cómo usarlo |
| Todo lo anterior para un equipo | Un plugin | Los empaqueta como una sola instalación |
La combinación que más documenta Anthropic es un skill junto con un MCP server: el server aporta las herramientas y el skill aporta el criterio sobre cuándo y cómo usarlas.
Seguridad
Las skills de Claude Code pueden ejecutar cualquier script con los permisos de tu usuario y acceso total a la red. Lee los scripts de cualquier skill que no hayas escrito tú. allowed-tools permite que una skill use herramientas sin preguntarte; no restringe nada. En un proyecto, revisa .claude/skills/ en los pull requests igual que revisarías código. Las organizaciones pueden restringir esto con ajustes gestionados, incluido permitir solo skills de marketplaces de plugins aprobados.
Cuando no funciona
| Lo que ves | Causa | Solución |
|---|---|---|
| Claude ignora la skill | La descripción no coincide con tus palabras | Reescríbela; añade when_to_use |
No se encuentra /name |
El nombre de la carpeta y name no coinciden, o hay una carpeta nueva de nivel superior |
Haz que coincidan; ejecuta /reload-skills |
| Una skill de plugin tiene un nombre distinto | Las skills de plugin usan espacios de nombres | Escribe /plugin:name |
| Algunas skills perdieron sus descripciones | Se superó el presupuesto del listado | Elimina las skills que no uses o define disable-model-invocation: true |
| Tu skill queda oculta | Hay una skill de organización o personal con el mismo nombre | Cambia el nombre de la tuya |