Claude Code 技能教學：10 分鐘建立第一個技能（西班牙語）
Tu primera skill de Claude Code en 10 minutos (en español)
Claude Code 技能以 Markdown 檔案建立，可放在 `.claude/skills/<nombre>/SKILL.md` 供單一專案使用，或放在 `~/.claude/skills/<nombre>/SKILL.md` 供所有專案使用。
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
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.
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 -Asin 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 1 USD.
來源：DEV Community · dev.to