okhp3-visual-process-modeling

Convert Process Narrative Specifications into Mermaid-native BPMN diagrams.

2|1|Updated Jun 12, 2026
One-click install
npx skills add https://github.com/OKHP3/skillz --skill okhp3-visual-process-modeling
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: okhp3-visual-process-modeling
Source: https://github.com/OKHP3/skillz/tree/main/process-capture/okhp3-visual-process-modeling
Command: npx skills add https://github.com/OKHP3/skillz --skill okhp3-visual-process-modeling

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires process-narrative-authoring, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates the creation, validation, and normalization of Mermaid-native BPMN diagrams from Process Narrative Specifications (PNS), streamlining the process of visualizing business processes.

Core Features & Use Cases

  • Diagram Generation: Converts PNS into BPMN diagrams with pools, lanes, gateways, and message flows.
  • Validation: Checks the structural integrity and correctness of the diagrams.
  • Normalization: Ensures consistent formatting and whitespace for readability.
  • Use Case: Ideal for users who need to translate process narratives into visual diagrams for documentation or collaboration.

Quick Start

Use the okhp3-visual-process-modeling skill to generate a BPMN diagram from the provided PNS file 'process-narrative.pns.yaml'.

Frequently Asked Questions about okhp3-visual-process-modeling

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

FAQPage Schema
How do I generate BPMN diagrams from process narratives?

You can generate BPMN diagrams by converting Process Narrative Specifications (PNS) into Mermaid-native BPMN diagrams. This process automatically creates visual models with pools, lanes, gateways, and message flows for documentation.

What is a Process Narrative Specification for process modeling?

A Process Narrative Specification (PNS) is a structured input format used to describe business processes. It serves as the source text for converting process narratives into Mermaid-native BPMN diagrams.

Do I need a separate tool to validate process narratives before BPMN diagram generation?

Yes, you need the process-narrative-authoring skill to validate PNS inputs. This prerequisite ensures structural correctness before the visual process modeling skill converts them into diagrams.

Can I use Mermaid 11.x to render BPMN 2.0.2 diagrams from process models?

Yes, the process modeling utilizes the Mermaid 11.x External Diagram API and conforms to the BPMN 2.0.2 Descriptive Conformance Sub-Class. It outputs bpmn-beta.mmd and process-model.svg files for rendering.

What's the best way to ensure consistent formatting in Mermaid BPMN diagrams?

To ensure consistent formatting in Mermaid BPMN diagrams, use a normalization process that validates structural integrity and standardizes whitespace. This guarantees readability across generated process models.

Why does my generated BPMN diagram fail structural validation?

BPMN diagrams fail structural validation when the Process Narrative Specification lacks necessary elements for pools, lanes, or gateways. Using process-narrative-authoring for PNS validation beforehand prevents these structural errors.