Antes de los siete temas, mira el camino que conecta todo: escribes un workflow en Markdown, pasa a vivir en una carpeta (.claude/skills), y el agente lo expone como un slash command que puedes invocar cuando tú (o una instrucción) lo llamas. Una skill es, en esencia, un proceso empaquetado para reutilizarlo.

Diagrama ilustrativo — una skill nace de un workflow descrito en texto; una vez guardada, el agente la ofrece como comando y la reutiliza de forma consistente cada vez que se invoca.

Qué es

Una skill es, en esencia, un archivo markdown de instrucciones — conceptualmente idéntico a la capa W (workflows) del framework WAT. La diferencia respecto de un workflow que solo describes en el chat es dónde está e cómo se activa: la skill queda guardada en una carpeta del proyecto y se invoca con un comando, así que puedes ejecutarla de la misma forma tantas veces como quieras, sin tener que reescribir el proceso.

El detalle que lo libera todo: no necesitas saber escribir skills. Describes el workflow en lenguaje natural —"cada vez que te lo pida, haz X, luego Y y después guárdalo en Z"— y le pides al agente que convertir esto en una skill / slash command. Crea el archivo y luego puedes invocarlo con un comando. Es el mismo principio del vibe coding: describes el resultado y la IA hace el trabajo pesado.

Por qué aprender

Transforme este workflow numa skill chamável (slash command).

Nome desejado: <nome-da-skill>
Quando deve ser usada: <descreva o gatilho — ex.: "quando eu pedir um resumo de reunião">
Argumentos que ela recebe: <ex.: texto-bruto, formato-de-saida>
Passos do processo:
1. <passo 1>
2. <passo 2>
3. <onde salvar / formato final>

Crie o arquivo em .claude/skills/ e me diga como invocá-la.

Conceptos clave

Qué es

Las skills viven en un directorio del proyecto llamado .claude/skills. La organización es simple: cada skill está en su propia carpeta, y dentro de ella hay un archivo de skill que describe lo que hace. El agente recorre esa carpeta y expone cada skill como un slash command — un comando que empieza con / y que escribes para activarla.

Por qué aprender

Entender el lugar y el mecanismo acaba con la magia: una skill no es una función oculta de la IA, es un archivo en una carpeta que se convierte en comando. Cabe destacar la unificación reciente: los slash commands se unificaron en skills — es decir, crear una skill y crear un slash command se convirtieron en lo mismo. Por eso, comparar con built-ins como /clear ayuda: la única diferencia es que los tuyos los defines tú, en el proyecto.

Ciclo de vida de una skill

Conceptos clave

Qué es

Toda skill tiene cuatro partes esenciales: nombre (cómo se llama), descripción (o disparador — le enseña al agente CUÁNDO usar la skill), argumentos esperados (las entradas que recibe) y las instrucciones paso a paso (qué hacer). La pieza más subestimada es la descripción: no es decorativa; es lo que hace que el agente decida por sí solo que esa skill es la adecuada para la situación.

---
name: <nome-da-skill>
description: <quando-acionar — ex.: rascunhar um e-mail a partir de bullets>
---

# <Título da skill>

## Argumentos
- destinatario: <quem recebe>
- tom: <profissional | casual>
- bullets: <pontos-chave do e-mail>

## Passos
1. Leia os <bullets> e o <tom>.
2. Escreva um e-mail polido, conciso, sem enrolação.
3. Salve em temporary/<nome-arquivo>.md

Por qué aprender

Conocer la anatomía te da control incluso sin escribir: sabes pedir una buena descripción que active el agente ("úsalo cuando pegue viñetas de correo electrónico"), nombrar argumentos claros y enumerar los pasos en el orden correcto. Y sabes revisar lo que generó el agente: si la descripción es poco clara, solo tienes que pedir que la haga más específica. La estructura frontmatter (nombre + descripción) + cuerpo (argumentos + pasos) es el esqueleto de toda skill.

Conceptos clave

Qué es

Una skill no reemplaza las tools (herramientas) — ella las orquesta. Dentro de tus pasos, una skill aún puede activar tools: scripts en Python que buscan en la web, extraen datos de una página o generan un documento. Es decir, el WAT permanece intacto por debajo: la skill es el W (workflow), la tool es el T (herramienta), y el agente decide cuándo ejecutar cada tool durante el proceso.

Por qué aprender

Saber que skill ≈ W y tool ≈ T evita una confusión común: creer que adoptar skills descarta todo lo que aprendiste sobre tools y MCP. No es así. La skill solo da un guion reutilizable sobre cuándo y cómo usar tus herramientas. Una skill de "investigación de mercado", por ejemplo, puede decir: busca en la web, extrae el contenido de las tres primeras páginas, haz un resumen y genera un documento — llamando a una tool en cada paso.

Conceptos clave

Qué es

No todo merece convertirse en una skill. La regla: crea una skill cuando el proceso se repite, la consistencia importa, las instrucciones son complejas o fáciles de olvidar, o quieres compartirla con el equipo. Para lo demás —una tarea de una frase, una experimentación inicial, una instrucción sencilla— es más rápido simplemente escribirlo. Empaquetar una tarea trivial en una skill solo agrega ceremonia.

Por qué aprender

El criterio evita los dos extremos: nunca usar skills (y tener que volver a explicarlo todo cada vez) o convertir cualquier cosa en una skill (y llenar la carpeta de comandos que usas una sola vez). La pregunta clave es sencilla: "¿voy a repetir esto?" Si es así y la consistencia importa, conviene usar una skill. Si es algo puntual, escríbelo.

Conceptos clave

Qué es

La división del trabajo: el CLAUDE.md guarda solo lo que sirve para cada sesión — propósito del proyecto, objetivo, framework, reglas generales. Está siempre en el contexto. En cambio, lo que es por tarea (por tarea) va a skills, que cargan bajo demanda — solo cuando invocas ese comando. Es la diferencia entre «lo que la IA necesita saber siempre» y «lo que solo necesita cuando va a hacer X».

Diagrama ilustrativo — poner todo en CLAUDE.md llena el contexto fijo; mantener el contenido por tarea en skills deja decenas de comandos disponibles sin ocupar espacio, porque solo se carga el que invocas.

Por qué aprender

El error clásico de principiante es meter todo en CLAUDE.md — toda instrucción, todo workflow, cada detalle. Eso se desborda el contexto: el archivo se vuelve enorme, ocupa espacio en cada sesión y reduce la atención de la IA. La clave de las skills es precisamente esta: puedes tener 20, 50 skills sin sobrecargar nada, porque solo se cargan cuando se invocan. CLAUDE.md conciso + muchas skills bajo demanda > CLAUDE.md gigante.

Conceptos clave

Qué es

Como una skill es solo un archivo en una carpeta del proyecto, hereda todas las ventajas de un archivo de código: puede ser con control de versiones en Git (historial de cambios, revisión, revertir), y compartida con cualquier persona que clone el proyecto. El proceso deja de ser conocimiento atrapado en la cabeza de una persona y se convierte en un activo del equipo.

Por qué aprender

Este es el salto de «truco personal» a «capacidad del equipo». Cuando tu mejor workflow se convierte en una skill versionada, cualquier colega puede ejecutar el mismo proceso, con la misma calidad, sin tener que preguntarte cómo. Las correcciones de errores en la skill benefician a todos en la siguiente invocación. Es reutilización de verdad: lo escribes una vez y todo el equipo se beneficia.

Conceptos clave