Probar y distribuir Skills
Itera tus skills y compártelos con tu equipo
⏱ Estim. ~6 min
01 · Leer
Escribir un skill es solo la mitad del trabajo. Necesitas probarlo — e iterar.
Un skill que se ve bien sobre el papel puede dar resultados inconsistentes en uso real. Quizá Claude siga 4 de tus 5 reglas y se salte una. Quizá interprete una instrucción ambigua distinto de lo que tú pensaste.
El ciclo de pruebas es simple: activa el skill, dale a Claude una tarea que lo dispare, revisa si la salida cumple tus reglas y, si no, ajusta el skill.
Igual que con el código, los skills mejoran iterando. La mayoría de skills necesitan 2-3 rondas de ajustes antes de funcionar de forma consistente.
Puntos clave
- Prueba un skill activándolo con /skill y dándole a Claude una tarea relevante
- Revisa la salida contra cada regla del cuerpo del skill
- Prueba casos límite: ¿qué pasa con entradas inusuales?
- Itera: la mayoría de skills necesitan 2-3 rondas de ajustes
- Versiona los skills con git — son archivos
02 · Paso a paso
Sigue este flujo cada vez que crees o actualices un skill.
1. Crea o actualiza el skill
Escribe o edita tu archivo SKILL.md. Guárdalo en .claude/skills/your-skill/SKILL.md. Si es una actualización, cambia un lugar a la vez para ver el efecto.
2. Actívalo con /skill
En una conversación de Claude Code, escribe /skill y selecciona tu skill de la lista. Claude ahora carga tus instrucciones y las sigue durante el resto de la conversación.
3. Dale a Claude una tarea relevante
Pídele a Claude que haga algo que dispare las reglas de tu skill. Un skill de code review: pídele que revise código. Un skill de mensajes de commit: pídele que haga commit. Usa entradas reales, no ejemplos de juguete.
4. Revisa la salida
¿La salida cumple cada regla de tu skill? Repasa cada punto, cada requisito de formato, cada restricción. Sé minucioso: un cumplimiento parcial significa que el skill necesita ajustes.
5. Ajusta y repite
Si algo no encaja, actualiza el cuerpo del skill. Sé más explícito donde Claude se desvió. Agrega ejemplos de la salida correcta. Elimina frases ambiguas. Luego prueba con la misma tarea otra vez.
6. Haz commit con git
Una vez que el skill funcione de forma consistente en varios casos de prueba, haz commit. Los skills son archivos — pertenecen al control de versiones como cualquier otra cosa. git add .claude/skills/ && git commit -m 'feat: add code-reviewer skill'
03 · Leer
Una vez que tu skill funciona de forma consistente, decide dónde guardarlo. En la primera lección aprendiste que hay dos ubicaciones: los skills de proyecto (.claude/skills/) se hacen commit a git y se comparten con el equipo, y los skills de usuario (~/.claude/skills/) son personales y aplican a todos tus proyectos.
La regla es simple: si es una convención del equipo, hazlo commit como skill de proyecto. Si es una preferencia personal, guárdalo como skill de usuario.
Puntos clave
- Skills de proyecto: commit a git → todo el equipo se beneficia
- Skills de usuario: se quedan en local → solo tus preferencias
- Haz commit de los skills de proyecto como cualquier otro cambio de código
04 · Quiz
Acabas de crear un skill que aplica el formato de mensajes de commit del equipo: cada commit debe empezar con un prefijo de tipo como 'feat:' o 'fix:'. ¿Debe ser un skill de proyecto o de usuario?
- Skill de proyecto — es una convención del equipo, commit a git
- Skill de usuario — se queda en ~/.claude/skills/ para uso personal
- Cualquiera de los dos sirve
- Debería estar en un archivo de configuración, no en un skill
05 · Completar
Los skills guardados en ~/.claude/skills/ se llaman skills de _____, porque te acompañan en todos tus proyectos.
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.