skills.rest
hiivmind
hiivmindOFFICIAL
Explore all skills by this author →
GitHub

bp-visualize

Convert YAML-defined workflows into Mermaid diagrams with node mappings and transitions.

Updated Jan 23, 2026
Search Tags:#automation#workflow#mermaid#yaml#visualization#diagram
One-click install
npx skills add https://github.com/hiivmind/hiivmind-blueprint --skill bp-visualize
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bp-visualize
Source: https://github.com/hiivmind/hiivmind-blueprint/tree/main/skills/bp-visualize
Command: npx skills add https://github.com/hiivmind/hiivmind-blueprint --skill bp-visualize

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Converts YAML-defined workflows into visual Mermaid diagrams to help teams understand complex automation flows.

Core Features & Use Cases

  • End-to-end diagram generation from workflow.yaml
  • Subflow diagrams for focused views
  • State diagrams as alternative representation
  • Quick validation with Mermaid Live Editor

Quick Start

Provide a workflow.yaml path to visualize, and I will render a Mermaid diagram.

Frequently Asked Questions about bp-visualize

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I visualize a YAML workflow as a Mermaid diagram?▼

To visualize a YAML workflow as a Mermaid diagram, you provide the workflow.yaml file path. The Skill extracts node mappings and transitions using jq and yq to output a ready-to-render Mermaid diagram.

Can I generate state diagrams from YAML automation workflows?▼

Yes, you can generate state diagrams from YAML automation workflows. The Skill provides state diagrams as an alternative representation alongside end-to-end and subflow diagrams to help teams understand complex flows.

Do I need jq and yq to convert YAML workflows into Mermaid diagrams?▼

Yes, you need jq and yq installed because they are required for data extraction from the YAML files. Optionally, gh is used if your workflow requires accessing resources hosted on GitHub.

What is the best way to understand complex automation flows defined in YAML?▼

The best way to understand complex automation flows is to convert the YAML definitions into visual Mermaid diagrams. This provides end-to-end or subflow views with styling to clarify node transitions.

How do I validate a rendered Mermaid diagram generated from a YAML file?▼

You can validate a rendered Mermaid diagram generated from a YAML file using the Mermaid Live Editor. This quick validation step ensures your workflow mappings and transitions are rendered correctly.

Related Skills

Explore More Software Engineering Skills→
0xDarkMatter0xDarkMatter
29

data-processing

Parse, filter, query, and transform JSON, YAML, and TOML data with jq and yq.

Community
Intermediate
pixbpixb

mermaid-visualizer

Convert textual content into Mermaid diagrams for rendering in Obsidian, GitHub, or Mermaid Live Editor.

Community
Basic
pantheon-orgpantheon-org
9

github-actions-generator

Generate GitHub Actions workflows and CI/CD configurations with security standards.

Official
Advanced
ArabelaTsoArabelaTso
142

system-diagram-generator

Generate architecture, data flow, deployment, and sequence diagrams in Mermaid, PlantUML, or Graphviz/DOT.

Community
Intermediate