Communitygithub.com

Visualizador de Flujos de Trabajo

Explica un flujo de trabajo en detalle como una página visual (leyenda de símbolos, cuadros informativos, explicaciones tangibles) y elige la forma del diagrama según la estructura del proceso. Úsalo siempre que el tema sea un flujo de trabajo, proceso o procedimiento y el usuario quiera detalle, por ejemplo, 'con más detalle', 'paso a paso', 'cómo funciona exactamente', 'explica el flujo de trabajo de nuevo'. No lo uses cuando 'flujo de trabajo' solo se mencione de paso o baste una respuesta breve.

¿Qué es Visualizador de Flujos de Trabajo?

El Visualizador de Flujos de Trabajo es una habilidad para agentes de IA que transforma descripciones textuales de procesos en diagramas visuales detallados y autocontenidos. A diferencia de una respuesta de texto larga, esta habilidad genera una página HTML completa que incluye una leyenda de símbolos, cuadros informativos con títulos y explicaciones, y una representación gráfica específica (como diagrama de flujo, líneas de tiempo, carriles, ciclo, ramificación, pistas paralelas) escogida en función de la estructura del proceso subyacente. Es ideal para usuarios que piden 'más detalle', 'paso a paso' o 'explica de nuevo', y que necesitan entender el orden, las transferencias, las decisiones y los tiempos de espera de un proceso. La habilidad se activa solo cuando se cumplen dos condiciones: el contexto es un flujo de trabajo, proceso o procedimiento, y el usuario desea profundidad. La habilidad guía al agente para clarificar el proceso, leer su estructura, elegir la forma más adecuada (por ejemplo, diagrama de flujo si hay bucles, líneas de tiempo si los tiempos importan), y construir la página usando una plantilla base con tokens de estilo CSS, siguiendo reglas estrictas de diseño (sin sombras, sin gradientes, monocromático sobre fondo papel). También verifica que toda la información esté documentada o marcada como abierta, y que los bucles se dibujen explícitamente. Es compatible con cualquier plataforma que pueda generar y publicar artefactos HTML, como Claude Code, Cursor o Codex.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jirispataart-deve/workflow-visualizer/tree/HEAD

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Visualizador de Flujos de Trabajo?

Cuando alguien quiere entender un flujo de trabajo en detalle, el texto corrido rara vez es suficiente. Un proceso tiene un orden, transferencias, decisiones y tiempos de espera. Un gráfico adecuado lo hace legible de inmediato. Reemplaza la respuesta larga de texto en lugar de añadirse a ella.

La forma se elige libremente. Ninguna forma tiene prioridad, ni la línea de tiempo ni ninguna otra. La estructura del flujo de trabajo decide.

Cuándo aplica esta habilidad

Dos condiciones juntas:

  1. El contexto es un flujo de trabajo, proceso o procedimiento (el propio del usuario, uno que se haya discutido, o uno que necesite explicarse desde cero).
  2. El usuario quiere más profundidad: "en detalle", "más precisamente", "paso a paso", "explica de nuevo", "cómo funciona".

Si la palabra "flujo de trabajo" solo surge de paso y la pregunta se responde rápidamente, responde brevemente en el chat. Un gráfico para cada mención pasajera lo devalúa.

Procedimiento

  1. Clarifica el proceso. Toma el proceso de la conversación, de los archivos o de las fuentes que nombre el usuario. Si falta algo esencial, pregunta una vez, brevemente. No inventes pasos, duraciones ni herramientas. Cualquier cosa no verificada se marca como "Abierto".
  2. Lee la estructura, luego elige la forma. Consulta la siguiente sección. Di en una frase en el chat qué forma elegiste y por qué. El usuario puede anular tu decisión con una palabra.
  3. Esquema. De 4 a 10 pasos en total, agrupados en 2 a 4 fases o carriles. Más pasos diluye el gráfico; en su lugar, resume subprocesos.
  4. Completa cada paso.
    • Marcador de tiempo o posición: una duración real, punto en el tiempo u orden ("Paso 3"). Sin horas de reloj supuestas.
    • Un símbolo de la leyenda.
    • Un título (sustantivo, corto) y una o dos frases sobre qué ocurre y por qué.
    • Opcional: cuadro Importante: solo cuando una información puede determinar el éxito o fracaso del proceso (prerrequisito, fuente de error, aprobación).
    • Opcional: cuadro Concreto: una imagen tangible, ejemplo o analogía que haga comprensible un paso abstracto. La imagen explica algo; no decora.
  5. Construye la leyenda. Solo los símbolos que aparecen en el gráfico, más los elementos de la forma elegida. La leyenda va en la parte superior.
  6. Entrega como página. Constrúyela a partir de assets/base-template.html (tokens, encabezado, leyenda, cuadros) y añade la estructura de la forma elegida siguiendo references/shapes.md. Para el diagrama de flujo hay un ejemplo terminado en assets/flowchart-example.html: reutiliza su CSS y reemplaza el contenido. Titula la página con el nombre del flujo de trabajo, por ejemplo "Flujo de aprobación de documentos". Si tu entorno puede publicar páginas o artefactos, publícalo allí; de lo contrario, entrega un archivo HTML autónomo.
  7. Responde en el chat. Una o dos frases: la forma elegida con la razón, y cualquier punto abierto. No repitas el contenido del gráfico.

Elección de la forma

Lee primero la estructura del flujo de trabajo, luego decide. Estas preguntas ayudan:

  • ¿Hay decisiones cuyo resultado lleva de vuelta (un bucle), o cuyos caminos se reencuentran, y debería el lector poder seguir la ruta con el dedo? → Diagrama de flujo
  • ¿Los caminos se dividen en decisiones y terminan en lugares diferentes sin volver? → Ramificación
  • ¿Varias personas, herramientas o roles llevan partes del proceso, la dificultad está en las transferencias, y no hay bucle? → Carriles
  • ¿El proceso comienza de nuevo sin cambios después del último paso, o el resultado alimenta la siguiente ejecución, sin decisiones intermedias? → Ciclo
  • ¿Las ramas ocurren al mismo tiempo y deben reunirse en algún punto? → Pistas paralelas
  • ¿El proceso es en esencia una secuencia de pasos a lo largo del tiempo, con tiempos de espera, plazos o duraciones que importan? → Línea de tiempo
  • ¿El flujo de trabajo mezcla varias propiedades? Elige aquella donde el lector tenga más probabilidades de equivocarse. La propiedad secundaria se convierte en un cuadro informativo o una etiqueta de ubicación: un diagrama de flujo puede mostrar dónde tiene lugar un paso sin necesidad de carriles.

Un bucle es la razón más común para cambiar de forma. Ocultarlo en un cuadro informativo lo entierra, y es justo donde los lectores tropiezan. Si hay uno, el diagrama de flujo suele ser la forma más honesta, incluso si los carriles o la línea de tiempo parecen adecuados a primera vista.

No elijas por apariencia o por costumbre. Una forma que no coincida con la estructura falsea el proceso: un eje oculta alternativas, los carriles sin transferencias reales son decoración.

Las reglas exactas de construcción para cada forma están en references/shapes.md. Lee solo la sección de la forma elegida.

Símbolos

Todos angulares, sin círculos. Las formas se dibujan con CSS en lugar de caracteres para que se vean igual en todas partes.

SímboloFormaSignificado
Accióncuadrado rellenose hace o produce algo
Decisióncuadrado vacíoel flujo se bifurca aquí
Punto de controldiamanteverificación, aprobación, visto bueno
Transferenciatriánguloel resultado pasa a una persona, herramienta o fase
Esperabarra horizontalno ocurre nada activamente, el tiempo pasa
Abiertocuadrado discontinuofalta información o no está verificada

Añade más símbolos solo cuando el flujo de trabajo realmente los necesite, y explícalos en la leyenda.

Estilo

La plantilla trae un valor predeterminado neutro: un fondo de papel cálido, tinta casi negra, un acento pálido usado solo como superficie, y la fuente del sistema. Todos los colores son tokens en :root. Si el usuario tiene una marca o sistema de diseño, cambia solo esos tokens; no rediseñes la estructura.

  • Fondo de papel, tinta para títulos, grafito para texto corriente, un tono tranquilo para superficies silenciosas, líneas finas para reglas.
  • El acento se usa solo como superficie, nunca como color de texto o línea. El texto sobre él es siempre tinta. Como máximo una banda de acento grande por página; las pequeñas barras marcadoras (10px) bajo los títulos de fases y carriles pueden repetirse.
  • Una familia tipográfica. Jerarquía mediante peso y espaciado entre letras; espaciado solo en mayúsculas.
  • Sin sombras, gradientes, esquinas redondeadas, emojis ni signos de exclamación. Las listas usan cuadrados de tinta. Las conexiones son líneas rectas con ángulos rectos, de 2px de tinta.
  • La página se mantiene en un solo tema sobre papel. Todos los colores se establecen explícitamente para que se lea igual en interfaces claras y oscuras.
  • Prioridad móvil, sin desplazamiento horizontal de la página. Cualquier cosa que deba ser más ancha (carriles) se desplaza en su propio contenedor.

No inventes nuevos colores, fuentes o formas. Si al sistema le falta algo, nombra la carencia y resuélvelo dentro de los tokens.

Idioma

Escribe el gráfico en el idioma que el usuario está usando. Mantenlo factual, basado en sustantivos y corto. Sin relleno, sin jerga de moda. Las explicaciones pueden ser vívidas pero precisas: una imagen fuerte en lugar de tres débiles.

Lista de verificación antes de entregar

  • La forma sigue la estructura del flujo de trabajo, y la frase en el chat nombra la razón.
  • Todo bucle está dibujado como un camino y no solo mencionado en texto.
  • Cada declaración de tiempo está documentada o marcada solo como orden.
  • Cualquier cosa no verificada lleva el símbolo "Abierto".
  • Todos los símbolos en el gráfico aparecen en la leyenda, y no otros.
  • El acento se usa solo como superficie, nunca como texto o línea.
  • Ningún texto se sale del borde, ni siquiera a 400px de ancho.
  • El texto del chat no repite el contenido del gráfico.

Skills relacionados