01 Qué es una skill y cómo la carga Claude
Una skill es una carpeta con un archivo SKILL.md: una cabecera YAML con el nombre y la descripción, seguida de instrucciones en lenguaje natural. Opcionalmente incluye documentos de referencia, plantillas o scripts. Sirve para enseñar a Claude a hacer una tarea a tu manera y que lo recuerde siempre, sin repetir el mismo prompt.
Lo que la hace eficiente es la carga progresiva: Claude no lee todas tus skills en cada conversación, solo lo imprescindible para decidir cuál usar.
| Nivel | Cuándo se carga | Qué se carga |
|---|---|---|
| 1. Metadatos | Siempre, al empezar | Nombre y descripción (unas decenas de tokens por skill) |
| 2. Instrucciones | Cuando la petición encaja con la descripción | El cuerpo de SKILL.md |
| 3. Recursos | Solo si hacen falta | Archivos de referencia que lee y scripts que ejecuta (solo entra su salida) |
02 Tu primera skill en Claude Code
-
1
Elige dónde vivirá
En ~/.claude/skills/ si es personal y la quieres en todos tus proyectos; en .claude/skills/ dentro del repositorio si es del proyecto y la debe compartir el equipo vía Git.
-
2
Crea la carpeta
Un nombre corto en minúsculas con guiones. Por defecto, ese nombre es el comando con el que la invocarás.
-
3
Escribe SKILL.md
Cabecera YAML entre líneas de tres guiones al principio del archivo y las instrucciones debajo.
-
4
Pruébala
Abre Claude Code y pide algo que encaje con la descripción, o invócala directamente con / seguido de su nombre. Los cambios en el archivo se detectan sin reiniciar la sesión.
mkdir -p ~/.claude/skills/revisar-textos-web---
name: revisar-textos-web
description: Revisa y corrige textos para la web en español de España (titulares, fichas de servicio, entradas de blog). Úsala cuando el usuario pida revisar, corregir o mejorar un texto antes de publicarlo.
---
# Revisión de textos web
1. Lee el texto completo antes de cambiar nada.
2. Corrige ortografía, puntuación y concordancias según la RAE.
3. Usa español de España: «tú», «ordenador», «móvil».
4. Acorta frases de más de 25 palabras y elimina relleno.
5. Comprueba que el titular dice qué gana el lector.
6. No inventes datos, cifras ni testimonios.
Entrega:
- El texto corregido.
- Una tabla con los cambios importantes y su motivo.
- Dos alternativas de titular.03 Los campos de la cabecera que más vas a usar
name
Opcional en Claude Code: si no lo pones, se usa el nombre de la carpeta. Solo minúsculas, números y guiones.
description
Recomendado. Qué hace y cuándo usarla. Pon primero el caso principal: en el listado se recorta si es muy larga.
disable-model-invocation
Con true, Claude no la activa por su cuenta: solo se ejecuta cuando escribes /nombre. Útil para acciones delicadas.
allowed-tools
Herramientas que Claude puede usar sin pedir permiso mientras ejecuta la skill, por ejemplo Read Grep.
argument-hint
Pista que aparece al autocompletar para indicar qué argumentos espera.
---
description: Genera el acta de una reunión a partir de un archivo de notas.
disable-model-invocation: true
argument-hint: [ruta-del-archivo-de-notas]
---
Lee el archivo $ARGUMENTS y redacta el acta con estas secciones:
- Asistentes
- Decisiones tomadas
- Tareas: responsable y fecha
- Temas pendientes para la próxima reunión
Si falta un responsable o una fecha, márcalo como [PENDIENTE] en lugar de inventarlo.
Guarda el acta junto a las notas con el sufijo -acta.md.04 Archivos de apoyo y scripts
Mantén SKILL.md por debajo de unas 500 líneas. Lo que sea consulta (guía de estilo completa, tarifas, ejemplos largos) va en archivos aparte que mencionas desde SKILL.md, explicando qué contiene cada uno y cuándo leerlo. Los scripts se ejecutan y solo su resultado entra en el contexto, así que son ideales para cálculos o validaciones repetibles.
propuesta-comercial/
├── SKILL.md # instrucciones y cuándo usar cada archivo
├── tarifas.md # precios y condiciones vigentes
├── plantilla.md # estructura de la propuesta
└── scripts/
└── calcular.py # cálculo de importes e IVA05 Buenas prácticas y errores típicos
- ✓Una skill, una tarea. Si empieza a tener muchas ramas, divídela.
- ✓Instrucciones concretas y verificables: «máximo tres párrafos» en vez de «sé breve».
- ✓Explica el porqué de las reglas importantes; Claude las aplica mejor en casos no previstos.
- ✓Pide confirmación antes de cualquier acción que borre, envíe o publique.
- ✓Nada de rutas absolutas de tu ordenador: usa rutas relativas a la carpeta de la skill.
- ✓Evita nombres genéricos como helper o utilidades; el nombre debe decir qué hace.
- ✓No guardes contraseñas ni claves dentro de la skill.
- ✓Pruébala con peticiones que deberían activarla y con otras que no.
Quiero convertir esta tarea que repito a menudo en una skill de Claude Code: [describe la tarea, un ejemplo real de entrada y el resultado que esperas]. Hazme las preguntas necesarias y después escribe el SKILL.md completo con una descripción que diga qué hace y cuándo usarla. Indica si conviene que sea solo manual, qué archivos de apoyo necesitaría y en qué carpeta guardarla. Añade cinco peticiones de prueba: tres que deberían activarla y dos que no.06 Usarla fuera de Claude Code
| Dónde | Cómo se añade | A tener en cuenta |
|---|---|---|
| Claude Code | Carpeta en ~/.claude/skills/ o .claude/skills/ | Las sesiones en la nube y Cowork no leen tu carpeta personal; súbela al repositorio o a claude.ai |
| claude.ai y app de escritorio | Sube la carpeta comprimida en .zip desde los ajustes | Planes Pro, Max, Team y Enterprise con ejecución de código activada; cada usuario la sube por separado |
| API de Claude | Se sube con la API de skills y se indica en el parámetro container junto con la herramienta de ejecución de código | Se ejecuta en un contenedor sin acceso a la red |
Preguntas frecuentes
CLAUDE.md se carga en todas las sesiones del proyecto y sirve para reglas generales. Una skill solo se carga cuando la tarea lo requiere, así que puedes tener muchas sin saturar el contexto.
Siguen funcionando y se comportan igual que una skill con el mismo nombre. Para trabajo nuevo, usa skills: admiten archivos de apoyo y activación automática.
Casi siempre es la descripción: no menciona las palabras con las que lo pides o es demasiado genérica. Revisa también que la cabecera empiece en la primera línea del archivo y que el YAML sea válido.
Si inicias sesión en Claude Code con tu cuenta de claude.ai y tienes una versión reciente, las skills de tu cuenta se sincronizan en una carpeta aparte. Las que creas en Claude Code no se suben a claude.ai.
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.