Convierte un documento en un SKILL.md

Qué escribe el conversor

Una skill es una carpeta con un archivo obligatorio, SKILL.md. El archivo empieza con un bloque corto de YAML (el frontmatter) y sigue con tus instrucciones en Markdown. El formato abierto Agent Skills pide dos campos en ese bloque:

• name: de 1 a 64 caracteres, letras minúsculas, números y guiones, sin guion al principio ni al final y sin dos guiones seguidos. Debe coincidir con el nombre de la carpeta.
• description: de 1 a 1024 caracteres sobre qué hace la skill y cuándo usarla.

El conversor crea el nombre a partir del primer título de tu documento, redacta una descripción con la primera frase, limpia las viñetas y agrega un título si el documento no tiene. Edita cualquiera de los dos campos; el archivo se actualiza mientras escribes. Las reglas de Anthropic suman dos más: un nombre no puede contener “anthropic” ni “claude”, y ningún campo puede tener etiquetas XML. El conversor comprueba las dos.

Dónde poner el archivo

• Claude (web y escritorio): en Personalizar, abre la sección de skills, haz clic en + y elige crear una skill subiendo un archivo; luego selecciona el .zip. Contiene la carpeta con SKILL.md dentro, la forma que pide Claude. La ejecución de código debe estar activada.
• Claude Code: descomprímelo en ~/.claude/skills/ para ti, o en .claude/skills/ dentro de un repositorio para todos los que lo clonen.
• Codex, Cursor, OpenCode: cada uno lee las carpetas de skills desde su propio lugar; la guía de sincronización los enumera.

Cada copia que pones a mano es una copia que alguien tiene que actualizar a mano. Ese es el trabajo del que se encarga AI Skill Pod.

Escribe una descripción que la IA use

La IA solo ve el nombre y la descripción de cada skill hasta que una encaja con la solicitud, así que la descripción decide si tu skill se abre alguna vez. Tres hábitos ayudan:

• Empieza por lo que hace: “Redacta respuestas de reembolso con el tono de nuestro soporte.”
• Luego di cuándo: “Úsala cuando un cliente pida un reembolso, una devolución o un contracargo.”
• Nombra las palabras que la gente escribe: nombres de productos, tipos de archivo, los términos propios del equipo.