DEV Community

carlosp5751258-lgtm
carlosp5751258-lgtm

Posted on

Tu primera skill de Claude Code en 10 minutos (en español)

#claudecode #ai #productivity #espanol

Las skills son la forma más sencilla de enseñarle a Claude Code a hacer una tarea siempre igual: revisar código, escribir commits, generar tests… Son simples archivos Markdown y Claude decide solo cuándo usarlas.

Dónde van 

.claude/skills/<nombre>/SKILL.md      # solo este proyecto
~/.claude/skills/<nombre>/SKILL.md    # todos tus proyectos
Enter fullscreen mode Exit fullscreen mode

Anatomía de una skill 

---
name: commits-convencionales
description: "Genera mensajes de commit siguiendo Conventional Commits a partir de los cambios en stage. Úsala cuando el usuario pida \"haz commit\" o \"mensaje de commit\"."
---

# Commits convencionales
1. Lee `git diff --staged`.
2. Elige tipo: feat, fix, refactor, docs, test, chore.
3. Formato: `tipo(ámbito): resumen en imperativo, ≤ 72 caracteres`.
4. Si el diff mezcla cambios no relacionados, propone dividirlo.
Enter fullscreen mode Exit fullscreen mode

La línea clave es description: Claude la lee para decidir si la skill aplica. Escríbela pensando en qué diría el usuario ("haz commit", "revisa mi código"), no en lo que hace internamente.

Consejos que marcan la diferencia

  • Pasos numerados y verificables. "Ejecuta los tests" es mejor que "asegúrate de que funcione".
  • Di qué NO hacer. Por ejemplo: "no hagas git add -A sin permiso".
  • Una skill, una tarea. Si crece demasiado, divídela.
  • Pruébala: pide la tarea con tus propias palabras y comprueba que se activa.

Probarla

Reinicia Claude Code y escribe: "haz commit de esto". Si la description está bien escrita, verás que Claude sigue tus pasos al pie de la letra.

¿Te sirvió? Los hooks de seguridad están gratis en GitHub. Si quieres todo listo (6 skills, 4 comandos, 5 plantillas CLAUDE.md, hooks e instalador), está el Kit Claude Code en Español: paga lo que quieras, desde 3 USD.

Top comments (0)