Toda skill nace del mismo ciclo: tú describe el workflow en lenguaje natural, el el agente genera el SKILL.md en el formato oficial, se convierte en un slash command (p. ej., /draft-email), y a partir de ahí tú vuelve a usar — de preferencia con el contexto limpio, para que cada ejecución sea predecible.

Diagrama ilustrativo — el recuadro azul es el agente escribiendo el SKILL.md. Construir se hace una vez; reutilizar, para siempre. El lazo punteado representa la reutilización con /clear entre ejecuciones.

Qué es

Crear una skill comienza con una buena solicitud. Tú describe el workflow — cuáles son las entradas, cuál es el comportamiento esperado, y dónde guardar el resultado —y le pide al agente que lo convierta en un slash command siguiendo el formato oficial de skill. Es la misma mentalidad del vibe coding: tú dices el «qué» y el agente escribe el SKILL.md (el «cómo»).

Una buena solicitud es específica en las tres dimensiones. Si es demasiado vaga («haz una skill de correo electrónico»), obliga al agente a adivinar; si es demasiado específica sobre los pasos técnicos («crea un archivo .md con YAML frontmatter que contenga…»), desperdicia la ventaja de dejarlo elegir. El punto justo: describe las entradas, el comportamiento y el destino, y deja que se encargue del resto.

Entre em Plan Mode.

Quero uma skill que .
- Entradas: 
- Comportamento: 
- Onde salvar: 

Crie isso como um slash command seguindo o formato
oficial de skill (SKILL.md com nome, descrição e
instruções). Me mostre o plano antes de gravar.

Por qué aprender

Una solicitud en el formato oficial garantiza que la skill nazca reutilizable, con nombre, descripción e instrucciones que el agente volverá a leer cada vez que la invoques. Pedirla en Plan Mode te da un punto de revisión: corriges el alcance antes de que se convierta en un archivo.

Conceptos clave

Qué es

Vamos a construir la primera skill de verdad: /draft-email. Recibe tres entradas: los viñetas del contenido, el destinatario e o tono — y escribe un correo pulido y conciso, sin rodeos (fluff). El borrador se guarda en una carpeta temporal y todo el procedimiento se convierte en el comando /draft-email.

---
name: draft-email
description: Rascunha um e-mail polido a partir de
  bullets, destinatário e tom. Use quando o usuário
  pedir para escrever ou rascunhar um e-mail.
---

# Rascunhar e-mail

## Entradas
- destinatário: para quem é o e-mail
- tom: 
- bullets: os pontos a cobrir

Se faltar alguma entrada, PERGUNTE antes de escrever.

## Comportamento
1. Escreva um e-mail conciso e polido, sem fluff.
2. Respeite o tom pedido; assunto curto e claro.
3. Salve o rascunho em /email.md.

Por qué aprender

El correo electrónico es el ejemplo perfecto de tarea repetitiva y estandarizable: escribes decenas por semana y todos siguen la misma estructura. Encapsular esto en una skill significa que el «cómo escribir bien» queda en el SKILL.md, y tú solo proporcionas el contenido. Constrúyelo una vez y ahorra tiempo para siempre.

Conceptos clave

Qué es

La prueba de robustez de una buena skill: llama a /draft-email sin enviar ningún dato. En vez de ejecutarse a ciegas e inventar un destinatario y un tono, la skill debe preguntar sobre los datos que faltan —destinatario, tono, bullets— antes de escribir una sola línea. Esa instrucción de SKILL.md ("si falta algún dato, PREGUNTA") es lo que garantiza eso.

Diagrama ilustrativo — invocar sin datos no es un error: activa la recopilación. La skill solo escribe después de tener las tres entradas.

Por qué aprender

Las skills que preguntan antes de ejecutarse evitan la peor pesadilla de la automatización: un resultado plausible pero incorrecto, basado en suposiciones. Cuando la skill recopila lo que falta, tú controlas la entrada y nunca recibes un correo dirigido a la persona equivocada y con el tono equivocado.

Você:
/draft-email

Skill (esperado):
Para escrever o e-mail, preciso de:
1) Para quem é? 
2) Qual o tom? 
3) Quais pontos cobrir? 

(a skill NÃO escreve nada até você responder)

Conceptos clave

Qué es

El verdadero retorno de crear una skill se ve al reutilizarla. Para reutilizarla bien, dale /clear (limpia la conversación) y llama a /draft-email de nuevo con nuevas entradas. El resultado: una salida fresca y consistente, siguiendo las mismas reglas del SKILL.md, sin que la basura de la conversación anterior contamine el nuevo correo.

Por qué aprender

Sin un contexto limpio, el tercer correo del día puede heredar el tono del primero o mencionar al destinatario equivocado. Limpiar antes de cada reutilización hace que cada ejecución previsible — la skill aplica siempre las mismas reglas, partiendo siempre del mismo punto.

/clear

/draft-email
destinatário: 
tom: 
bullets:
- 
- 
- 

Conceptos clave

Qué es

Una skill más ambiciosa, pero construida del mismo modo: documento → diapositivas. Lee un documento, extrae los puntos clave y crea una presentación profesional usando herramientas Python. El documento de entrada queda en temporary/resources y la presentación generada sale en temporary/outputs — carpetas organizadas, entrada separada de salida.

Crie uma skill chamada  que:
- Lê um documento de temporary/resources/
- Extrai os pontos-chave do conteúdo
- Cria uma apresentação profissional usando
  ferramentas Python
- Salva o resultado em temporary/outputs/

Faça no formato oficial (slash command). Se faltar
o arquivo de entrada, PERGUNTE qual usar.

Por qué aprender

Esta skill muestra que el mismo patrón escala: entradas claras, comportamiento descrito, destino definido — ahora con el agente escribiendo código Python por debajo. No necesitas saber Python; necesitas describir el resultado. Y la separación resources/outputs mantiene el proyecto limpio y la skill reutilizable con cualquier documento.

Conceptos clave

Qué es

Skills se componen. En vez de describir cada detalle visual de tu presentación, tú apila una skill de diseño ya existente sobre la skill doc-to-slides. La skill de diseño carga las reglas de tipografía, colores y espaciado; tu skill se encarga del contenido. El resultado mejora visualmente sin que te conviertas en diseñador.

Diagrama ilustrativo — agregar una skill de diseño no reemplaza la tuya; cada una cubre una responsabilidad y juntas mejoran el resultado.

Por qué aprender

La composición es lo que hace que tu biblioteca de skills valga más que la suma de sus partes. Una skill de diseño lista para usar se convierte en un "tema" que puedes integrar en cualquier skill que genere un artefacto visual. Reutilizas conocimiento de diseño que ni siquiera es tuyo — y el resultado parece hecho por un especialista.

Conceptos clave

Qué es

Ahora que sabes construir, probar, invocar y reutilizar, el paso final es acumular: crear tu biblioteca de skills. Cada skill es una tarea repetitiva tuya, encapsulada una sola vez. Abajo encontrarás un catálogo de ideas listas, no para copiar, sino para que te sirvan de punto de partida de tu propia colección.

Catálogo de puntos de partida

El ciclo de vida de una skill

Por qué aprender

Una biblioteca de skills es capital que genera intereses: cada skill que creas ahorra tiempo en cada ejecución futura, y las buenas skills se combinan en flujos más grandes. Empieza poco a poco —con una o dos skills para tus tareas más repetitivas— y deja que la colección crezca con el uso.

Conceptos clave