bizagi-steroids

✨ Qué es

bizagi-steroids es un skill: un paquete de instrucciones y herramientas que le enseña a tu asistente de IA a modelar procesos para Bizagi Modeler. Le cuentas el proceso con tus palabras, igual que en una reunión, y te entrega:

• 📐 El diagrama BPMN 2.0 (.bpmn), listo para importar en Bizagi.
• 📄 El documento en Word: roles, actividades, decisiones, plazos y supuestos por validar. Puede ir con la plantilla de tu organización.
• 🖼️ Una vista previa del diagrama, para revisarlo sin abrir Bizagi.

🧭 Cómo funciona

flowchart LR
    A["🗣️ Tú describes el proceso<br/>en el chat"] --> B["🤖 Tu agente de IA<br/>lo interpreta"]
    B --> C["⚙️ bizagi-steroids<br/>genera los archivos en tu PC"]
    C --> D["📐 .bpmn"]
    C --> E["📄 Word"]
    D --> F["Bizagi Modeler<br/>Importar → BPMN"]

Tu agente de IA (Claude Code, Codex, OpenCode, Gemini o Cursor) entiende lo que dices. bizagi-steroids se ejecuta en tu computadora y genera el diagrama y el documento. No tienes que escribir código ni dibujar nada.

🧰 Qué necesitas

🚀 Instalación paso a paso

1. Instala Node.js

Descárgalo de nodejs.org: elige la versión LTS e instálalo con las opciones por defecto.

2. Instala Python

Descárgalo de python.org/downloads.

⚠️ En Windows, en la primera pantalla del instalador marca "Add python.exe to PATH" antes de pulsar Install Now. Si no lo marcas, el skill no encontrará Python.

3. Elige tu agente de IA

Si ya usas uno de estos, sáltate este paso:

Algunos tienen uso gratuito (por ejemplo, Gemini CLI con una cuenta de Google, u OpenCode con sus modelos gratuitos) y otros requieren una suscripción. Revisa los planes vigentes de cada uno. Con los modelos más simples, el agente a veces describe los pasos en vez de hacerlos: si te pasa, elige un modelo más capaz.

4. Abre una terminal

• Windows: abre el menú Inicio, escribe PowerShell y ábrelo.
• Mac: abre Terminal (Aplicaciones → Utilidades).

Comprueba que todo está instalado. Cada comando debe responder con un número de versión:

node --version
python --version

En Mac, si python no responde, prueba con python3 --version.

5. Instala bizagi-steroids

Copia este comando en la terminal y pulsa Enter:

npx -y github:kennedy122112/bizagi-steroids setup

Al terminar verás "bizagi instalado (bizagi-cli …)" y la lista de agentes donde quedó disponible. Un solo comando sirve para todos tus agentes a la vez.

6. Pide tu primer proceso

Abre tu agente de IA en una carpeta de trabajo (por ejemplo, Documentos\procesos) y escríbele:

Modela en Bizagi el proceso de compra de autopartes: almacén registra la solicitud, gerencia la aprueba o la rechaza, compras pide cotizaciones, elige proveedor y emite la orden; al llegar, almacén verifica y, si algo no está conforme, se coordina con el proveedor.

El agente crea una subcarpeta con el nombre del proceso, con el .bpmn, la vista previa y el Word, y te da las rutas.

7. Ábrelo en Bizagi

En Bizagi Modeler, ve a la pestaña Exportar/Importar → Importar → BPMN y elige el .bpmn.

⚠️ No uses Archivo → Abrir: esa opción solo abre archivos nativos .bpm y mostrará "The file is invalid or corrupt". Una vez importado, puedes guardarlo como .bpm con Archivo → Guardar.

Para actualizar más adelante, repite el paso 5 y abre una sesión nueva en tu agente.

💬 Ejemplos de pedidos

No hace falta un formato especial. Entiende muletillas, correcciones ("no, perdón, primero…"), abreviaturas y pedidos de una sola línea. Si falta algo importante, el agente pregunta; si le pides avanzar, completa con lo mínimo típico y lo anota como supuesto.

Con plazos, excepciones, documentos y sistemas, el resultado se ve así:

📄 El documento Word

Cada proceso trae su entregable, listo para revisar o firmar:

• una ficha con código, versión y responsables;
• el objetivo y los roles con sus actividades;
• el diagrama en una página horizontal (en A3 con páginas de detalle si es grande);
• la tabla de actividades con entradas, salidas y sistemas, y el flujo paso a paso;
• las reglas de decisión, las excepciones y plazos, los documentos y las interacciones con externos;
• los supuestos y puntos por validar.

Ejemplos: atencion-reclamos.docx · solicitud-compra.docx

Con la plantilla de tu organización

Pídele al agente "genera el Word con mi plantilla plantilla.docx". De tu plantilla se conserva todo: logo, carátula, encabezados y pies, control de versiones, firmas y estilos.

Opcionalmente, puedes escribir estos marcadores en tu plantilla:

Lo que no le hayas dicho al agente aparece como "Por completar". Hay una plantilla de ejemplo en plantilla-ejemplo.docx y su resultado en atencion-reclamos-plantilla.docx.

❓ Preguntas frecuentes

¿Cuesta algo? bizagi-steroids es gratuito y de código abierto (licencia MIT). Lo que puede tener costo es tu agente de IA, según el que elijas y su plan.

¿Mis datos salen de mi computadora? Los archivos (.bpmn, Word y vista previa) se generan en tu PC, y bizagi-steroids no se conecta a ningún servicio. Pero tu agente de IA envía lo que escribes en el chat al proveedor de su modelo (Anthropic, OpenAI, Google, etc.), como cualquier asistente de IA. Si el proceso tiene información sensible, revisa las políticas de tu organización y de tu proveedor.

¿Necesito saber programar? No. Solo necesitas copiar un comando para instalarlo; después todo se pide en lenguaje natural.

¿Funciona con mi versión de Bizagi? Se probó con Bizagi Modeler 4.1. Genera BPMN 2.0, el formato estándar que Bizagi importa, así que en otras versiones recientes debería funcionar igual.

¿Puedo modificar un proceso que ya tengo en Bizagi? Sí. Expórtalo desde Bizagi (Exportar/Importar → Exportar → BPMN), pásale el archivo al agente con los cambios que quieres y vuelve a importar el resultado.

¿En qué idioma funciona? Puedes describir el proceso en español o en inglés. El Word y los textos del diagrama salen en el idioma de tu descripción, aunque los títulos de las secciones del Word están en español.

🩺 Solución de problemas

⚠️ Limitaciones

• No lee el archivo nativo .bpm de Bizagi: hay que exportar el modelo a BPMN.
• Los subprocesos se generan contraídos.
• Un plazo que abarca varias actividades (por ejemplo, un SLA) se adjunta a una actividad y se explica en una nota.

🛠️ Para desarrolladores

Otras formas de instalar

Como plugin de Claude Code:

/plugin install bizagi --marketplace kennedy122112/bizagi-steroids

O desde la terminal: claude plugin marketplace add kennedy122112/bizagi-steroids y claude plugin install bizagi@bizagi-steroids.

Como plugin de Codex: codex plugin marketplace add kennedy122112/bizagi-steroids y codex plugin add bizagi@bizagi-steroids.

Sin Node, con git:

irm https://raw.githubusercontent.com/kennedy122112/bizagi-steroids/main/install.ps1 | iex

curl -fsSL https://raw.githubusercontent.com/kennedy122112/bizagi-steroids/main/install.sh | bash

Usa un solo método por agente, para no cargar el skill dos veces.

Dónde se instala

npx … setup y los scripts dejan una copia en ~/.bizagi-steroids y la enlazan donde la busca cada agente:

Para ver el estado: npx -y github:kennedy122112/bizagi-steroids status. Para desinstalar: npx -y github:kennedy122112/bizagi-steroids uninstall. Las instalaciones previas se respaldan en la carpeta temporal, no se borran.

Si tu agente no soporta skills, añade a tu AGENTS.md: "Para modelar procesos de Bizagi, sigue las instrucciones de ~/.agents/skills/bizagi/SKILL.md."

Comandos

La herramienta también se usa sin agente (python skills/bizagi/scripts/bizagi_cli.py <comando>):

Solo usa la biblioteca estándar de Python 3.9+. El formato de la spec y las reglas de modelado están en SKILL.md.

Elementos soportados:

• Pools y carriles, incluidos pools externos, y flujos de mensaje.
• Eventos de inicio, fin, temporizador, mensaje, señal, error y terminación, y eventos adjuntos (interrumpibles o no).
• Todos los tipos de tarea, y subprocesos.
• Compuertas exclusiva, paralela, inclusiva, basada en eventos y compleja, con condiciones y flujos por defecto.
• Objetos de datos, almacenes de datos y anotaciones.

Pruebas

• Lenguaje natural real: un audio transcrito, un correo con jerga, notas de reunión, un dictado con correcciones y un pedido de una línea, modelados por agentes independientes que solo tenían el texto y el SKILL.md. Están en tests/.
• Bizagi Modeler 4.1: los ejemplos y varios casos de prueba se verificaron importándolos en Bizagi: pools y carriles, compuertas exclusivas y paralelas, temporizadores y errores adjuntos, mensajes, documentos, almacenes y anotaciones.
• CI: en cada push, con Python 3.9 y 3.13, se validan y regeneran todos los ejemplos y casos, y se prueba el instalador npx.

Estructura del repo

🔗 Proyectos hermanos

• ea-steroids: modela arquitectura en Enterprise Architect desde tu agente de IA.
• figma-steroids: diseña en Figma Desktop desde tu agente de IA, sin API key ni MCP.
• blender-steroids: modela escenas 3D en Blender desde tu agente de IA.
• ps-steroids: diseña piezas gráficas por capas en Adobe Photoshop desde tu agente de IA, a partir de tu idea o tus fotos.
• pc-steroids: diseña piezas gráficas por capas en PhotoCraft desde tu agente de IA, a partir de tu idea o tus fotos.

📄 Licencia

MIT