Appearance
Guía completa para construir Skills para Claude
Qué son las Skills y por qué importan
Anthropic ha publicado "The Complete Guide to Building Skills for Claude", la guía oficial y más completa hasta la fecha sobre cómo construir Skills — el sistema de personalización que permite enseñar a Claude flujos de trabajo específicos, una sola vez, y reutilizarlos en cada conversación.
Una Skill es un conjunto de instrucciones empaquetadas en una carpeta simple que enseña a Claude cómo manejar tareas o workflows específicos. En lugar de re-explicar tus preferencias, procesos y conocimiento de dominio en cada conversación, las Skills te permiten enseñar una vez y beneficiarte siempre.
Las Skills son especialmente potentes cuando tienes workflows repetibles: generar diseños frontend desde especificaciones, investigar con metodología consistente, crear documentos que sigan la guía de estilo de tu equipo, u orquestar procesos multi-paso.
Anatomía de una Skill
Toda Skill es una carpeta con la siguiente estructura:
mi-skill/
├── SKILL.md # Requerido - archivo principal
├── scripts/ # Opcional - código ejecutable
│ ├── process_data.py
│ └── validate.sh
├── references/ # Opcional - documentación adicional
│ └── api-guide.md
└── assets/ # Opcional - plantillas, iconos, fuentes
└── template.mdEl archivo SKILL.md es el corazón de la Skill. Contiene un frontmatter YAML obligatorio y las instrucciones en Markdown:
yaml
---
name: mi-skill-nombre
description: Qué hace. Usar cuando el usuario pide [frases específicas].
---Reglas críticas
- El archivo debe llamarse exactamente
SKILL.md(sensible a mayúsculas) - El nombre de la carpeta debe usar kebab-case:
notion-project-setup - No incluir
README.mddentro de la carpeta de la Skill - No usar nombres con "claude" o "anthropic" (reservados)
- No usar XML (
< >) en el frontmatter por restricciones de seguridad
El principio de Progressive Disclosure
Las Skills usan un sistema de tres niveles que minimiza el consumo de tokens:
Primer nivel (frontmatter YAML): Siempre cargado en el system prompt de Claude. Proporciona solo la información suficiente para que Claude sepa cuándo usar cada Skill.
Segundo nivel (cuerpo de SKILL.md): Se carga cuando Claude considera que la Skill es relevante para la tarea actual.
Tercer nivel (archivos enlazados): Archivos adicionales dentro del directorio que Claude navega solo cuando los necesita.
Este diseño es elegante: cada Skill que añades no satura el contexto de Claude — solo se activa lo necesario, cuando es necesario.
Skills + MCP: la combinación completa
Para quienes trabajan con integraciones MCP (Model Context Protocol), las Skills añaden una capa poderosa sobre el acceso a herramientas.
Anthropic lo explica con una analogía de cocina:
MCP proporciona la cocina profesional: acceso a herramientas, ingredientes y equipamiento. Las Skills proporcionan las recetas: instrucciones paso a paso sobre cómo crear algo valioso.
| MCP (Conectividad) | Skills (Conocimiento) |
|---|---|
| Conecta Claude a tu servicio | Enseña a Claude cómo usarlo eficazmente |
| Proporciona acceso a datos y herramientas | Captura workflows y buenas prácticas |
| Qué puede hacer Claude | Cómo debería hacerlo |
Sin Skills, los usuarios conectan su MCP pero no saben qué hacer. Con Skills, los workflows pre-construidos se activan automáticamente cuando son necesarios.
Las tres categorías de Skills
Anthropic identifica tres patrones principales:
1. Creación de documentos y assets
Para generar output consistente y de alta calidad: documentos, presentaciones, aplicaciones, diseños, código.
Técnicas clave: guías de estilo embebidas, estructuras de plantilla, checklists de calidad antes de finalizar. No requiere herramientas externas.
2. Automatización de workflows
Para procesos multi-paso que se benefician de metodología consistente.
Técnicas clave: workflows paso a paso con puertas de validación, plantillas para estructuras comunes, bucles de refinamiento iterativo.
3. Mejora de MCP
Para añadir guía de workflow sobre el acceso a herramientas que ya proporciona un servidor MCP.
Técnicas clave: coordinación de múltiples llamadas MCP en secuencia, conocimiento de dominio embebido, manejo de errores para problemas comunes de MCP.
Cinco patrones de diseño probados
La guía documenta cinco patrones que han emergido de los primeros adoptantes:
Patrón 1: Orquestación secuencial
Para procesos multi-paso en un orden específico. Cada paso depende del anterior, con validación en cada etapa e instrucciones de rollback para fallos.
Patrón 2: Coordinación multi-MCP
Cuando los workflows abarcan múltiples servicios. Por ejemplo: exportar de Figma → almacenar en Drive → crear tareas en Linear → notificar en Slack.
Patrón 3: Refinamiento iterativo
Cuando la calidad del output mejora con iteración. Genera un borrador, valida con scripts, refina, y repite hasta alcanzar el umbral de calidad.
Patrón 4: Selección de herramientas contextual
El mismo resultado, diferentes herramientas según el contexto. Un árbol de decisión determina qué MCP usar basándose en el tipo de archivo, tamaño u otros criterios.
Patrón 5: Inteligencia de dominio
La Skill añade conocimiento especializado más allá del acceso a herramientas. Por ejemplo, reglas de compliance financiero antes de procesar un pago.
Cómo escribir una buena descripción
El campo description es la parte más importante del frontmatter. Es lo que Claude lee para decidir si carga tu Skill.
La estructura recomendada es: [Qué hace] + [Cuándo usarla] + [Capacidades clave]
yaml
# Buena - específica y accionable
description: Analiza archivos de diseño Figma y genera
documentación de handoff para desarrolladores. Usar cuando
el usuario suba archivos .fig o pida "specs de diseño" o
"design-to-code handoff".
# Mala - demasiado vaga
description: Ayuda con proyectos.Si la descripción es demasiado genérica, la Skill nunca se activará. Si es demasiado amplia, se activará para consultas irrelevantes.
Testing: tres niveles de verificación
Anthropic recomienda tres áreas de testing:
1. Tests de activación
Verificar que la Skill se carga en el momento correcto — y no se carga cuando no debería.
2. Tests funcionales
Verificar que produce outputs correctos, las llamadas API funcionan, el manejo de errores es robusto.
3. Comparación de rendimiento
Demostrar que la Skill mejora los resultados frente al baseline: menos mensajes de ida y vuelta, menos llamadas API fallidas, menos tokens consumidos.
Un consejo clave de Anthropic: itera sobre una sola tarea difícil hasta que Claude la resuelva correctamente, y luego extrae el enfoque ganador en una Skill. Esto aprovecha el aprendizaje in-context de Claude.
Distribución y la API de Skills
Para usuarios individuales
- Descargar la carpeta de la Skill
- Comprimir como .zip
- Subir en Claude.ai > Settings > Capabilities > Skills
- O colocar en el directorio de Skills de Claude Code
Para organizaciones
Los administradores pueden desplegar Skills a nivel de workspace con actualizaciones automáticas y gestión centralizada.
Via API
El endpoint /v1/skills permite gestión programática, versionado y despliegue a escala. Las Skills se añaden a las requests de la Messages API vía el parámetro container.skills.
Un estándar abierto
Al igual que MCP, Anthropic ha publicado Agent Skills como un estándar abierto. La misma Skill debería funcionar tanto en Claude como en otras plataformas de IA, aunque algunas Skills están diseñadas para aprovechar capacidades específicas de una plataforma.
El skill-creator: tu punto de partida
Anthropic ofrece una Skill llamada skill-creator — disponible tanto en Claude.ai como en Claude Code — que te ayuda a construir Skills desde descripciones en lenguaje natural. Genera el SKILL.md con frontmatter correctamente formateado, sugiere frases de activación y estructura, y revisa Skills existentes para identificar problemas.
Si tienes un servidor MCP y conoces tus 2-3 workflows principales, puedes construir y probar una Skill funcional en 15-30 minutos.
Por qué esto importa para el ecosistema
Las Skills representan la evolución natural de cómo interactuamos con los LLMs. En lugar de depender de prompts cada vez más largos y elaborados — un tema que exploramos en el artículo sobre context engineering — las Skills encapsulan el conocimiento una vez y lo reutilizan sistemáticamente.
Junto con MCP, que como vimos en el post sobre sistemas open source con Claude y agentes de IA está transformando cómo los agentes se conectan con el mundo, las Skills completan la ecuación: MCP es el qué puede hacer Claude, y las Skills son el cómo debería hacerlo.
Para los desarrolladores que están creando agentes y automatizaciones — como discutimos en el artículo sobre la demanda infinita de código — las Skills proporcionan una forma estandarizada de empaquetar expertise que antes solo existía en la cabeza de un ingeniero.
Partners como Asana, Atlassian, Canva, Figma, Sentry y Zapier ya están publicando Skills para sus integraciones MCP. Esto no es solo una feature — es la base de un ecosistema donde el conocimiento de workflow es portable, compartible y componible.
Cómo empezar hoy
- Identifica 2-3 workflows que repites frecuentemente
- Pide a Claude: "Help me build a skill using skill-creator"
- Itera sobre una tarea difícil hasta que funcione
- Extrae el enfoque en una Skill con la estructura descrita
- Prueba, refina y comparte
La guía completa está disponible gratuitamente y es el recurso más completo para construir Skills de calidad producción.
Fuentes: