Qué son las Skills (instrucciones reutilizables para Claude): experiencia reutilizable

Tiempo: unos 25 min de lectura + 30 min de práctica

Lo esencial

Si un workflow (flujo de trabajo) es la receta de un platillo concreto, una skill es una receta con pasaporte, que puedes pasarle a cualquier cocinero en cualquier restaurante del mundo. La skill sabe quién es, qué sabe hacer y cómo presentarse ante un agente (un ejecutor autónomo de tareas) que nunca la ha visto.

Conceptos clave

• Skill = workflow + un pasaporte en YAML (un formato de archivos de configuración), llamado frontmatter (los metadatos al inicio del archivo)
• Carga progresiva: N1 frontmatter → N2 el workflow completo → N3 archivos
• Instalar skills ya hechas con /plugin desde un marketplace; las tuyas van en la carpeta .claude/skills/<nombre>/SKILL.md
• Un framework de 6 pasos para crear una skill
• Las skills mejoran con iteración y retroalimentación

Teoría

Workflow vs. skill: cuál es la diferencia

🎨 Imagínalo así: una skill es una receta en un libro de cocina. Un workflow es el platillo que preparaste hoy de memoria. El platillo desaparece. La receta se queda, y cualquier cocinero en cualquier restaurante la reproduce mañana.

Un workflow es una secuencia de pasos para una tarea concreta. Vive en la memoria de la sesión actual. Desaparece cuando cierras la pestaña.

Una skill es ese mismo workflow, pero empaquetado en un archivo con metadatos. El archivo se llama SKILL.md y vive en la carpeta de la skill (.claude/skills/<nombre>/SKILL.md):

---
name: weekly-youtube-roundup
description: Analiza un canal de YouTube de los últimos 7 días y genera un reporte. Úsala cuando pidan un resumen semanal de un canal.
---

# YouTube Weekly Roundup

## Paso 1: Reunir los datos...

El frontmatter tiene otros campos opcionales (por ejemplo, allowed-tools, model, disable-model-invocation), pero lo indispensable es description: con ese campo Claude decide cuándo activar la skill.

La diferencia es crucial:

• Un workflow solo lo conoce el agente de la sesión actual
• Una skill la conoce cualquier agente: puede leer el frontmatter y entender "ah, esto es para análisis de YouTube"

Cómo elige el agente la skill correcta: carga progresiva

Imagina que tienes 50 skills. Cargar las 50 en el contexto (el texto que la IA ve) con cada solicitud = miles de tokens (un token es una unidad de texto para la IA) desperdiciados. Por eso se usa la carga progresiva, en tres niveles:

🎨 Imagínalo así: la carga progresiva es como una biblioteca. Primero miras los lomos (N1: frontmatter, segundos). Encuentras el libro que buscas, lo bajas del estante y lo lees (N2: el workflow completo). Solo si necesitas el atlas anexo lo abres aparte (N3: archivos de referencia). No te llevas todo el librero de una vez.

N1: Frontmatter (del orden de cien tokens por skill)

El agente lee solo la parte del encabezado de todas las skills: nombre y descripción. Es como leer los lomos de los libros en un estante: ves el título y una descripción corta. Con eso decide: "esta skill sirve para la tarea". La descripción en la lista tiene un límite de longitud (en la documentación a octubre de 2026, unos 1,500 caracteres), así que escribe lo principal al inicio.

name: weekly-youtube-roundup
description: Analiza un canal de YouTube de los últimos 7 días y genera un reporte

N2: El workflow completo en Markdown (de 1,000 a 2,000 tokens)

Solo cuando la skill ya fue elegida, el agente lee el texto completo con las instrucciones paso a paso. Ahora sabe qué hacer.

N3: Archivos de apoyo (cuando hacen falta)

Si la skill hace referencia a archivos, como una guía de marca, una plantilla de reporte o una lista de competidores, se cargan solo si se necesitan para la tarea. Si la tarea no requiere la marca, el archivo de la marca no se carga. Junto a SKILL.md, en la carpeta de la skill, puedes guardar este tipo de archivos y scripts.

Resultado: en lugar de cargar 50 × 2,000 tokens = 100,000 tokens en cada solicitud, solo se carga el frontmatter de las skills (50 × 100 = 5,000) + el texto completo de la elegida (2,000). Las cifras son ilustrativas, pero el orden del ahorro es ese: varias veces menos.

Cómo instalar una skill desde un marketplace

Paso 1: en Claude Code escribe:

/plugin

Se abre el menú de plugins con los catálogos (marketplaces). Las skills se distribuyen dentro de plugins. Para ver qué skills ya tienes disponibles, usa el comando /skills.

Paso 2: busca la skill que necesitas. Ejemplos de nombres de plugins en los catálogos:

• engineering:*: desarrollo, revisión, despliegue
• marketing:*: contenido, correo, SEO
• superpowers:*: productividad, trabajo en paralelo
• anthropic-skills:*: skills oficiales de Anthropic

Paso 3: instálala (el nombre exacto del plugin y del catálogo te lo muestra el menú /plugin):

/plugin install <plugin>@<catálogo>

Las skills del plugin quedan disponibles para el agente de inmediato o después de /reload-plugins. Puedes llamarlas a mano como /plugin:skill, pero lo más común es que el agente tome la correcta por su descripción.

Paso 4: úsala:

Haz un code review de este archivo

El agente reconoce por la descripción que hace falta la skill de code review y la aplica.

Las skills mejoran con el tiempo

Una skill no es un documento estático. Evoluciona:

1. Primera versión: la creaste, la ejecutaste, obtuviste un resultado
2. Notaste un problema: "el reporte es demasiado largo, no tiene un resumen ejecutivo"
3. Iteración: agregaste un paso de resumen ejecutivo en el frontmatter + el workflow
4. La vuelves a ejecutar: mejor
5. El siguiente problema: "el benchmarking de la competencia no toma en cuenta mi región"
6. Iteración 2: agregaste un parámetro de región

Para la iteración 10 a 30, la skill se vuelve una herramienta afinada a tus tareas. A esto se le llama "encoded expertise": experiencia codificada en un archivo.

🎨 Imagínalo así: iterar una skill es como afilar un cuchillo. Después del primer uso ya corta. Después del décimo, rasura. Después del trigésimo, es un instrumento quirúrgico. Cada ajuste quita una rebaba que estorbaba.

Un framework de 6 pasos para crear una skill

Paso 1: Nombre y disparador

¿Cómo va a entender el agente que debe usar esta skill? No existe un campo aparte de triggers: las frases que la disparan se escriben directamente en description (o en el campo opcional when_to_use).

name: competitor-price-monitor
description: >
  Monitorea los precios de la competencia y genera un reporte comparativo.
  Úsala cuando pidan "revisa los precios de la competencia",
  "competitor pricing" o "price monitoring".

Paso 2: El objetivo, en una frase clara

"Reunir los precios de 10 sitios de la competencia, compararlos con nuestros precios y resaltar las diferencias mayores al 15%."

No "hace todo lo relacionado con la competencia". Un solo foco.

Paso 3: El proceso paso a paso

Instrucciones detalladas de cada paso. No "reúne los datos", sino "abre la URL, encuentra el elemento .price-tag, extrae el texto, conviértelo en número".

Paso 4: Archivos de referencia

¿Qué necesita la skill además de las instrucciones? Esos archivos se ponen en la carpeta de la skill junto a SKILL.md, y en el texto de la skill se hace referencia a ellos:

competitor-price-monitor/
  SKILL.md
  competitors.json       # lista de URL de la competencia
  price-template.md      # plantilla del reporte
  brand-guidelines.md    # para el formato

En SKILL.md escribes: "La lista de competidores está en competitors.json, en esta misma carpeta". Claude abrirá el archivo cuando lo necesite.

Paso 5: Reglas y restricciones

Lo que la skill NO debe hacer:

- No modificar los datos originales en la base de datos
- No enviar el reporte sin revisarlo
- Si falla la extracción de un sitio, saltarlo y marcarlo como no disponible

🎨 Imagínalo así: el framework de 6 pasos es como la descripción de puesto para un empleado nuevo. Nombre (quién eres), objetivo (para qué te contrataron), proceso (cómo trabajas), herramientas (qué tomas del almacén), restricciones (qué no se vale), retroalimentación (cómo reportas). Si te saltas un paso, el empleado o no hace nada o hace otra cosa.

Paso 6: Un ciclo de automejora

Al final de la skill, una instrucción para el agente:

Al terminar, califica la calidad del resultado del 1 al 10.
Si es < 7, describe qué salió mal en el archivo skill-feedback.md.

Esto crea un sistema de retroalimentación para las mejoras siguientes.

Errores comunes al crear skills

1. Una skill demasiado amplia. "Una skill de marketing": mal. "Una skill para crear campañas de correo con pruebas A/B de asuntos": bien. Una skill = un foco.

2. Olvidar el frontmatter en YAML. Sin un frontmatter con description, el agente no tiene cómo saber cuándo activar la skill. Siempre empieza con el bloque --- y una buena descripción.

3. Meter todos los datos en el cuerpo de la skill. Una lista de 200 competidores en el cuerpo de la skill = 200 líneas que se cargan cada vez. Saca los datos grandes a archivos aparte junto a SKILL.md. La documentación de Claude Code recomienda mantener SKILL.md por debajo de 500 líneas.

4. No describir los disparadores. Si en description no dice cuándo usar la skill, puede que no se active con la solicitud correcta.

5. No iterar. La primera versión de una skill casi nunca es perfecta. El plan: crear → ejecutar → ver el punto débil → corregir → repetir.

Skills vs. Hooks (scripts que reaccionan a un evento) vs. Agents (ejecutores autónomos): cuál es la diferencia

Un frontmatter YAML real de una skill

---
name: weekly-competitor-report
description: >
  Reporte semanal de la competencia: precios, productos nuevos,
  cambios en sus sitios. Formato: resumen ejecutivo + tabla.
  Úsala cuando pidan "reporte de la competencia",
  "qué hay de nuevo con la competencia", "competitor report"
  o "monitoreo de la competencia".
argument-hint: "[pricing|features|content]"
---

# Reporte de la competencia

La lista de sitios está en competitors.json, en esta carpeta;
la plantilla del reporte, en report-template.md.
En qué fijarse: $ARGUMENTS (por defecto, los precios).

En este ejemplo, el parámetro se pasa al llamar la skill (/weekly-competitor-report features) y se inserta en el texto como $ARGUMENTS. Los campos tags, triggers, references, parameters y model_invocation, que aparecían en descripciones viejas de skills, no se usan en Claude Code: los disparadores van en description y los archivos de referencia viven al lado, en la carpeta de la skill.

Documentación de skills de Claude Code: https://code.claude.com/docs/en/skills

Dónde guardar las skills

🎨 Imagínalo así: las skills globales son como tu caja de herramientas personal, la que llevas contigo. Las skills de proyecto son como una herramienta especial que se queda en una obra concreta. El rotomartillo va siempre contigo; la cimbra, solo en esta obra.

Globales (~/.claude/skills/<nombre>/SKILL.md): La skill está disponible desde cualquier proyecto. Sirve para skills universales: code review, redacción de correos, monitoreo de precios.

A nivel de proyecto (.claude/skills/<nombre>/SKILL.md): La skill está disponible solo en ese proyecto. Sirve para skills específicas: "nuestro formato de reportes", "la voz de marca de un cliente concreto". Puedes hacer commit de la carpeta del proyecto y la skill aparecerá para todo el equipo.

Qué más conviene saber (a octubre de 2026):

• Los comandos personalizados viejos de .claude/commands/ siguen funcionando y se unificaron con las skills: el archivo .claude/commands/deploy.md y la skill .claude/skills/deploy/SKILL.md crean ambos el comando /deploy. Para lo nuevo, mejor elige skills
• Las skills también están disponibles en claude.ai, incluido el plan gratis. Para subirlas ahí, en el frontmatter solo se permiten los campos generales (name, description, license, compatibility, metadata, allowed-tools); los campos propios de Claude Code darán error al subirlas

Práctica

Tarea: encontrar e instalar 2 o 3 skills de un marketplace

1. Abre Claude Code y escribe /plugin
2. Explora el catálogo: encuentra al menos 3 skills que podrían servirte para tus tareas
3. Instala 2 skills: una para el trabajo (desarrollo o marketing) y una para la productividad
4. Ejecuta /skills y revisa la lista: encuentra las skills instaladas, abre el archivo SKILL.md y lee el frontmatter
5. Prueba usar una skill en una tarea real
6. Extra: crea a mano una skill sencilla, "plantilla de reporte diario", con el framework de 6 pasos

Herramientas y recursos

• /plugin: el comando que abre el menú de plugins y catálogos (marketplaces) en Claude Code
• /skills: la lista de skills disponibles
• Documentación de Skills de Claude Code: documentación oficial sobre skills
• Claude Code Sub-agents: documentación de subagentes (relacionada)
• .claude/skills/<nombre>/SKILL.md: una skill a nivel de proyecto
• ~/.claude/skills/<nombre>/SKILL.md: una skill global

Ideas clave

Skill = un workflow con pasaporte. El pasaporte permite que cualquier agente encuentre y use la skill sin que tengas que explicársela a mano.

La carga progresiva ahorra la mayor parte de los tokens: primero leemos los lomos de los libros (frontmatter), luego abrimos el que necesitamos (el Markdown completo).

Las skills mejoran con la iteración. La versión 1 es un borrador. La versión 15 es una herramienta precisa para tus tareas.

Lecciones relacionadas

• → Creamos una skill desde cero EN VIVO: creación práctica de una skill con Skill Creator y un framework de evals
• → Arquitectura de skills: dos arquetipos: Capability Uplift vs. Encoded Preference
• → Evals: skills que se mejoran solas: un sistema de pruebas para que las skills se mejoren solas

Siguiente lección

→ Creamos una skill desde cero EN VIVO: Skill Creator + Eval Framework