Patrones y buenas prácticas para Skills
Patrones comunes, antipatrones y hábitos de quienes crean grandes skills
⏱ Estim. ~8 min
01 · Leer
Ahora que sabes cómo funcionan los skills, veamos los patrones que los desarrolladores usan a diario.
Los skills más populares caen en algunas categorías: - Estilo de código — imponer convenciones de nombres, reglas de formato, patrones de estructura - Revisión de código — listas consistentes para revisar PRs y cambios de código - Mensajes de commit — imponer formatos como Conventional Commits - Tests — coincidir con el framework y los patrones de tests de tu proyecto - Documentación — estandarizar cómo se escriben docs, comentarios y READMEs
Cada patrón sigue la misma estructura: reglas claras, ejemplos específicos, formato de salida explícito. Veamos los dos más útiles.
Puntos clave
- Los skills de estilo imponen convenciones de nombres, formato y estructura
- Los skills de revisión dan listas consistentes para revisar código
- Los skills de mensajes de commit imponen formatos como Conventional Commits
- Los skills de tests coinciden con los patrones de tests que ya tiene tu proyecto
- Los skills de documentación estandarizan cómo se escribe la documentación
02 · Ejemplo de código
Aquí tienes un skill que obliga a que todos los mensajes de commit usen el formato Conventional Commits.
commit-style/SKILL.md
---
name: Commit Message Style
description: Enforces Conventional Commits format
instructions: Use when creating git commits
---
## Format
All commits must follow Conventional Commits:
```
<type>(<scope>): <description>
[optional body]
```
## Types
- `feat`: New feature
- `fix`: Bug fix
- `docs`: Documentation only
- `refactor`: Code change that neither fixes nor adds
- `test`: Adding or updating tests
- `chore`: Maintenance (dependencies, CI, build)
## Rules
- Description must be lowercase, no period at the end
- Scope is optional but encouraged
- Body should explain WHY, not WHAT (the diff shows what)
- Max 72 characters for the first line
## Examples
Good: `feat(auth): add password reset flow`
Good: `fix(api): handle null response from payment gateway`
Bad: `Fixed stuff`
Bad: `Update code`
Fíjate qué tan explícito es: formato exacto, tipos enumerados, límite de caracteres, ejemplos buenos y malos. Cuanto más explícitas sean tus reglas, más consistentes serán los commits de Claude. Instrucciones vagas como "escribe buenos mensajes de commit" no funcionan.
03 · Ejemplo de código
Aquí tienes un skill que le dice a Claude que coincida con las convenciones de tests que ya tiene tu proyecto.
test-writer/SKILL.md
---
name: Test Writer
description: Writes tests matching project conventions
instructions: Use when writing or updating tests
---
## Conventions
- Use `describe` / `it` blocks (not `test`)
- Test file goes next to source: `Foo.ts` → `Foo.test.ts`
- Use `vi.fn()` for mocks (Vitest, not Jest)
- Arrange-Act-Assert pattern in every test
## What To Test
- Happy path first
- Error cases and edge cases
- Boundary values (0, 1, -1, empty string, null)
- Never test implementation details — test behavior
## Naming
`it('should return 404 when user not found')`
Not: `it('test user')`
Este skill hace referencia al framework de tests específico del proyecto (Vitest) y a sus patrones (describe/it, vi.fn). La instrucción genérica "escribe buenos tests" no sirve: Claude ya lo intenta. Este skill le dice tus convenciones específicas.
04 · Quiz
Recuerda: un skill debe añadir reglas que Claude no sabría por sí solo. ¿Cuál de estas instrucciones es lo bastante explícita como para cambiar de verdad el comportamiento de Claude?
- Sé un asistente útil que escribe buen código
- Al escribir endpoints de API, devuelve JSON con claves en camelCase, usa URLs en kebab-case y los códigos de error de nuestro archivo error-codes.ts
- Usa siempre buenas prácticas al programar
- Programa como un ingeniero senior
05 · Clasificar arrastrando
Piensa qué hace la mayor diferencia en la calidad de un skill. Un skill vago sin ejemplos es peor que uno específico — ordena estas prácticas de mayor a menor impacto.
(Esta sección es interactiva — activa JavaScript para usarla.)
06 · Leer
Algunos skills hacen que Claude funcione peor. Estos son los que hay que evitar:
Demasiado vago: "Escribe código limpio y bueno". Claude ya lo intenta. Tu skill debe añadir reglas específicas que Claude no sabría por sí solo.
Demasiado largo: un skill de 500 líneas con reglas para cada escenario posible satura el contexto de Claude. Mantén los skills enfocados en un solo flujo. Varios skills enfocados ganan a uno gigante.
Duplicar comportamiento integrado: Claude ya formatea código, escribe markdown y usa git. No gastes espacio del skill en cosas que Claude ya hace bien por defecto.
Reglas contradictorias: "siempre añade comentarios" + "mantén el código mínimo" genera confusión. Antes de probar, revisa que tus reglas no se contradigan entre sí.
Puntos clave
- No escribas skills vagos — sé explícito o no lo escribas
- No escribas skills gigantes — un skill, un flujo enfocado
- No dupliques lo que Claude ya hace bien por defecto
- Revisa que tu skill no tenga reglas contradictorias
07 · Leer
Ahora tienes un superpoder que la mayoría de usuarios de Claude Code no conocen: la capacidad de enseñarle a Claude exactamente cómo trabajas tú.
Cada equipo tiene convenciones. Cada desarrollador tiene preferencias. Los Skills convierten esas reglas no escritas en instrucciones permanentes, compartibles y versionadas.
Empieza pequeño. Toma la cosa que le repites más a Claude y conviértela en un skill. Pruébalo, ajústalo, haz commit. Luego agrega otro. Con el tiempo, tu colección de skills se vuelve un multiplicador de fuerza — cada skill que escribes hace que Claude sea más bueno en tu trabajo específico.
¿La diferencia entre un asistente de IA genérico y un flujo de IA personalizado? Los Skills.
Puntos clave
- Empieza con un skill para la instrucción que más repites
- Itera: prueba, ajusta, haz commit
- Comparte skills de proyecto vía git, todo el equipo se beneficia
- Acumula la colección con el tiempo — cada skill hace que Claude sea más inteligente en tu trabajo
- Los Skills son la diferencia entre un asistente de IA genérico y un flujo de IA personalizado
08 · Quiz
Escribiste un skill que dice "escribe código limpio y bueno". Después de probarlo, la salida de Claude se ve igual que antes. ¿Por qué?
- El archivo SKILL.md tiene un error de sintaxis
- Los skills solo funcionan con el modelo Opus
- La instrucción es demasiado vaga — Claude ya intenta escribir buen código
- Hay que reiniciar Claude Code después de agregar un skill
09 · Completar
Un skill de 500 líneas que cubre todos los escenarios posibles es un antipatrón. Deberías escribir varios skills _____, cada uno enfocado en un flujo de trabajo.
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.