Qué es una Skill

Una Skill es una carpeta con un archivo llamado SKILL.md y, opcionalmente, otros archivos de apoyo (plantillas, ejemplos, scripts). El SKILL.md tiene dos partes:

  • Una cabecera con el nombre de la skill y una descripción de qué hace y cuándo debe usarse.
  • El cuerpo con las instrucciones detalladas: pasos, formato de salida, reglas, ejemplos.

Lo interesante es cómo la usa Claude. No lee todas tus skills en cada conversación; solo lee las descripciones. Cuando tu petición encaja con una de ellas, entonces carga el cuerpo completo y lo sigue. Eso permite tener decenas de skills sin saturar la conversación, y es lo que las diferencia de las instrucciones de un Proyecto, que se cargan siempre.

Dónde funcionan

  • En claude.ai (planes de pago): en Ajustes › Capacidades puedes activar las skills que Anthropic incluye (crear documentos de Word, Excel, PowerPoint y PDF con buen formato) y subir las tuyas como archivo comprimido.
  • En Claude Code: guardando la carpeta en ~/.claude/skills/ (para todos tus proyectos) o en .claude/skills/ dentro de un proyecto concreto. Se invocan escribiendo /nombre-de-la-skill o simplemente pidiendo la tarea en lenguaje natural.
  • En la API: para quien construye aplicaciones, las skills se adjuntan a las peticiones y se ejecutan en el entorno de código de Anthropic.

Anatomía de un SKILL.md

Así es un SKILL.md completo y funcional:

---
name: informe-semanal
description: Redacta el informe semanal de ventas con el formato de la empresa a partir de los datos que le pase el usuario. Úsala cuando pidan "informe semanal", "resumen de la semana" o "informe de ventas".
---

# Informe semanal de ventas

## Cuándo usar esta skill
Cuando el usuario pida el informe semanal o pegue datos de ventas de una semana.

## Pasos
1. Pide los datos si no están: ventas por día, comparativa con la semana anterior, incidencias.
2. Calcula el total semanal y la variación porcentual respecto a la semana anterior.
3. Redacta el informe con la estructura de abajo.
4. Termina con tres acciones recomendadas, concretas y medibles.

## Estructura del informe
- **Titular**: "Semana [número]: [una frase con el dato principal]"
- **Resumen**: 3 frases máximo.
- **Tabla**: día, ventas, variación.
- **Incidencias**: lista breve.
- **Acciones**: 3 puntos.

## Reglas
- Tono directo, sin adjetivos vacíos.
- Cifras siempre con separador de miles y símbolo de moneda.
- Si falta algún dato, indícalo en lugar de inventarlo.

La cabecera entre las líneas --- es obligatoria. El name va en minúsculas, sin espacios (usa guiones) y con un máximo de 64 caracteres. La description es lo más importante de todo el archivo, como verás a continuación.

Publicidad

La descripción decide si la skill se activa

Claude elige qué skill usar leyendo únicamente la descripción. Por eso, una descripción vaga hace que la skill nunca se active, o que se active cuando no toca. Compara:

Descripción floja: Ayuda con informes.

Descripción buena: Redacta el informe semanal de ventas con el formato de la empresa a partir de los datos que le pase el usuario. Úsala cuando pidan "informe semanal", "resumen de la semana" o "informe de ventas".

La buena dice qué hace, con qué y con qué palabras suele pedirse. Esa tercera parte, las frases que la activan, es la que más gente olvida y la que más diferencia marca.

Cómo crear tu primera skill paso a paso

  1. Elige una tarea que repitas al menos una vez por semana y en la que siempre corrijas lo mismo. Ese "lo mismo" son tus reglas.
  2. Escribe el SKILL.md. Puedes hacerlo a mano siguiendo el ejemplo anterior o usar nuestro generador de skills, que te guía campo a campo y te devuelve el archivo listo para descargar.
  3. Crea la carpeta. El nombre de la carpeta debe coincidir con el name. Dentro va el SKILL.md y, si quieres, una subcarpeta con plantillas o ejemplos.
  4. Instálala. En Claude Code, copia la carpeta a ~/.claude/skills/. En claude.ai, comprime la carpeta en un ZIP y súbela desde Ajustes › Capacidades › Skills.
  5. Pruébala con dos o tres peticiones distintas. Si no se activa, mejora la descripción. Si se activa pero el resultado no es el que quieres, mejora el cuerpo.

Archivos de apoyo: cuándo añadirlos

Si las instrucciones empiezan a ser muy largas, saca partes a archivos aparte y referéncialos desde el SKILL.md ("consulta plantillas/informe.md para el formato exacto"). Claude solo los leerá cuando los necesite. Es habitual tener:

  • plantillas/ con el formato exacto de la salida.
  • ejemplos/ con dos o tres resultados buenos para que imite el estilo.
  • scripts/ con pequeños programas si la tarea requiere cálculos o transformaciones (esto ya es terreno de Claude Code).

Skills, Proyectos e instrucciones personalizadas

SkillsProyectosInstrucciones personalizadas
Se carganSolo cuando la tarea encajaSiempre, dentro del proyectoSiempre, en todas las conversaciones
Sirven paraUn tipo de tarea concretaUn tema o contextoPreferencias generales sobre ti
Incluyen archivosSí, de apoyo a la tareaSí, como conocimientoNo
Ejemplo"Crear el informe semanal""Todo lo de mi cliente X""Respóndeme siempre en español y sin emojis"

Se combinan: puedes estar en un Proyecto de un cliente, con tus instrucciones personalizadas activas, y pedir el informe semanal para que salte la skill. Si aún no usas Proyectos, aquí te explicamos cómo empezar.

Ideas de skills para empezar

  • Revisar un texto con tus reglas de estilo y devolverlo corregido con los cambios marcados.
  • Convertir notas de una reunión en un acta con decisiones, responsables y fechas.
  • Responder reseñas de clientes con tu tono, según sean positivas o negativas.
  • Preparar la descripción de un producto para tu tienda online con un esquema fijo.
  • Traducir textos manteniendo un glosario de términos que no se traducen.

Preguntas frecuentes

¿Las skills son gratis?

Crear una skill es gratis: es un archivo de texto. Para usarlas en claude.ai necesitas un plan de pago; en Claude Code están incluidas en los planes que dan acceso a la herramienta.

¿Cuál es la diferencia entre una skill y un GPT personalizado de ChatGPT?

Se parecen en la idea (instrucciones reutilizables), pero una skill se activa sola cuando la tarea encaja, dentro de cualquier conversación, mientras que un GPT es un chat aparte al que tienes que ir. Además, una skill es un archivo que puedes versionar, compartir y usar en varias herramientas.

¿Puedo compartir una skill con mi equipo?

Sí. Como es una carpeta, basta con enviarla o guardarla en un repositorio compartido. En los planes Team y Enterprise, los administradores pueden distribuir skills a toda la organización.

¿Qué pasa si dos skills se parecen?

Claude elige la que mejor encaje con la petición según las descripciones. Si tienes dos parecidas y se confunden, afina las descripciones para que digan claramente cuándo usar una y cuándo la otra, o fusiónalas en una sola.