Generate per-slice markdown specs from an Event Model DSL.
npx skills add https://github.com/howarddierking/mermaid-event-model --skill spec-slices
Please help me install this Agent Skill. Skill: spec-slices Source: https://github.com/howarddierking/mermaid-event-model/tree/main/skills/spec-slices Command: npx skills add https://github.com/howarddierking/mermaid-event-model --skill spec-slices
It solves the problem of manually keeping slice documentation and slice tests aligned with an evolving Event Model DSL, which otherwise becomes tedious to update and risky to let drift out of date.
slice <id>["Label"] in your Event Model DSL.## Model eventModel snippet from the current DSL while preserving your authored ## Description and ## Tests.Run spec-slices with the path to your Event Model DSL file to generate or refresh the per-slice markdown specs in the corresponding -slices directory.
High-intent search queries and answers about installing and using this skill.
To generate markdown documentation from an Event Model DSL, parse the fenced mermaid DSL to extract slices, then write one specification markdown file per slice into a sibling slices directory.
To keep slice specifications synchronized with an evolving Event Model DSL, rebuild each spec's derived Model section from the latest DSL while preserving your authored Description and Tests sections.
When slices are renamed or removed from the DSL, the tool detects orphan specifications, deletes untouched stubs, and interactively merges authored content into the correct current slice to prevent data loss.
Yes, you can maintain slice tests alongside documentation for code generation workflows by using this tool to document and test event-model slices for validation and iterative model refactoring.
No external dependencies are required to parse the eventModel mermaid DSL for slice extraction; the tool operates standalone to extract referenced nodes and edges directly from the fenced DSL block.
howarddierkingRegenerate Event Model DSL slice declarations from a Mermaid edge graph.
lexlerDesign event models with STATE_CHANGE, STATE_VIEW, and AUTOMATION slices.
cgm-freeParse and render Mermaid diagrams within Markdown code blocks.
mjamoreSynchronize repository documentation with source code using doc-first workflows.