--- name: prompt-to-skill description: Convierte un prompt o un chat que funcionó bien en un SKILL.md reutilizable que un equipo puede compartir - un nombre válido, una descripción que dice qué hace y cuándo usarla, las entradas, pasos numerados con reglas de decisión, una plantilla de salida, un ejemplo completo y comprobaciones - siguiendo el formato Agent Skills. Úsala cuando alguien dice “guarda esto como skill”, “haz esto reutilizable”, “convierte mi prompt en una skill”, quiere compartir un prompt con su equipo o pregunta cómo escribir un SKILL.md para Claude, ChatGPT o un agente de programación. --- # De prompt a skill Un buen prompt vive en el historial de chat de una persona; una skill permite que todo el equipo obtenga el mismo resultado. El formato Agent Skills es una carpeta con un SKILL.md: un encabezado (front matter) con `name` y `description`, y después las instrucciones. La IA solo lee el nombre y la descripción hasta que una tarea encaja, así que la descripción decide si la skill se usa alguna vez, y el cuerpo solo necesita lo que la IA no haría por defecto. ## Cuándo usarla - Un prompt o una conversación dio un resultado que alguien quiere repetir. - Varias personas de un equipo escriben cada una su versión del mismo prompt. - Hay que convertir un documento largo de “plantilla de prompt” en algo que una IA pueda usar por su cuenta. - No sirve para preguntas puntuales ni para tareas que la IA ya hace bien con una petición de una línea. ## Qué necesitas - El prompt, o la conversación en la que funcionó, con las correcciones que fuiste dando por el camino. Las correcciones son lo valioso. - 1 o 2 ejemplos de salidas que te gustaron. - Quién va a usar la skill y en qué herramientas. Si no se sabe, escribe para cualquier IA y evita funciones propias de una herramienta. ## Pasos 1. **Encuentra la parte reutilizable.** Separa lo fijo (el procedimiento, el formato, las reglas, las correcciones que diste) de lo que cambia cada vez (las entradas). Lo que cambia pasa a “Qué necesitas”. 2. **Ponle nombre.** Letras minúsculas, números y guiones, 64 caracteres o menos, igual que el nombre de la carpeta; sin “claude” ni “anthropic”. Mejor lo que hace: `weekly-client-report`, `processing-invoices`. Evita nombres vagos (`helper`, `utils`). 3. **Escribe la descripción.** En tercera persona, menos de 1024 caracteres, sin etiquetas XML. Di qué hace y luego “Úsala cuando...” con las palabras que de verdad escribiría un usuario (“resumen”, “seguimiento”, “acta”). Esto es con lo que la IA compara la petición; las descripciones vagas (“Ayuda con documentos”) nunca se activan. 4. **Escribe los pasos.** Numerados, cada uno con un nombre corto y una regla concreta. Quédate solo con las instrucciones que cambian la salida: las correcciones que hiciste en el chat, los umbrales, las decisiones del tipo “si X, haz Y”. Quita las explicaciones que la IA ya conoce. 5. **Agrega la plantilla de salida y un ejemplo.** Una plantilla entre bloques de código con [marcadores], y después una entrada realista con su salida completa. Un ejemplo concreto enseña el formato mejor que párrafos de descripción. 6. **Agrega comprobaciones.** De 4 a 7 comprobaciones verificables que la IA hace antes de responder (“Cada tarea tiene un responsable”), no deseos (“es de alta calidad”). 7. **Pruébala con entradas nuevas.** Ejecútala en un chat nuevo con 3 entradas reales distintas, incluido un caso incómodo. Corrige en la skill lo que salió mal y vuelve a ejecutarla. Mantén el cuerpo por debajo de 500 líneas; las nuestras apuntan a bastante menos de 200. ## Formato de salida ````markdown --- name: [nombre-en-minusculas-con-guiones] description: [Qué hace, en tercera persona]. Úsala cuando [situaciones y las palabras que escriben los usuarios]. --- # [Título] [1–3 frases: qué logra una buena salida y el principio que hay detrás.] ## Cuándo usarla - [Situación] - No sirve para [tarea cercana que no debe cubrir]. ## Qué necesitas - [Entrada] — si falta, [pregunta una vez / sigue y marca “[supuesto]”]. ## Pasos 1. **[Nombre del paso].** [Instrucción concreta con una regla de decisión.] ## Formato de salida ```markdown [Plantilla con [marcadores]] ``` ## Ejemplo **Entrada:** [entrada realista] **Salida:** [salida completa] ## Comprobaciones antes de enviar - [ ] [Comprobación verificable] ```` ## Ejemplo **Entrada:** “Siempre pego esto en ChatGPT: «Aquí van mis notas de una llamada con un cliente. Escribe un correo de seguimiento: agradécele, resume lo que acordamos, enumera los siguientes pasos con fechas, menos de 150 palabras, sin palabras de moda, termina con una pregunta clara». Normalmente tengo que recordarle que use las palabras del propio cliente y que no invente fechas.” **Salida:** ````markdown --- name: call-follow-up-email description: Escribe un correo de seguimiento breve después de una llamada con un cliente a partir de notas sueltas - agradecimiento, resumen de lo acordado, siguientes pasos con responsables y fechas, y una pregunta de cierre, en menos de 150 palabras. Úsala cuando alguien comparte las notas de una llamada y pide un correo de seguimiento, un correo de resumen o “mándales un resumen”. --- # Correo de seguimiento de una llamada Un seguimiento confirma lo acordado mientras la llamada está fresca, para que nada se desvíe. Que sea corto, con las palabras del propio cliente, y que termine con una pregunta que haga avanzar las cosas. ## Cuándo usarla - Después de una llamada de ventas o con un cliente, a partir de notas o de una transcripción. - No sirve para un correo en frío a alguien con quien no has hablado. ## Qué necesitas - Las notas de la llamada. Si faltan las fechas de los siguientes pasos, escribe “fecha por confirmar” en lugar de inventar una. - El nombre del cliente y su empresa. ## Pasos 1. **Resume solo lo acordado.** Usa las palabras del propio cliente para sus objetivos y sus términos. 2. **Enumera los siguientes pasos.** Cada uno con un responsable y una fecha sacada de las notas, o “fecha por confirmar”. 3. **Termina con una pregunta.** La única respuesta que necesitas para avanzar. 4. **Recorta a 150 palabras.** Sin palabras de moda; una idea por frase. ## Formato de salida ```markdown Asunto: [Empresa] — siguientes pasos de la llamada del [día] Hola, [nombre]: Gracias por [algo concreto]. En resumen, acordamos [1–2 líneas]. Siguientes pasos: - [Responsable]: [paso] antes del [fecha o “fecha por confirmar”] ¿[Una pregunta]? [Firma] ``` ## Ejemplo **Entrada:** “Llamada con Inés, de Portwell. Quieren reducir el tiempo de onboarding. Acordamos un piloto de 2 semanas. Yo envío el plan del piloto el viernes. Necesito saber quién es su administrador.” **Salida:** Asunto: Portwell — siguientes pasos de la llamada de hoy Hola, Inés: gracias por explicarme cómo hacen el onboarding en Portwell. En resumen, acordamos un piloto de 2 semanas centrado en reducir el tiempo de onboarding. Siguientes pasos: - Yo: enviar el plan del piloto antes del viernes - Portwell: designar un administrador para el piloto, fecha por confirmar ¿A quién configuro como administrador de Portwell? ## Comprobaciones antes de enviar - [ ] Menos de 150 palabras. - [ ] Cada fecha sale de las notas o dice “fecha por confirmar”. - [ ] Termina exactamente con una pregunta. - [ ] Usa los términos del cliente, no los nuestros. ```` ## Comprobaciones antes de enviar - [ ] El nombre está en minúsculas con guiones, tiene 64 caracteres o menos y no contiene “claude” ni “anthropic”. - [ ] La descripción está en tercera persona, dice qué hace, incluye “Úsala cuando” y tiene menos de 1024 caracteres, sin etiquetas XML. - [ ] Cada corrección del chat original aparece como un paso o una comprobación. - [ ] La skill tiene una plantilla de salida y un ejemplo completo. - [ ] Se probó con 3 entradas nuevas, y las correcciones se incorporaron a la skill. ## Errores comunes - Copiar el prompt tal cual. Convierte los recordatorios que tuviste que dar (“no inventes fechas”) en pasos; eso es lo que aporta la skill. - Explicar cosas que la IA ya sabe (“un correo es un mensaje...”). Cada línea consume contexto; quédate con las que cambian la salida. - Una descripción que dice qué hace pero no cuándo. La IA no puede elegir una skill que no puede relacionar con la petición.