Casi todas las skills que veo instaladas nunca se activan. Están ahí, bien escritas, con buenas intenciones, y Claude las ignora porque la descripción no coincide con cómo la persona pide realmente la tarea.
La otra mitad sí se activa y produce algo genérico, porque las instrucciones son un párrafo de buenos deseos en vez de un procedimiento.
Escribir una skill que aguante uso diario no es difícil, pero sí es específico. Si lo que buscas es instalar tu primera en diez minutos, empieza por ahí. Esta guía es sobre cómo se escribe una que no tengas que corregir cada semana.
Las tres capas
Toda skill opera en tres niveles distintos, y confundirlos es de donde salen casi todos los problemas.
Capa 1: el disparador. El nombre y la descripción. Claude los revisa en cada conversación que tienes, siempre. Tienen que ser lo bastante específicos para activarse cuando corresponde y lo bastante acotados para no activarse cuando no.
Capa 2: las instrucciones. Se cargan solo cuando la skill se dispara. Aquí van los pasos numerados, las reglas y el formato de salida. Es un procedimiento, no una explicación.
Capa 3: los archivos de referencia. Opcionales y se leen solo cuando la tarea los pide. Guía de voz, plantillas, listas de producto, ejemplos largos. Viven en la misma carpeta y el SKILL.md nada más dice cuándo abrirlos.
La razón de esta separación es práctica: si metes tu guía de marca de dos mil palabras dentro de las instrucciones, se carga completa cada vez que la skill se activa, aunque la tarea sea de dos líneas.
La descripción es el 80% del trabajo
Es lo único que Claude lee para decidir si usa la skill. Tiene que responder dos cosas: qué hace y cuándo usarla.
Débil: "Ayuda con tareas de escritura y contenido." No dice cuándo. Nunca se va a disparar.
Fuerte: "Reescribe correos para que suenen profesionales y directos. Úsala cuando el usuario pida mejorar, reescribir, arreglar, corregir o pasar en limpio un correo. NO la uses para redactar desde cero ni para resumir hilos."
Tres reglas para escribirla:
- Usa tus verbos, no los elegantes. Si tú dices "acomódame esto", la palabra "acomodar" tiene que estar en la descripción. Es una lista de tus frases reales, no un resumen de la funcionalidad.
- Siempre incluye el "NO la uses para". Delimitar es lo que evita que se active en conversaciones que no le tocan, y eso importa más conforme instalas más skills.
- Nombra el objeto. "Correo", "reporte semanal", "notas de junta", "publicación de LinkedIn". Los sustantivos disparan mejor que los adjetivos.
Las instrucciones se escriben como procedimiento
Pasos numerados, acciones concretas, cero explicaciones de por qué. Claude no necesita que lo convenzas, necesita que le digas qué hacer y en qué orden.
Lo que debe traer una buena sección de instrucciones:
- Qué preguntar si falta información, y qué asumir si no vale la pena preguntar.
- Los pasos en orden. Numerados.
- El formato exacto de salida. Secciones, largo, si lleva viñetas o prosa.
- Las prohibiciones. Las palabras que no usas, las estructuras que odias, lo que nunca debe aparecer.
- Un ejemplo real de salida perfecta. Uno solo, tuyo, de verdad.
Ese último punto es el que más rinde por palabra escrita. Un ejemplo concreto le enseña más que tres párrafos describiendo el estilo que quieres, porque el estilo está lleno de decisiones que no sabes que estás tomando.
El paso que todo mundo se salta: escribir las prohibiciones. Es más fácil describir lo que quieres que lo que no soportas, pero lo segundo es lo que de verdad hace que la salida suene tuya. Abre tres cosas que Claude te haya escrito y anota qué le corregiste siempre. Esa lista es la sección de prohibiciones.
Un ejemplo completo de operación
Esta es la que más he replicado en empresas: convertir notas crudas de junta en decisiones y compromisos rastreables. El dolor que resuelve es real —que la junta pase y a la semana nadie recuerde quién se llevó qué.
---
name: cierre-de-junta
description: Convierte notas crudas o transcripciones de junta en un
cierre con decisiones, compromisos con responsable y fecha, y temas
abiertos. Úsala cuando el usuario pegue notas de junta, una
transcripción, o pida el resumen, la minuta o el cierre de una
reunión. NO la uses para agendas previas ni para resumir
documentos que no son juntas.
---
# Cierre de junta
## Instrucciones
1. Si no viene el nombre de la junta ni la fecha, pregúntalos. Nada
más eso: no pidas más contexto.
2. Lee todo antes de escribir. Separa mentalmente tres cosas:
lo que se decidió, lo que alguien se comprometió a hacer, y lo
que quedó sin resolver.
3. Escribe el cierre con estas cuatro secciones, en este orden:
DECISIONES
- Numeradas. Cada una en una frase, en pasado y en voz activa.
- Si una decisión revierte otra anterior que se menciona, dilo.
COMPROMISOS
- Uno por renglón: responsable, qué exactamente, para cuándo.
- Si no se dijo el responsable, escribe SIN DUEÑO. No lo adivines.
- Si no se dijo la fecha, escribe SIN FECHA. No la inventes.
TEMAS ABIERTOS
- Lo que se discutió y no se cerró, con qué falta para cerrarlo.
SEGUIMIENTO
- Qué debería estar en la agenda de la próxima junta.
4. Al final, una sola línea: cuántas decisiones, cuántos
compromisos, cuántos sin dueño y cuántos sin fecha.
## Reglas
- Nunca conviertas una opinión en decisión. Si alguien dijo "creo
que deberíamos", eso es tema abierto, no decisión.
- Nunca inventes responsables ni fechas. Marcarlo vacío es
información útil; adivinarlo es un error que alguien va a pagar.
- Si un compromiso se mencionó dos veces con detalles distintos,
lista los dos y marca la contradicción.
- Cero relleno. No escribas "se tuvo una productiva discusión".
## Ejemplo
[pega aquí un cierre real tuyo que haya quedado bien]Fíjate en las dos reglas de "no inventes". Son las que hacen que este documento se pueda usar para pedir cuentas. Una minuta con responsables inventados es peor que no tener minuta.
Cuándo partirla en archivos
La señal es simple: si las instrucciones no se leen en un minuto, algo debe salirse.
Lo que se saca a archivos de referencia: guías de voz y estilo largas, plantillas completas, catálogos de producto, listas de clientes, ejemplos extensos, cualquier cosa que se consulte pero no se ejecute. En el SKILL.md queda una línea que diga cuándo abrirlos, del tipo "para el tono, lee voz.md".
Lo que se queda siempre en el archivo principal: los pasos, las prohibiciones y el formato de salida.
El ciclo de prueba
- Chat nuevo, sin nombrarla. Pide la tarea como la pedirías un martes cualquiera. Si no se activa, el problema es la descripción y no las instrucciones.
- Pruébala con un caso incompleto. Dale notas a medias, sin fechas, con contradicciones. Ahí es donde se ve si las reglas aguantan o si empieza a inventar.
- Pruébala donde NO debería activarse. Pide algo parecido pero distinto. Si se dispara, la descripción está demasiado abierta.
- Corrige una cosa a la vez y vuelve a subirla. Cambiar descripción e instrucciones juntas te deja sin saber qué arregló qué.
Cómo saber cuáles construir
No hagas una lista de skills deseables. Nunca la vas a completar y las que salen de ahí son las que menos se usan.
Usa la regla de tres: cuando te descubras corrigiendo lo mismo por tercera vez, esa corrección ya es una skill. La tarea correcta no es la más impresionante, es la más repetida y la que ya sabes hacer bien —porque solo así puedes juzgar si la salida está mal.
Y una skill que se corrige cada semana durante un mes vale más que cinco que subiste el mismo día y nunca volviste a abrir.