Qué es una skill, los 3 niveles donde viven (Claude.ai, Code, Cowork), cómo subir tu primera en 4 clics, cómo combinarlas con conectores MCP. Versión simplificada de la guía oficial de Anthropic, pensada para alguien que no programa.
Una skill es una carpeta con un archivo de instrucciones que le pasás a Claude para que siempre haga la misma tarea de la misma forma.
Es como contratar a alguien y darle un manual de su rol. Lo lee una vez. Después cuando aparece esa tarea, sigue el manual sin que se lo recuerdes.
Las skills pueden estar en 3 lugares distintos. Cada uno tiene su uso:
Una skill puede vivir en los 3 niveles simultáneamente. Pero típicamente elegís según el caso de uso.
Sea donde viva, una skill es un archivo SKILL.md con dos partes:
---
name: code-reviewer
description: Revisa el diff actual buscando bugs, vulnerabilidades y
violaciones de convenciones. Activate cuando el usuario diga "revisá",
"code review" o "antes de mergear".
---# Code Reviewer
Sos un revisor de código senior. Tu trabajo es...
## Protocolo
1. Primero leé `git diff`
2. Después analizá cada hunk buscando...
3. Devolveme el reporte en este formato:
## Reglas
- NO inventes problemas para llenar el reporte
- SIEMPRE citá archivo:línea
- Si todo está bien, decí "todo OK"
## Formato del output
[Estructura esperada]El cuerpo es lo que Claude lee cuando activa la skill. El description es lo que lee para decidir si activar.
Si nunca subiste una skill al nivel Claude.ai:
Crear un archivo mi-skill.md con frontmatter + cuerpo. Mínimo viable:
---
name: mi-primera-skill
description: Descripción clara de cuándo activar esta skill.
---
# Mi primera skill
[Instrucciones]mkdir mi-primera-skill
mv mi-skill.md mi-primera-skill/SKILL.md
zip -r mi-primera-skill.zip mi-primera-skill/El ZIP debe contener una carpeta con el SKILL.md adentro (no el archivo suelto).
claude.ai/customize/skillsAbrí una conversación nueva en Claude.ai y escribí algo que matchee el description de tu skill. Si la activa, te aparece el indicador "Using skill: mi-primera-skill".
Para Claude Code es aún más simple: poné el archivo en ~/.claude/skills/mi-skill/SKILL.md y ya está disponible.
No tenés que escribir cada skill a mano. Hay un patrón: una skill que genera skills.
> Quiero una skill que me ayude a triage'ar mi inbox cada mañana.
Tiene que clasificar emails en responder/delegar/archivar y darme
drafts para los que requieren respuesta.
Generame el SKILL.md completo.Claude (si tiene la skill-creator instalada) te tira el archivo listo. Vos lo revisás, ajustás detalles, lo guardás. Cero tipeo manual.
Para armarte tu propio skill-creator:
---
name: skill-creator
description: Genera archivos SKILL.md para Claude. Activate cuando el
usuario diga "creame una skill", "armame una skill para X" o pida
generar un SKILL.md.
---
# Skill Creator
Cuando te piden generar una skill:
## Paso 1 - clarificar
Preguntá:
1. ¿Qué tarea hace la skill? (descripción clara, no genérica)
2. ¿Cuándo se debería activar? (palabras que el usuario va a decir)
3. ¿Qué inputs necesita?
4. ¿Qué formato debe tener el output?
5. ¿Hay reglas duras (qué NO hacer)?
## Paso 2 - generar
Con esas respuestas, generá el SKILL.md siguiendo la estructura:
[plantilla del SKILL.md]
## Reglas
- El `description` del frontmatter debe ser lo suficientemente específico
para que se active solo cuando aplica
- Las instrucciones deben ser ACCIONABLES (verbos concretos)
- Incluir siempre "qué NO hacer" si hay riesgos obvios
- Output esperado debe estar definido (formato, longitud, estructura)Después de tener esta meta-skill, generar skills nuevas es trivial.
Las skills solas son texto. Conectadas a MCPs, pueden invocar tools reales.
Ejemplo: skill para gestionar pedidos.
SKILL.md:
---
name: gestionar-pedidos
description: Consulta y gestiona pedidos del e-commerce. Activate
cuando el usuario pregunte por pedidos, tracking, devoluciones.
---
# Gestionar Pedidos
Para cualquier consulta sobre pedidos:
1. Si el usuario menciona un ID de pedido, consultá con el MCP `pedidos`
tool `get_order` antes de responder.
2. Si pregunta por status genérico, listá pedidos recientes con
`list_orders` filtrado por la fecha mencionada.
3. NUNCA inventes datos de pedidos. Si la consulta falla o no hay
resultado, decilo explícitamente.La skill define el comportamiento. El MCP provee acceso a los datos. Juntos forman un especialista funcional.
Más sobre MCPs en tu propio MCP server.
De las skills que sobreviven al uso real, estos son los patrones comunes:
La skill define un protocolo claro: "primero X, después Y, validar Z, output W". Funciona porque elimina la varianza en cómo Claude aborda la tarea.
Skill que es experta en un tema (legal, finanzas, SEO, etc.) con vocabulario propio y reglas del dominio.
Convierte input en formato A a output en formato B siguiendo reglas específicas. Ej: skill de traducción técnica.
Mira algo y reporta problemas con criterio definido. Ej: code reviewer.
Genera artefactos con plantilla y reglas. Ej: PRD generator, test generator.
description muy genérico#❌ description: Te ayuda con código.
✅ description: Revisa el diff del trabajo actual buscando bugs y violaciones. Activate al final de una feature, antes de abrir PR, o cuando el usuario diga "revisá".
Si Claude no sabe cuándo activar la skill, no se activa.
Una skill de 2000 palabras es demasiado. Claude se distrae. Mantenelas concisas — protocolo claro + reglas mínimas + formato. Si necesitás más, dividí en 2 skills relacionadas.
Las reglas negativas son tan importantes como las positivas. Listalas explícitamente.
Tener 3 skills con descriptions similares confunde. Una skill por dominio claro.
Una skill no es "hacer y olvidar". Si el output es mediocre, ajustá el SKILL.md. El primer draft no es el final.
Una skill bien armada captura tu mejor versión de un trabajo, codificada para que Claude lo replique cada vez.
La inversión es ~30 minutos por skill bien armada. Si la usás 100 veces, te ahorra 50+ horas vs explicar el contexto cada vez. ROI obvio.
Pero: skills mediocres son ruido. Skills bien hechas son apalancamiento. La diferencia es el cuidado puesto en el description (cuándo activar) y las reglas (qué hacer y qué no).