Crea tu primera skill de Claude Code

Una skill es un archivo SKILL.md que le enseña a Claude Code a hacer una tarea a tu manera. Claude la carga sola cuando lo que pides coincide con su description, o la llamas tú con /nombre-de-la-skill.

1. Elige una tarea que repites

Propuestas, reportes, revisiones de código, posts. Si cada vez le explicas lo mismo a la IA, esa tarea merece una skill.

2. Crea la carpeta

En tu carpeta personal sirve para todos tus proyectos. Dentro de un proyecto sirve solo ahí y la puedes subir al repositorio para tu equipo.

mkdir -p ~/.claude/skills/mi-skill        # todos tus proyectos
mkdir -p .claude/skills/mi-skill          # solo este proyecto

3. Escribe el SKILL.md

Arriba van name y description. La description dice qué hace y cuándo usarla: es lo que Claude lee para decidir si la activa. Abajo van tus instrucciones.

---
name: mi-skill
description: "Usar cuando pida una propuesta comercial. Arma la propuesta con el formato de mi empresa."
---

## Reglas
- ...

## Pasos
1. ...

4. Pruébala

Abre Claude Code y pide la tarea con las palabras que pusiste en la description, o escribe /mi-skill. Si no se activa sola, mejora la description con las palabras que tú usas al pedirla.

5. Mejórala con el uso

Cada vez que corrijas a Claude, convierte esa corrección en una regla de la skill. Puedes poner plantillas y ejemplos en la misma carpeta y nombrarlos en el SKILL.md para que los lea cuando los necesite.

Atajo: que Claude te ayude a crearla

Instala skill-creator desde el marketplace oficial y pídele que cree o revise tus skills.

/plugin marketplace add anthropics/claude-plugins-official
/plugin install skill-creator@claude-plugins-official

Plantilla para copiar

Guárdala como SKILL.md dentro de la carpeta de tu skill y cambia mi-skill por un nombre corto, en minúsculas y con guiones.

---
name: mi-skill
description: "Usar cuando pida <la tarea, con las palabras que usas al pedirla>. <Qué hace la skill en una frase>."
---

## Cuándo usarla

- Cuando pida <tarea 1>.
- Cuando pida <tarea 2>.
- No usarla para <lo que no cubre>.

## Reglas que no se rompen

- Lee primero <archivo o carpeta con el contexto>.
- Usa siempre <formato, tono, idioma o estilo>.
- Nunca <lo que nunca debe hacer>.
- Si falta un dato, pregunta una sola cosa antes de seguir.

## Decisiones

| Si... | Entonces... |
|---|---|
| <caso A> | <qué hacer> |
| <caso B> | <qué hacer> |

## Pasos

1. <Primer paso concreto>.
2. <Segundo paso>.
3. Revisa el resultado contra las reglas antes de entregarlo.

## Qué entregar

- <El archivo, texto o formato final>.
- Un resumen corto de qué hiciste y qué falta.

## Referencias

- `ejemplo.md`: un ejemplo bueno de cómo debe quedar (guárdalo en esta misma carpeta).

Tres consejos

• Una skill por tarea. Si hace dos cosas distintas, son dos skills.
• Escribe órdenes, no explicaciones: "Revisa X", "Nunca hagas Y".
• Mantenla corta. Lo largo va en archivos aparte dentro de la carpeta.

Fuente: documentación oficial de skills en Claude Code.