/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:
- Identificar input y modo — gate de "¿amerita un skill?", colisión de nombres, SOP nuevo vs modernizar
- Diseñar el skill con el usuario — recomendar y confirmar 5 decisiones (triggers, herramientas, pausas, ejemplo, plan)
- Mapear pasos del SOP — extraer y numerar los pasos reales
- Separar referencias y scripts — qué va a
references/, qué a scripts/, y qué se sanitiza
- Generar archivos — escribir todos los
.md y .ts
- Detectar huecos y reportar —
[FALTA: ...] y mapeo SOP → archivos
- Validar e instalar — probar que dispare solo, no solo con el slash
- 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:
SKILL.md completo (índice).
- Cada
steps/<n>-<slug>.md como archivo separado.
- Cada
references/<tema>.md como archivo separado.
- Cada
scripts/<nombre>.ts como archivo separado (si aplica).
- Tabla "sección del SOP original → archivo en el skill".
- Lista de huecos detectados (
[FALTA: ...]) que el usuario debe completar.
1---2name: agentiza3description: Convierte un SOP, documento de proceso, transcripción de Loom, o descripción de cómo haces algo a mano en un Claude Code skill modular y bien estructurado (SKILL.md como índice + steps/ + references/ + scripts/). Recomienda y confirma en vez de un cuestionario en frío, detecta huecos en el SOP, valida que el skill dispare solo, y enseña el bucle de mejora. El core es markdown puro: portable a Codex, Cursor y Gemini, no solo Claude Code. También sirve para MODERNIZAR skills monolíticos que ya pasaron las 200 líneas. Use when: "agentiza", "agentizar", "convertir SOP en agente", "modernizar skill", "crear skill", "modularizar skill", "skill nuevo", "/agentiza".4---56# /agentiza — De SOP a Agente Prompt78Skill para convertir cualquier proceso documentado (SOP, Loom, notas, descripción verbal) en un **Claude Code skill modular** siguiendo la estructura:910```11mi-skill/12 SKILL.md # índice máximo 100 líneas13 steps/<n>-<slug>.md # un archivo por paso14 references/<tema>.md # lo que no cambia: esquemas, tono, catálogos15 scripts/<nombre>.ts # código ejecutable (no embebido en markdown)16```1718También sirve para **modernizar skills viejos** que crecieron sin estructura.1920---2122## Flujo2324Lee cada paso solo cuando llegues a él:25261. [Identificar input y modo](steps/1-identificar-input.md) — gate de "¿amerita un skill?", colisión de nombres, SOP nuevo vs modernizar272. [Diseñar el skill con el usuario](steps/2-preguntas-guiadas.md) — recomendar y confirmar 5 decisiones (triggers, herramientas, pausas, ejemplo, plan)283. [Mapear pasos del SOP](steps/3-mapear-pasos.md) — extraer y numerar los pasos reales294. [Separar referencias y scripts](steps/4-separar-referencias-scripts.md) — qué va a `references/`, qué a `scripts/`, y qué se sanitiza305. [Generar archivos](steps/5-generar-archivos.md) — escribir todos los `.md` y `.ts`316. [Detectar huecos y reportar](steps/6-detectar-huecos.md) — `[FALTA: ...]` y mapeo SOP → archivos327. [Validar e instalar](steps/7-validar-e-instalar.md) — probar que **dispare solo**, no solo con el slash338. [Enseñar el bucle de mejora](steps/8-improvement-loop.md) — la v1 es un borrador; MAA sobre el propio skill3435## Referencias3637- [`references/reglas-duras.md`](references/reglas-duras.md) — las 7 reglas no negociables del patrón38- [`references/frontmatter.md`](references/frontmatter.md) — los campos que existen y cuál decide si el skill se usa39- [`references/portabilidad.md`](references/portabilidad.md) — que el skill corra en cualquier harness (Codex, Cursor, Gemini)40- [`references/composicion.md`](references/composicion.md) — skills que llaman a otros skills41- [`references/versionado.md`](references/versionado.md) — cómo se mantiene y se depreca un skill42- [`references/idioma-y-tono.md`](references/idioma-y-tono.md) — español de México, sin voseo, sin relleno43- [`references/anti-patrones.md`](references/anti-patrones.md) — qué NO hacer al estructurar un skill4445## Plantillas4647- [`templates/SKILL.md.tpl`](templates/SKILL.md.tpl) — template del índice48- [`templates/step.md.tpl`](templates/step.md.tpl) — template de un paso49- [`templates/reference.md.tpl`](templates/reference.md.tpl) — template de un archivo de referencia5051---5253## Cómo se invoca5455```56/agentiza57```5859Luego 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.6061## Salida esperada6263Al final del flujo, el usuario recibe:64651. `SKILL.md` completo (índice).662. Cada `steps/<n>-<slug>.md` como archivo separado.673. Cada `references/<tema>.md` como archivo separado.684. Cada `scripts/<nombre>.ts` como archivo separado (si aplica).695. Tabla "sección del SOP original → archivo en el skill".706. Lista de huecos detectados (`[FALTA: ...]`) que el usuario debe completar.7172<!--73Fuente: patrón de skills modulares de GNB Labs, formalizado el 2026-05.74Última revisión: 2026-08-13 — se agregaron el paso 8 (bucle de mejora, MAA sobre75el skill), la referencia de portabilidad y la regla dura 7; el paso 2 pasó a76recomendar-y-confirmar con ejemplo horneado. Cambios inspirados en bm-skills77(skill-builder de Brian Casel). Antes (2026-07-26): paso 7 y refs de78frontmatter/composición/versionado.79Revisar cuando: cambien los campos de frontmatter que soporta el harness, o80cuando el límite de 100 líneas del SKILL.md deje de ser el criterio.81-->