¿Qué son las skills de Claude Code?

Distingue una skill de CLAUDE.md y de una petición, y decide qué parte de tu trabajo con datos se repite lo bastante para volverse skill.

Curso gratis. Tu Maestro, una IA, .

Una es una receta que le escribes una sola vez a Claude Code para una tarea que repites. Por dentro es una carpeta con un archivo SKILL.md: lleva un encabezado corto que dice para qué sirve y, debajo, los pasos en tus propias palabras. Cuando le pides algo que coincide con esa descripción, Claude Code carga el archivo y sigue tus pasos. También puedes llamarla directamente escribiendo / seguido del nombre de la carpeta.

Aunque el nombre suene técnico, una skill se escribe en texto normal, igual que CLAUDE.md. Si algún procedimiento necesita además plantilla o de apoyo, puedes guardarlos en esa misma carpeta, pero el corazón de la skill son tus instrucciones en español. (Las skills también existen en la app de Claude y en ; aquí nos enfocamos en cómo funcionan dentro de Claude Code).

Con esta ya tienes tres maneras de darle instrucciones a Claude Code, y cada una cumple un papel distinto en tu carpeta:

Pieza	Qué guarda	Cuándo la lee Claude Code	Qué pasa con tu
Tu petición	La tarea o pregunta de hoy	En el momento en que la envías	Ocupa lugar solo en ese turno
CLAUDE.md	Lo que siempre es cierto en esta carpeta (reglas y datos)	Al empezar cada sesión	Se carga completo en todas las sesiones
Una skill	Los pasos de un procedimiento que repites	Cuando tu petición coincide con su descripción, o cuando escribes `/nombre`	Al iniciar solo entra su descripción; los pasos completos se cargan únicamente cuando se usan

La diferencia frente a CLAUDE.md cuida el espacio de tu sesión. Como CLAUDE.md se carga entero desde el primer saludo, si metes ahí las instrucciones de tu cierre mensual, las reglas para cruzar dos tablas y el formato de tres reportes distintos, todo eso ocupa lugar aunque hoy solo quieras hacer una pregunta rápida. De una skill, en cambio, Claude Code solo lee la descripción al principio; los pasos entran cuando la tarea los pide. Así puedes tener muchas skills listas sin saturar la sesión.

Cómo es una skill por dentro

Las skills de un proyecto viven dentro de tu carpeta de trabajo, en la ruta .claude/skills/ (como .claude empieza con un punto, el Explorador de archivos o Finder puede ocultarla si no tienes activada la vista de archivos ocultos). Cada skill tiene su propia subcarpeta y, salvo que indiques otra cosa, el nombre de esa carpeta será el comando con el que la llamas:

exoplanetas/├── CLAUDE.md├── planetas.csv└── .claude/    └── skills/        └── revisa-tabla/            └── SKILL.md

Estructura de una carpeta de proyecto con CLAUDE.md y una skill llamada revisa-tabla.

El archivo SKILL.md empieza desde la primera línea con un encabezado entre dos líneas ---. El campo recomendado ahí es description: es el texto que Claude Code lee al abrir la sesión para decidir cuándo cargar la skill. Debajo de la segunda línea --- escribes los pasos del procedimiento. La documentación recomienda mantener SKILL.md por debajo de las 500 líneas para que sea claro y ligero cuando se cargue.

Para usar una skill tienes dos caminos:

Dejar que se cargue sola: haces tu petición normal y, si coincide con description, Claude Code abre el SKILL.md y aplica los pasos.
Llamarla por su nombre: escribes /revisa-tabla en la terminal o en la app de escritorio (en la app también puedes escribir / o hacer clic en + y seleccionar Slash commands para escogerla de la lista). Si tienes una skill que hace algo delicado y prefieres que solo corra cuando tú la llames con /nombre, puedes agregar disable-model-invocation: true en el encabezado entre las líneas ---.

Si creas una skill que te sirve en todas las carpetas de tu computadora y no solo en exoplanetas, guárdala en tu carpeta personal: ~/.claude/skills/revisa-tabla/SKILL.md. Si una skill personal y una del proyecto tienen el mismo nombre, gana la personal.

Error común: Descripciones vagas que nunca activan la skill

Una skill con description: Ayuda con datos o description: Para reportes casi nunca se carga sola, porque no le dice a Claude Code en qué momento usarla. Escribe siempre qué hace y cuándo activarla: por ejemplo, Revisa una tabla antes de contar o promediar nada con ella; úsala cuando te pida analizar una tabla nueva.

Qué se vuelve skill en el trabajo con datos

Una tarea merece volverse skill cuando la haces siguiendo los mismos pasos cada semana o cada mes y te cansa volver a explicarla desde cero:

revisar una tabla recién descargada antes de calcular nada: cuántas filas trae, qué representa una fila, cuántas celdas vacías hay y una muestra de filas;
armar el reporte periódico: qué archivo entra, qué registros se descartan, cómo se agrupa y en qué formato se entrega;
dos fuentes que deberían dar el mismo total, como facturación contra depósitos bancarios;
preparar un libro de Excel para dirección con una hoja de resumen y fórmulas vivas a la vista.

Mira cómo se reparte el trabajo entre CLAUDE.md, una skill y tu petición del día en un caso real de oficina:

Separar reglas fijas, una skill y la petición del día

Ejemplo resuelto · 3 pasos

Trabajas en una carpeta con el archivo facturas.csv. Sabes tres cosas:

En facturas.csv cada fila es una línea de producto (una misma factura puede ocupar varias filas), los montos vienen sin IVA y las facturas canceladas tienen estatus = "Cancelada".
Todos los viernes cruzas facturas.csv contra depositos_banco.csv: filtras las canceladas, sumas por fecha de cobro, comparas los totales diarios y guardas las diferencias en un Excel nuevo con fórmulas.
Hoy es martes y solo quieres saber cuántas facturas distintas se emitieron ayer.

¿Qué pones en CLAUDE.md, qué guardas en una skill y qué escribes hoy en tu petición?

Piensa el siguiente paso por tu cuenta y luego ábrelo para comparar.

En la siguiente página vas a construir tu primera skill para revisar tablas en la carpeta exoplanetas. Si tienes una tarea del trabajo que se repite y quieres saber si conviene volverla skill, cuéntale a tu Maestro.

Inténtalo

Piensa en una tarea con tablas que repitas en tu trabajo cada semana o cada mes. Escribe en un papel o en un archivo de notas dos líneas: cómo llamarías la carpeta dentro de .claude/skills/ y qué pondrías en su description. Comprueba que tu descripción diga tanto qué hace la skill como en qué situación debe cargarse. Si quieres revisar cómo quedó tu descripción, pégasela a tu Maestro.

Después contesta esta pregunta:

Comprueba lo que sabes: Cada mes armas el mismo reporte de ventas: llega un archivo, quitas las canceladas, sumas por sucursal y entregas un Excel con fórmulas. ¿Dónde pones esos pasos?