Crea tu primer Skill
Planifica, escribe y organiza un archivo SKILL.md
⏱ Estim. ~7 min
01 · Leer
Antes de escribir una sola línea, necesitas identificar un flujo de trabajo repetible.
Piensa en lo que le repites a Claude Code: "usa componentes funcionales", "escribe los tests primero", "usa Conventional Commits", "no agregues comentarios para código obvio".
Cada uno es candidato a ser un skill. Los mejores skills capturan flujos que sigues cada vez — no peticiones puntuales.
Pregúntate: "¿Qué instrucción le doy a Claude Code al menos una vez por semana?" Ese es tu primer skill.
Puntos clave
- Los buenos skills capturan flujos repetibles, no tareas únicas
- Piensa en las instrucciones que escribes en cada sesión de Claude Code
- Empieza con un flujo concreto, no con todos a la vez
- Un skill debe tomar postura — reglas claras, no sugerencias vagas
02 · Ejemplo de código
Cada SKILL.md empieza con frontmatter YAML entre líneas ---. Aquí están los tres campos principales.
Frontmatter YAML
---
name: Code Reviewer
description: Reviews code for bugs, style, and best practices
instructions: Use this skill when reviewing pull requests or code changes
---
name es el nombre que aparece en la lista de /skill. description le dice a Claude (y a ti) qué hace este skill. instructions le da a Claude una pista sobre cuándo activar este skill. Los tres son opcionales, pero se recomienda mucho rellenarlos todos.
03 · Quiz
Acabas de ver los tres campos estándar del frontmatter YAML. ¿Cuál de estos no lo es?
- name
- description
- language
- instructions
04 · Paso a paso
Vamos a crear un skill real paso a paso. Haremos un skill "Code Reviewer" que aplique los estándares de revisión de tu equipo.
1. Crea la carpeta del skill
Crea la estructura de directorios dentro de tu proyecto. Ejecuta: mkdir -p .claude/skills/code-reviewer. El flag -p crea los directorios padres si no existen. Esto coloca el skill dentro de tu proyecto, listo para hacer commit a git.
2. Escribe el frontmatter YAML
Abre .claude/skills/code-reviewer/SKILL.md y agrega el bloque de metadatos. Empieza con una línea ---, añade los campos name, description, instructions, y termina con otra línea ---.
3. Agrega el cuerpo de las instrucciones
Debajo del --- final, escribe tus reglas de revisión en lenguaje natural. Usa encabezados markdown para organizar secciones y listas para reglas específicas. Sé explícito: "verifica inyección SQL en entradas de usuario" es mucho mejor que "revisa el código".
4. Prueba con /skill
En una conversación de Claude Code, escribe /skill y verifica que tu nuevo skill aparezca en la lista. Selecciónalo para activarlo. Ahora pídele a Claude que revise algo de código: debe seguir tus reglas. Si no, ajusta y vuelve a probar.
05 · Ejemplo de código
Aquí está el skill "Code Reviewer" terminado — un SKILL.md completo y listo para producción.
code-reviewer/SKILL.md
---
name: Code Reviewer
description: Reviews code changes for bugs, security, and style
instructions: Use when asked to review code, PRs, or diffs
---
## Review Checklist
When reviewing code, check for:
- **Security**: SQL injection, XSS, command injection, hardcoded secrets
- **Error handling**: Are errors caught? Are they logged? Do they fail gracefully?
- **Edge cases**: What happens with empty input? Null values? Very large data?
- **Naming**: Are variables and functions named clearly?
- **Tests**: Are there tests for the new code? Do existing tests still pass?
## Output Format
Structure your review as:
1. **Summary** — one sentence overview
2. **Issues** — bullet list, severity (high/medium/low)
3. **Suggestions** — optional improvements (not blockers)
El cuerpo usa markdown estándar: encabezados, negrita, listas. Claude lo trata como instrucciones a seguir. La lista de revisión le dice a Claude qué mirar; el formato de salida garantiza que cada revisión sea consistente y estructurada.
06 · Completar
El frontmatter YAML en un archivo SKILL.md va envuelto por dos líneas de _____
07 · Clasificar arrastrando
Un archivo SKILL.md tiene una estructura específica. Piensa en lo que Claude lee primero cuando carga un skill y ordena estas partes de arriba abajo.
(Esta sección es interactiva — activa JavaScript para usarla.)
Otras lecciones de este capítulo
⚠ La experiencia interactiva completa necesita JavaScript. Actívalo y vuelve a cargar la página.
※ Este es un proyecto educativo independiente — no es un producto oficial de Anthropic. Claude™ es una marca registrada de Anthropic, PBC.