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.