sequence-diagramming

Convert described interaction flows into Mermaid sequence diagrams.

1|Updated Nov 29, 2025

Search Tags:#mermaid #diagramming #workflows #uml #sequence-diagrams

Ready to run

npx skills add https://github.com/SSiertsema/claude-code-plugins --skill sequence-diagramming

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: sequence-diagramming
Source: https://github.com/SSiertsema/claude-code-plugins/tree/main/sequence-diagramming/skills/sequence-diagramming
Command: npx skills add https://github.com/SSiertsema/claude-code-plugins --skill sequence-diagramming

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

You turn a described flow into a readable sequence diagram. Clarity over completeness — one diagram per flow, alternates labelled.

Core Features & Use Cases

One flow per diagram — avoids conflating cases
Participants first, then messages — left-to-right order
Sync vs async explicit — arrows show call direction and type
Label messages precisely — action + key args / return values
Alternates + loops as fragments — avoid duplicating diagrams
Don't draw the implementation — diagram focuses on interaction
No fabricated participants — use only supplied flow

Quick Start

Describe a flow and the tool will render a Mermaid sequence diagram.

Frequently Asked Questions about sequence-diagramming

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

FAQPage Schema

How do I convert a described user interaction flow into a Mermaid sequence diagram?▼

To convert a described flow into a Mermaid sequence diagram, you provide the flow name, participants, and steps. The tool then automatically renders these inputs into a clear Mermaid sequence diagram with correctly ordered participants and messages.

What is the best way to map API call sequences with alternates and loops?▼

The best way to map API call sequences is to describe one specific flow at a time. This approach renders alternates and loops as distinct Mermaid fragments, preventing diagram duplication and keeping the interaction logic clear.

Can I generate UML sequence diagrams for multiple error paths in a single diagram?▼

You should avoid generating multiple error paths in a single diagram. The tool enforces one diagram per flow to maintain clarity, using Mermaid fragments to properly label alternates and error paths without conflating separate use cases.

Does this Mermaid diagramming tool require participants to be defined before the steps?▼

Yes, the Mermaid diagramming tool requires participants to be defined first. It enforces a left-to-right order, placing participants before messages to ensure the generated sequence diagram accurately reflects the interaction flow.

How do I show synchronous versus asynchronous calls in a UML sequence diagram?▼

To show synchronous versus asynchronous calls in a UML sequence diagram, you describe the call types in your flow steps. The tool translates this into explicit Mermaid arrows indicating the exact call direction and type.

When should I not use sequence diagrams for documenting software workflows?▼

You should not use sequence diagrams to draw the underlying implementation details. They are designed to focus purely on interaction flows, so avoid using them when you need to visualize system architecture rather than participant messaging.