skills.rest
truongnat
truongnatCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

biz-model

Generate business analysis diagrams in Mermaid, PlantUML, D2, and DBML formats.

Updated Jul 28, 2026
Search Tags:#mermaid#business analysis#sequence diagram#diagram#plantuml#erd#bpmn
One-click install
npx skills add https://github.com/truongnat/Restly --skill biz-model-truongnat
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: biz-model
Source: https://github.com/truongnat/Restly/tree/main/.agents/skills/biz-model
Command: npx skills add https://github.com/truongnat/Restly --skill biz-model-truongnat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Business analysts and developers often need consistent, traceable diagrams (sequence, ERD, BPMN, state, use case) tied to requirement IDs, but producing them ad hoc leads to inconsistent formats and lost traceability. This Skill standardizes diagram production into a single MODEL.md artifact per session. ## Core Features & Use Cases - Eleven diagram modes: sequence, activity, activity-swimlane, BPMN, state, ERD, use case, D2 ERD, D2 activity, D2 architecture, and dbdiagram, each with a default format. - Multiple output formats: Mermaid, PlantUML, D2, and DBML source, with optional .d2/.dbml sidecar files for external renderers like the D2 CLI or dbdiagram.io. - Traceability and honesty guardrails: diagrams link to FR/US/AC IDs via trace_refs, and the contract forbids inventing actors or claiming Camunda XML or live D2 rendering without evidence. - Use Case: Given a set of functional requirements for a checkout flow, produce a Mermaid sequence diagram in MODEL.md with actors, trace references to FR IDs, open questions, and handoff notes. ## Quick Start Ask the agent to use biz-model with diagram=sequence to model the checkout flow and write the result into MODEL.md in the active session.

Frequently Asked Questions about biz-model

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

FAQPage Schema
How do I generate a sequence diagram from requirements?▼

Invoke the skill with diagram=sequence, the subject, actors, and related requirement IDs. It writes a Mermaid sequence diagram into MODEL.md with trace references, a legend, open questions, and limitations.

What diagram formats does this skill support?▼

It supports Mermaid, PlantUML, D2, and DBML. Mermaid is the default for most modes, PlantUML for activity-swimlane, D2 for the d2-erd, d2-activity, and d2-architect modes, and DBML for dbdiagram.

Can I render D2 or DBML diagrams inside the repository?▼

No. D2 and DBML outputs are source for external renderers such as the D2 CLI or dbdiagram.io. The skill explicitly forbids claiming in-repo live preview unless the tool is actually available.

Does the BPMN mode produce Camunda-compatible XML?▼

No. The BPMN mode produces a BPMN-like Mermaid diagram and documents Camunda/Bizagi limits in the Limitations section. The contract forbids claiming Camunda XML import unless actual XML was produced.

What happens when diagram inputs are missing or unclear?▼

The skill follows a confirm-first policy on blocking unknowns and records them in the open_questions table of MODEL.md. It does not invent systems, actors, or entities that were not provided.

Related Skills

Explore More Product & Management Skills→
VanLengsVanLengs
1

process-flow

Creates structured business process flow diagrams with events, decisions, and actors.

Community
Advanced
adawadaw

fabric-design

Convert backlog items into implementation specifications with data models and API signatures.

Community
Advanced
michaelkd01michaelkd01

mermaid-diagrams

Create Mermaid diagrams for software architectures and process flows.

Community
Advanced
DSanchezVargasDSanchezVargas

bpmn-process-mapper

Convert process narratives into BPMN 2.0 diagrams and valid BPMN XML.

Community
Advanced