comunidad bóvedacrea claude skills

Crea Claude Skills

aprende a crear tus propios Skills para Claude Code desde cero — estructura, buenas prácticas y ejemplos listos para copiar y usar.

Qué es un Skill

un Skill es como un superpoder que le das a Claude. es una carpeta con instrucciones que Claude carga automáticamente cuando las necesita — funciona en Claude Code, la API, claude.ai y el Agent SDK.

en su forma más simple, un Skill es un archivo SKILL.md con metadata YAML y un bloque de instrucciones en lenguaje natural.

Anatomía de un Skill

todo Skill necesita un archivo SKILL.md con este formato:

---
name: mi-skill
description: Describe qué hace este skill en tercera persona
version: 1.0.0
---

# Instrucciones

Aquí van las instrucciones en lenguaje natural
que Claude seguirá cuando active este skill.

Estructura de carpeta

mi-skill/
├── SKILL.md          # obligatorio
├── REFERENCE.md      # opcional — contexto extra
└── scripts/          # opcional — scripts auxiliares
    └── lint.sh

Crea tu primer Skill paso a paso

1. Crea el directorio

mkdir -p mi-skill

2. Crea SKILL.md con frontmatter

cat > mi-skill/SKILL.md << 'EOF'
---
name: mi-skill
description: Genera resúmenes concisos de archivos de código
version: 1.0.0
---

# Instrucciones

Cuando el usuario pida un resumen de código:
1. Lee el archivo indicado
2. Identifica la función principal
3. Resume en 2-3 oraciones qué hace y cómo
EOF

3. (Opcional) Agrega archivos de referencia

echo '# Contexto adicional\n\nReglas de estilo del proyecto...' > mi-skill/REFERENCE.md

4. Coloca el Skill donde necesites

Personal (global)

~/.claude/skills/mi-skill/

disponible en todos tus proyectos.

Por proyecto

.claude/skills/mi-skill/

solo aplica a este repo. se comparte con el equipo vía git.

Los 3 niveles de carga

Claude usa un sistema de carga progresiva para no saturar el contexto:

1. Metadata

Claude lee solo el nombre y descripción del YAML. así decide si el skill es relevante.

2. Instrucciones

si es relevante, carga el cuerpo completo del SKILL.md con todas las instrucciones.

3. Recursos

solo si necesita más contexto, lee REFERENCE.md y archivos auxiliares.

la carga progresiva mantiene el contexto limpio — escribe descripciones claras para que Claude active solo los skills que necesita.

Buenas prácticas

mantén SKILL.md por debajo de 500 líneas — si crece, divide en skills más pequeños.
escribe la descripción en tercera persona: "Genera tests unitarios..." no "Genero tests..."
usa nombres en gerundio cuando sea natural: code-reviewing, api-documenting.
prueba el skill en diferentes modelos (Opus, Sonnet, Haiku) para verificar compatibilidad.
incluye un loop de feedback: pide al usuario confirmar antes de acciones destructivas.
usa instrucciones concretas y específicas — evita frases vagas como "haz lo mejor posible".

Qué NO hacer

nombres vagos como helper o utils — sé específico.
rutas hardcodeadas de Windows (C:\Users\...) — usa rutas relativas.
demasiadas opciones en un solo skill — divide responsabilidades.
referencias circulares entre skills — mantén dependencias lineales.
archivos gigantes en REFERENCE.md — solo incluye lo necesario.

Ejemplo completo

un skill de code review listo para usar — cópialo y modifícalo a tu gusto:

---
name: code-reviewer
description: Revisa código buscando bugs, seguridad y mejoras de rendimiento
version: 1.0.0
---

# Code Reviewer

Cuando el usuario pida una revisión de código:

1. Lee los archivos indicados o los cambios staged en git
2. Analiza en este orden:
   - Bugs potenciales y errores lógicos
   - Vulnerabilidades de seguridad (OWASP top 10)
   - Problemas de rendimiento
   - Legibilidad y mantenibilidad
3. Presenta hallazgos agrupados por severidad:
   - 🔴 Crítico — debe corregirse antes de merge
   - 🟡 Advertencia — recomendado corregir
   - 🟢 Sugerencia — mejora opcional
4. Para cada hallazgo incluye:
   - Archivo y línea
   - Descripción del problema
   - Código sugerido de corrección
5. Al final, da un veredicto: aprobar, aprobar con cambios,
   o solicitar cambios

tip: copia este ejemplo, cambia el nombre y las instrucciones, y tendrás tu propio skill personalizado en segundos.

Dónde funcionan

los Skills funcionan en todo el ecosistema de Claude:

Claude Code

coloca el skill en .claude/skills/ y se activa automáticamente.

API

pasa skills vía container.skills en la request con el header beta.

claude.ai

sube tu skill como proyecto y se aplica a todas las conversaciones del proyecto.

Agent SDK

integra skills programáticamente en agentes custom con el SDK de Claude.

Guía completa

descarga la guía en markdown con templates, más ejemplos y troubleshooting.

abrir guía completa (markdown)

Links oficiales

tip

empieza con un skill simple, pruébalo, y luego itera. los mejores skills nacen de resolver un problema real que enfrentas todos los días al programar.