Un skill es un conjunto de instrucciones - empaquetado como una carpeta simple - que ensena a Claude como manejar tareas o flujos de trabajo especificos.
Los skills son una de las formas mas poderosas de personalizar Claude para tus necesidades. En lugar de volver a explicar tus preferencias, procesos y conocimiento de dominio en cada conversacion, los skills te permiten ensenarle a Claude una vez y beneficiarte siempre.
Ambos caminos comparten los mismos requisitos tecnicos.
Un skill es una carpeta que contiene:
Los skills usan un sistema de tres niveles:
Esto minimiza el uso de tokens manteniendo la experiencia especializada.
Claude puede cargar multiples skills simultaneamente. Tu skill debe funcionar bien junto a otros.
Los skills funcionan de forma identica en Claude.ai, Claude Code y la API. Crea un skill una vez y funciona en todas las superficies sin modificacion.
La analogia de la cocina:
Juntos, permiten a los usuarios realizar tareas complejas sin necesidad de descifrar cada paso por si mismos.
| MCP (Conectividad) | Skills (Conocimiento) |
|---|---|
| Conecta Claude a tu servicio | Ensena a Claude como usar tu servicio efectivamente |
| Proporciona acceso a datos en tiempo real e invocacion de herramientas | Captura flujos de trabajo y mejores practicas |
| Lo que Claude puede hacer | Como Claude deberia hacerlo |
Sin skills:
Con skills:
Antes de escribir cualquier codigo, identifica 2-3 casos de uso concretos que tu skill deberia habilitar.
Caso de uso: Planificacion de sprint de proyecto
Disparador: El usuario dice "ayudame a planificar este sprint"
Pasos:
1. Obtener estado actual del proyecto de Linear (via MCP)
2. Analizar velocidad y capacidad del equipo
3. Sugerir priorizacion de tareas
4. Crear tareas en Linear con etiquetas apropiadas
Resultado: Sprint completamente planificado con tareas creadasCreacion de resultados consistentes y de alta calidad incluyendo documentos, presentaciones, aplicaciones, disenos, codigo, etc.
Tecnicas clave:
Procesos de multiples pasos que se benefician de una metodologia consistente.
Tecnicas clave:
Guia de flujo de trabajo para mejorar el acceso a herramientas que proporciona un servidor MCP.
Tecnicas clave:
nombre-de-tu-skill/
├── SKILL.md # Requerido
├── scripts/ # Opcional
│ ├── process_data.py
│ └── validate.sh
├── references/ # Opcional
│ ├── api-guide.md
│ └── examples/
└── assets/ # Opcional
└── report-template.mdNombre de SKILL.md: Debe ser exactamente SKILL.md (sensible a mayusculas)
Nombre de la carpeta del skill:
notion-project-setupSin README.md dentro de la carpeta del skill. Toda la documentacion va en SKILL.md o references/.
El frontmatter YAML es como Claude decide si cargar tu skill.
name: solo kebab-case, debe coincidir con el nombre de la carpeta
description: Debe incluir QUE + CUANDO, menos de 1024 caracteres
Estructura: [Que hace] + [Cuando usarlo] + [Capacidades clave]
Bueno:
description: Gestiona flujos de trabajo de proyectos en Linear
incluyendo planificacion de sprint, creacion de tareas y
seguimiento de estado. Usar cuando el usuario mencione
"sprint", "tareas de Linear" o pida "crear tickets".Malo:
description: Ayuda con proyectos.Estructura recomendada despues del frontmatter:
Se especifico y accionable:
Ejecuta `python scripts/validate.py --input {filename}`
para verificar el formato de datos.
Si la validacion falla, los problemas comunes incluyen:
- Campos requeridos faltantes (agregarlos al CSV)
- Formatos de fecha invalidos (usar YYYY-MM-DD)Incluye manejo de errores y referencia claramente los recursos incluidos.
Usa divulgacion progresiva: Mantiene SKILL.md enfocado; mueve detalles a references/.
Consejo: Itera en una sola tarea desafiante hasta que Claude tenga exito, luego extrae el enfoque ganador en un skill.
Objetivo: Asegurar que tu skill se carga en los momentos correctos.
Deberia activarse:
NO deberia activarse:
Objetivo: Verificar que el skill produce resultados correctos.
Prueba: Crear proyecto con 5 tareas
Dado: Nombre del proyecto "Planificacion Q4", 5 descripciones de tareas
Cuando: El skill ejecuta el flujo de trabajo
Entonces:
- Proyecto creado en ProjectHub
- 5 tareas creadas con propiedades correctas
- Todas las tareas vinculadas al proyecto
- Sin errores de API| Sin skill | Con skill | |
|---|---|---|
| Instrucciones | El usuario las proporciona cada vez | Flujo de trabajo automatico |
| Mensajes | 15 ida y vuelta | 2 preguntas de clarificacion |
| Llamadas API fallidas | 3 requiriendo reintento | 0 |
| Tokens consumidos | 12,000 | 6,000 |
El skill skill-creator puede ayudarte a:
"Usa el skill skill-creator para ayudarme a construir
un skill para [tu caso de uso]"Sub-activacion: Agrega mas detalle y palabras clave a la descripcion
Sobre-activacion: Agrega disparadores negativos, se mas especifico
Problemas de ejecucion: Mejora las instrucciones, agrega manejo de errores
Los skills son documentos vivos. Planifica iterar.
Usuarios individuales:
Nivel organizacional: Los administradores pueden desplegar skills en todo el espacio de trabajo con actualizaciones automaticas y gestion centralizada.
Agent Skills se publica como un estandar abierto. Como MCP, los skills deben ser portables entre herramientas y plataformas - el mismo skill deberia funcionar ya sea que uses Claude u otras plataformas de IA.
| Caso de uso | Mejor superficie |
|---|---|
| Usuarios finales interactuando directamente | Claude.ai / Claude Code |
| Pruebas manuales e iteracion | Claude.ai / Claude Code |
| Aplicaciones usando skills programaticamente | API |
| Despliegues en produccion a escala | API |
| Pipelines automatizados y sistemas de agentes | API |
Enfocate en resultados, no en caracteristicas:
Bueno: “El skill de ProjectHub permite a los equipos configurar espacios de trabajo completos en segundos en lugar de gastar 30 minutos en configuracion manual.”
Malo: “El skill de ProjectHub es una carpeta que contiene frontmatter YAML e instrucciones en Markdown que llama a las herramientas de nuestro servidor MCP.”
La mayoria de los skills se inclinan hacia una direccion.
Usar cuando: Procesos de multiples pasos en un orden especifico.
## Flujo: Incorporar nuevo cliente
### Paso 1: Crear cuenta
### Paso 2: Configurar pago
### Paso 3: Crear suscripcion
### Paso 4: Enviar correo de bienvenidaClave: Orden explicito de pasos, dependencias, validacion en cada etapa, instrucciones de reversion.
Usar cuando: Los flujos de trabajo abarcan multiples servicios.
Fase 1: Exportacion de diseno (Figma MCP)
Fase 2: Almacenamiento de activos (Drive MCP)
Fase 3: Creacion de tareas (Linear MCP)
Fase 4: Notificacion (Slack MCP)Clave: Separacion clara de fases, paso de datos entre MCPs, validacion antes de la siguiente fase.
Usar cuando: La calidad del resultado mejora con la iteracion.
Clave: Criterios de calidad explicitos, scripts de validacion, saber cuando detenerse.
Usar cuando: Mismo resultado, diferentes herramientas segun el contexto.
Clave: Criterios de decision claros, opciones de respaldo, transparencia sobre las elecciones.
Usar cuando: Tu skill agrega conocimiento especializado mas alla del acceso a herramientas.
Clave: Experiencia de dominio en la logica, cumplimiento antes de la accion, documentacion exhaustiva.
SKILL.md (sensible a mayusculas)--- y formato de comillasEl skill no se activa:
El skill se activa demasiado:
Avanzado: Incluir scripts de validacion para verificaciones deterministicas.
Causas: Contenido del skill demasiado grande, demasiados skills habilitados simultaneamente
Soluciones:
references/Recursos de Anthropic:
Herramientas:
skill-creator (integrado en Claude.ai y disponible para Claude Code)Antes de empezar: Identificar casos de uso, identificar herramientas, revisar la guia, planificar estructura de carpetas
Durante el desarrollo: Carpeta en kebab-case, SKILL.md existe, frontmatter YAML valido, descripcion incluye QUE y CUANDO
Antes de subir: Probar activacion, pruebas funcionales pasan, comprimido como .zip
Despues de subir: Probar en conversaciones reales, monitorear activacion, recopilar retroalimentacion, iterar
claude.ai