sequences

Generate Mermaid sequence diagrams from sad.md and spec.md files.

89|32|Updated May 28, 2026
One-click install
npx skills add https://github.com/genkovich/sdd --skill sequences-genkovich
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sequences
Source: https://github.com/genkovich/sdd/tree/main/skills/sequences
Command: npx skills add https://github.com/genkovich/sdd --skill sequences-genkovich

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps in visualizing and confirming the runtime flows of a feature by generating Mermaid sequence diagrams, which are essential for understanding the flow of requests between participants and handling errors.

Core Features & Use Cases

  • Sequence Diagram Generation: Automatically creates Mermaid sequenceDiagram blocks for each critical flow of a feature.
  • User Confirmation: Allows users to confirm each flow in prose before finalizing the diagram.
  • Documentation Integration: Inserts diagrams into the sad.md file at the appropriate section, enhancing the runtime view of the feature.

Quick Start

To visualize the runtime flow for a feature, run the command: sdd:sequences <slug>

Frequently Asked Questions about sequences

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

FAQPage Schema
How do I generate Mermaid sequence diagrams for feature runtime flows?

To generate Mermaid sequence diagrams for feature runtime flows, run the `sdd:sequences <slug>` command. The Skill reads participants from a `sad.md` file and flows from a `spec.md` file to visualize request routing and error handling. You can confirm each flow before finalizing.

What is a sequence diagram used for in software design?

A sequence diagram in software design is used to visualize and confirm the runtime flows of a feature. It maps the flow of requests between participants and handles asynchronous operations and errors, ensuring the documented runtime view matches the intended logic.

Do I need specific markdown files to document runtime views with Mermaid?

Yes, you need a `sad.md` file containing participants and a `spec.md` file defining flows and acceptance criteria. The Skill reads these files to generate the sequence diagrams and then writes the resulting Mermaid blocks back into the `sad.md` file.

Can I review and confirm feature flows before the sequence diagram is finalized?

Yes, you can confirm each critical flow in prose before the diagram is finalized. The Skill allows user confirmation for each sequence, ensuring the generated Mermaid syntax accurately reflects the runtime view before inserting it into your documentation.

Does Mermaid sequence diagram generation support asynchronous flows and retries?

Yes, Mermaid sequence diagram generation supports asynchronous flows with retry logic. This allows you to accurately visualize complex runtime views, including error handling and request retries between participants in your software design.