event-model

Convert natural-language system descriptions into Event Model DSL markdown files.

7|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/howarddierking/mermaid-event-model --skill event-model
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: event-model
Source: https://github.com/howarddierking/mermaid-event-model/tree/main/skills/event-model
Command: npx skills add https://github.com/howarddierking/mermaid-event-model --skill event-model

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turning a natural-language description of a system into a correct Event Modeling DSL file is time-consuming and easy to get wrong, especially when you need consistent actors, commands, events, read models, and automations.

Core Features & Use Cases

  • Author and extend Event Model DSL files: Creates or updates the fenced eventModel grammar inside a target markdown DSL file while preserving existing structure.
  • Guides correct modeling conventions: Adds the right element types (actors, aggregates, UIs, commands, domain/external events, read models, automations) following repository conventions like ids and indentation rules.
  • Supports incremental growth: Extends an existing model without duplicating ids and provides an editing workflow oriented around sketching, confirmation, and safe insertion points.

Quick Start

Use the event-model skill to update ./models/example.md by adding a new "forgot password" flow end-to-end, including UI, command, domain event, read model, and automation wiring.

Frequently Asked Questions about event-model

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

FAQPage Schema
How do I convert a natural-language system description into an event modeling diagram?

To convert a natural-language description into an event modeling diagram, you author an Event Model DSL file using tab-indented declarations inside a fenced markdown block. This generates a renderer-ready SVG diagram structure representing your system intent.

What is the best way to add a new flow to an existing event modeling DSL markdown file?

Adding a new flow to an existing event modeling DSL markdown file requires writing inside the fenced eventModel block with valid edge wiring. The process preserves existing structure by incrementally adding actors, commands, events, and read models without duplicating ids.

Can I generate a CQRS domain events diagram from plain text?

Yes, you can generate a CQRS domain events diagram from plain text by authoring an Event Model DSL file. The Skill translates natural-language input into the correct element types, including aggregates, commands, domain events, read models, and automations.

Does event modeling DSL support incremental updates to existing markdown diagrams?

Event modeling DSL supports incremental updates by extending existing markdown files without duplicating ids. It provides an editing workflow oriented around sketching, confirmation, and safe insertion points to add new flows end-to-end while preserving the original structure.

What conventions are required when authoring event model DSL declarations?

Authoring event model DSL declarations requires following repository grammar conventions like correct element types, unique ids, and tab-indented formatting. You must write only inside the fenced eventModel block to ensure valid edge wiring for the SVG renderer.