Skills en Claude Code - Erixcel Dev Notes

Las Skills en Claude Code son paquetes de instrucciones (y opcionalmente scripts o recursos) que extienden lo que Claude sabe hacer. Se cargan solo cuando Claude las necesita, así no consumen contexto de más. Cada skill es una carpeta con un archivo SKILL.md. Claude las descubre automáticamente y las usa cuando el contexto de tu tarea coincide con su descripción, o puedes invocarlas manualmente con /nombre-skill.

Skills incluidas (bundled)

Claude Code trae skills listas para usar como /doctor, /code-review, /debug, /verify, /run, /batch y /loop. Se invocan escribiendo / seguido del nombre.

Terminal

/doctor          # Diagnóstico de la instalación
/code-review     # Revisión de código
/verify          # Verificar que un cambio funciona

Para desactivarlas: agrega disableBundledSkills: true a la configuración.

Dónde viven las skills

Ubicación	Alcance
`~/.claude/skills/<nombre>/`	Personal (todos los proyectos)
`.claude/skills/<nombre>/`	Del proyecto actual

Las personales van en tu home y funcionan en cualquier repo. Las del proyecto viven en .claude/skills/ dentro del repositorio y se comparten con el equipo si las commiteas.

Crear tu primera skill

Crear la carpeta

Terminal

mkdir -p ~/.claude/skills/resumir-cambios

Escribir SKILL.md

Crea el archivo ~/.claude/skills/resumir-cambios/SKILL.md:

SKILL.md

---
name: resumir-cambios
description: Resume los cambios sin commitear del repositorio actual y marca los que sean riesgosos. Úsalo cuando el usuario pregunte "qué cambié" o pida un resumen del diff.
---

# Resumir cambios

Cuando el usuario invoque esta skill:

1. Ejecuta `git status` y `git diff` para inspeccionar los cambios.
2. Agrupa los cambios por área (features, fixes, refactors, docs).
3. Marca con ⚠️ cualquier cambio en archivos de configuración, secretos o migraciones.
4. Devuelve el resumen en formato de lista.

Usarla

Abre Claude Code en cualquier proyecto y escribe:

Terminal

/resumir-cambios

Claude también la puede invocar automáticamente si preguntas “resumime los cambios”.

Estructura completa de una skill

~/.claude/skills/mi-skill/
├── SKILL.md              # Requerido: instrucciones + metadata
├── scripts/              # Opcional: código ejecutable
├── references/           # Opcional: documentación extra
└── assets/               # Opcional: plantillas, imágenes

Frontmatter de SKILL.md

SKILL.md

---
name: mi-skill
description: Qué hace y cuándo debe usarse. Sé específico para que Claude sepa cuándo invocarla.
---

La description es lo que Claude lee para decidir si la skill aplica a tu tarea. Sé claro y usa palabras clave del dominio.

Skill con scripts

Si necesitas ejecutar código real:

SKILL.md

---
name: analizar-csv
description: Analiza archivos CSV y genera estadísticas y gráficos.
dependencies: python>=3.8, pandas, matplotlib
---

# Analizar CSV

1. Pídele al usuario la ruta del CSV.
2. Ejecuta `scripts/analyze.py <ruta>`.
3. Muestra el resumen y los gráficos generados.

Recargar skills sin reiniciar

Terminal

/reload-plugins

Convertir una skill en plugin

Cuando quieras compartirla con tu equipo, empaquétala como plugin agregando .claude-plugin/plugin.json:

plugin.json

{
  "name": "mi-plugin",
  "description": "Skills útiles para el equipo",
  "version": "1.0.0"
}

Los skills de un plugin se invocan namespaced: /mi-plugin:nombre-skill.

Recursos

Documentación oficial de Skills

Skills en Claude Code

Ejemplos oficiales

Skills de ejemplo de Anthropic

​Skills incluidas (bundled)

​Dónde viven las skills

​Crear tu primera skill

​Estructura completa de una skill

​Frontmatter de SKILL.md

​Skill con scripts

​Recargar skills sin reiniciar

​Convertir una skill en plugin

​Recursos

Documentación oficial de Skills

Ejemplos oficiales

Skills incluidas (bundled)

Dónde viven las skills

Crear tu primera skill

Estructura completa de una skill

Frontmatter de SKILL.md

Skill con scripts

Recargar skills sin reiniciar

Convertir una skill en plugin

Recursos