01 Qué es una skill
Una skill es una carpeta con un archivo SKILL.md que enseña a Claude a hacer una tarea concreta siempre de la misma manera: preparar una propuesta comercial con tu plantilla, revisar un contrato con tus criterios o generar un informe mensual con tu formato. Es la diferencia entre explicar el proceso en cada conversación y tenerlo documentado una sola vez.
Las skills siguen un estándar abierto (Agent Skills), así que la misma carpeta funciona en claude.ai, en Claude Code y en la API, y también en otras herramientas que adoptan el formato.
SKILL.md (obligatorio)
Un bloque YAML arriba con name y description, y debajo las instrucciones en Markdown.
references/
Documentación larga, guías de estilo, tablas de precios o normativa que Claude consulta solo si hace falta.
scripts/
Código que Claude ejecuta en lugar de razonarlo: validar un CSV, convertir formatos, calcular algo de forma exacta.
assets/
Plantillas, logotipos, tipografías o archivos base que se usan para generar el resultado.
02 Cómo la lee Claude: carga por niveles
Claude no mete todas tus skills en el contexto. Usa lo que Anthropic llama divulgación progresiva, en tres niveles:
-
1
Metadatos, siempre cargados
Al empezar, Claude solo ve el name y la description de cada skill, unas decenas de palabras por skill. Con eso decide si la tarea encaja.
-
2
Cuerpo de SKILL.md, al activarse
Si la descripción coincide con lo que pides, lee las instrucciones completas. Hasta entonces no ocupan contexto.
-
3
Archivos de apoyo, bajo demanda
Los documentos de references/ y los scripts se abren o ejecutan solo cuando el paso concreto los necesita.
03 Reglas del frontmatter
---
name: propuestas-comerciales
description: Redacta propuestas comerciales con la plantilla y tarifas de la agencia. Úsala cuando el usuario pida una propuesta, un presupuesto para un cliente o una oferta de servicios.
---
# Propuestas comerciales
## Reglas
- Usa siempre la plantilla de assets/plantilla.docx
- Precios: consulta references/tarifas.md, nunca los inventes
## Pasos
1. Pide sector, objetivo y presupuesto si faltan
2. ...
## Ejemplos
## Problemas frecuentes- ✓name: máximo 64 caracteres, solo minúsculas, números y guiones. Debe coincidir con el nombre de la carpeta.
- ✓name no puede incluir las palabras reservadas «anthropic» ni «claude».
- ✓description: máximo 1.024 caracteres, sin etiquetas XML (nada de signos de menor y mayor).
- ✓La descripción dice qué hace y cuándo usarla, con las frases que diría alguien de verdad. Escríbela en tercera persona.
- ✓El cuerpo de SKILL.md, por debajo de 500 líneas. Lo que sobre, a references/.
- ✓Para subirla a claude.ai o a la API, el frontmatter solo admite name, description, license, compatibility, metadata y allowed-tools.
04 Dónde se instala cada skill
| Superficie | Cómo se instala | Alcance |
|---|---|---|
| claude.ai y Cowork | Comprime la carpeta en .zip y súbela desde la sección de skills de los ajustes; luego actívala | Solo tu cuenta; cada compañero la sube por su lado |
| Claude Code, personal | Copia la carpeta a ~/.claude/skills/nombre/ | Todos tus proyectos en ese ordenador |
| Claude Code, proyecto | Copia la carpeta a .claude/skills/nombre/ del repositorio y haz commit | Todo el equipo que trabaje en ese repo |
| API | Súbela con los endpoints de Skills | Todo el espacio de trabajo de la API |
Las skills no se sincronizan entre la API y claude.ai: hay que subirlas en cada sitio. La excepción es Claude Code cuando inicias sesión con tu cuenta de claude.ai, que descarga las skills que tengas activas allí.
Para empezar con ejemplos oficiales, el repositorio de Anthropic se puede añadir como marketplace de plugins dentro de Claude Code:
/plugin marketplace add anthropics/skills
/plugin install example-skills@anthropic-agent-skills
/plugin install document-skills@anthropic-agent-skills05 Skills y conectores MCP
Un conector MCP le da a Claude acceso a una herramienta (tu CRM, Notion, Shopify, el correo). Una skill le da el criterio para usarla: en qué orden llamar a las herramientas, qué campos rellenar, qué comprobar antes de actuar. Por separado funcionan; juntos evitan que cada conversación empiece de cero.
Crear documentos
Informes, presentaciones u hojas de cálculo con tu marca. No necesitan MCP: basta con plantillas, guía de estilo y una lista de control.
Automatizar procesos
Flujos de varios pasos con puntos de validación, como dar de alta un cliente o preparar el cierre de mes.
Mejorar un MCP
Una capa de método sobre un conector existente, por ejemplo cómo crear tareas en tu gestor de proyectos siguiendo vuestras normas.
06 Crear tu primera skill
-
1
Resuelve la tarea una vez a mano
Trabaja con Claude en una conversación normal hasta que el resultado sea bueno. Ese proceso que funcionó es lo que vas a empaquetar.
-
2
Define el alcance
Qué quiere conseguir quien la usa, qué pasos tiene, qué herramientas necesita y qué conocimiento propio hay que incluir.
-
3
Usa skill-creator
La skill oficial skill-creator entrevista, genera la estructura, escribe la descripción y propone pruebas. Está en el repositorio oficial de Anthropic, dentro del plugin example-skills.
-
4
Revisa y prueba
Lee el SKILL.md generado, ajusta lo que no sea tuyo y pasa las pruebas del siguiente apartado antes de compartirla.
Usa skill-creator para convertir el proceso que acabamos de seguir en esta conversación en una skill reutilizable. Requisitos: name en minúsculas con guiones y sin las palabras claude ni anthropic; description en tercera persona que diga qué hace y cuándo usarla, con al menos cuatro frases reales que yo diría; cuerpo con reglas críticas al principio, pasos numerados, un ejemplo de entrada y salida y una sección de problemas frecuentes. Si algo ocupa más de 50 líneas, muévelo a references/. Si hay cálculos o validaciones exactas, propón un script en scripts/. Devuélveme el árbol de archivos y el contenido de cada uno.07 Cómo probar que funciona
- ✓Activación: prepara 10 peticiones que deberían cargarla y 5 parecidas que no. Lo razonable es que acierte en casi todas.
- ✓Resultado: para cada caso de uso, comprueba formato, datos y que no haya errores en las herramientas.
- ✓Coste: compara la misma tarea con la skill activada y desactivada en número de idas y vueltas y tiempo.
- ✓Revisión en frío: abre una conversación nueva y pide a Claude que explique cuándo usaría la skill.
Sin ejecutarla, analiza la skill [NOMBRE]. Cita la descripción que tienes cargada y dime: 1) cinco peticiones que la activarían, 2) cinco peticiones parecidas que no deberían activarla y por qué, 3) si se solapa con otra skill que tenga instalada, y 4) una versión mejorada de la descripción si la actual es ambigua o demasiado amplia.08 Errores habituales
| Síntoma | Causa probable | Solución |
|---|---|---|
| No se activa nunca | Descripción genérica, sin frases de uso | Añade qué hace, para qué archivos o casos y las palabras que usa tu equipo |
| Se activa cuando no toca | Descripción demasiado amplia | Acota el dominio y di explícitamente qué no cubre |
| Falla la subida a claude.ai | Nombre con mayúsculas o espacios, campos no admitidos o carpeta mal comprimida | Revisa name, quita campos de Claude Code y comprime la carpeta, no su contenido suelto |
| Respuestas lentas o confusas | SKILL.md demasiado largo | Deja en el cuerpo solo lo esencial y pasa el detalle a references/ |
| Ignora pasos | Reglas importantes enterradas al final | Pon las reglas críticas arriba y usa instrucciones concretas, no genéricas |
Preguntas frecuentes
No. Una skill básica es solo un archivo Markdown con instrucciones. Los scripts son opcionales y skill-creator puede escribirlos por ti si los necesitas.
Un proyecto guarda contexto e instrucciones para un tema concreto y solo vive dentro de ese proyecto. Una skill es un procedimiento que Claude carga en cualquier conversación cuando la tarea lo requiere.
CLAUDE.md se carga siempre y conviene reservarlo para hechos del proyecto. Una skill solo se carga cuando se usa, así que es mejor para procedimientos largos o poco frecuentes.
En Claude Code, haz commit de la carpeta en .claude/skills/ del repositorio o distribúyela como plugin. En claude.ai cada persona la sube a su cuenta, salvo que la organización la provea de forma centralizada.
Muchas, porque cada una solo ocupa su descripción hasta que se usa. Aun así, conviene revisar de vez en cuando y quitar las que se solapan, porque confunden la elección.
Sobre el autor
Equipo editorial de appyweb
Marketing, SEO y desarrollo con IA
Especialistas de appyweb en SEO, publicidad, desarrollo web y automatización con IA.