/agentiza — De SOP a Agente Prompt

Skill para convertir cualquier proceso documentado (SOP, Loom, notas, descripción verbal) en un Claude Code skill modular siguiendo la estructura:

mi-skill/
  SKILL.md              # índice máximo 100 líneas
  steps/<n>-<slug>.md   # un archivo por paso
  references/<tema>.md  # lo que no cambia: esquemas, tono, catálogos
  scripts/<nombre>.ts   # código ejecutable (no embebido en markdown)

También sirve para modernizar skills viejos que crecieron sin estructura.

Flujo

Lee cada paso solo cuando llegues a él:

1. Identificar input y modo — gate de "¿amerita un skill?", colisión de nombres, SOP nuevo vs modernizar
2. Diseñar el skill con el usuario — recomendar y confirmar 5 decisiones (triggers, herramientas, pausas, ejemplo, plan)
3. Mapear pasos del SOP — extraer y numerar los pasos reales
4. Separar referencias y scripts — qué va a references/, qué a scripts/, y qué se sanitiza
5. Generar archivos — escribir todos los .md y .ts
6. Detectar huecos y reportar — [FALTA: ...] y mapeo SOP → archivos
7. Validar e instalar — probar que dispare solo, no solo con el slash
8. Enseñar el bucle de mejora — la v1 es un borrador; MAA sobre el propio skill

Referencias

• references/reglas-duras.md — las 7 reglas no negociables del patrón
• references/frontmatter.md — los campos que existen y cuál decide si el skill se usa
• references/portabilidad.md — que el skill corra en cualquier harness (Codex, Cursor, Gemini)
• references/composicion.md — skills que llaman a otros skills
• references/versionado.md — cómo se mantiene y se depreca un skill
• references/idioma-y-tono.md — español de México, sin voseo, sin relleno
• references/anti-patrones.md — qué NO hacer al estructurar un skill

Plantillas

• templates/SKILL.md.tpl — template del índice
• templates/step.md.tpl — template de un paso
• templates/reference.md.tpl — template de un archivo de referencia

Cómo se invoca

/agentiza

Luego pega el SOP, Loom transcript, notas, o el SKILL.md monolítico que quieres modernizar. El skill arranca con las 3 preguntas guiadas y entrega los archivos.

Salida esperada

Al final del flujo, el usuario recibe:

1. SKILL.md completo (índice).
2. Cada steps/<n>-<slug>.md como archivo separado.
3. Cada references/<tema>.md como archivo separado.
4. Cada scripts/<nombre>.ts como archivo separado (si aplica).
5. Tabla "sección del SOP original → archivo en el skill".
6. Lista de huecos detectados ([FALTA: ...]) que el usuario debe completar.