mermaid-diagram-generator
Use when users need Mermaid diagrams for Arduino code structure, state machines, timing diagrams, task architecture, or workflow documentation.
How do I install this agent skill?
npx skills add https://github.com/wedsamuel1230/embedded-engineering-skills --skill mermaid-diagram-generatorIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill provides tools and templates to generate Mermaid diagrams from Arduino code. It includes a Python script for automated extraction of state machines and flowcharts. No malicious patterns or security risks were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
Mermaid Diagram Generator
Generate Mermaid diagrams from Arduino and embedded-system concepts without loading unnecessary detail up front.
Resources
scripts/generate_diagram.py- CLI generator for diagram outputreferences/diagram-templates.md- Mermaid templates by diagram typereferences/code-patterns.md- code-to-diagram extraction heuristicsreferences/validation-checklist.md- rendering and syntax checks
When to Use
Use this skill when the request asks to:
- visualize a state machine
- turn code into a flowchart
- document timing or protocol sequences
- show FreeRTOS task relationships
- add a diagram to project documentation
Do not use it for tiny code snippets where a diagram adds no clarity.
Workflow
- Identify the diagram type:
- state flow -> open
references/code-patterns.md - timing or protocol sequence -> open
references/diagram-templates.md - task architecture -> open both
code-patterns.mdanddiagram-templates.md
- state flow -> open
- Prefer the simplest diagram that explains the behavior.
- Use
scripts/generate_diagram.pywhen the input is structured enough for automation. - Run through
references/validation-checklist.mdbefore presenting the final Mermaid output.
Verification
- Mermaid syntax parses without errors.
- The diagram uses the correct abstraction level for the request.
- State names, transitions, or signals match the source material exactly.
- The output is readable without reverse-engineering the code.
Integration
- Pair with
freertos-patternsfor task and synchronization diagrams. - Pair with
arduino-code-generatorwhen a generated sketch also needs visual documentation. - Pair with
readme-generatorwhen the diagram should ship in repository docs.
Shared Output Contract
Use the shared Arduino skill contract: state assumptions, required tools and versions, implementation steps, tests/evidence by proof stage, known limitations, and recovery/security notes.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/wedsamuel1230/embedded-engineering-skills/mermaid-diagram-generator">View mermaid-diagram-generator on skillZs</a>