SpillWave Solutions' diagramming skill: The agent converts text descriptions or source code into Mermaid flowcharts, sequence diagrams, class diagrams, ER diagrams, state diagrams, C4, and architecture diagrams, or writes architecture / API / feature / database design documents with diagrams according to templates; it can use bundled Python scripts to extract diagrams from Markdown, validate them with mermaid-cli, and convert them to PNG / SVG.
skills.sh installs 87855 (+977 / 24h)
Security Audit: Not audited
- Not yet scanned
Rationale
- Loads specialized guides based on intent (activity diagrams, deployment diagrams, architecture diagrams, sequence diagrams, Wiki), and includes examples of converting code to diagrams for six categories: Spring Boot, FastAPI, React, Python ETL, Node/Express, and Java Web.
- Specifies that diagrams are written into Markdown only after passing validation; files are uniformly stored in ./diagrams/ and named using the pattern "document_name_sequence_number_type_title"; if validation fails, consult the bundled troubleshooting guide first.
- Clearly defines target platforms: use mermaid code blocks for GitHub wiki, but generate separate PNG or SVG files for Confluence, Notion, Word, and PDF; PlantUML is used only for diagram types not supported by Mermaid.
- The README states that Python scripts use only the standard library and are MIT licensed; skills.sh shows 977 installs in the last 24 hours, a cumulative total of 87855, and weekly installs over the past 8 weeks have risen from 4007 to 6318 (indicating attention level only).
Usage
- The installation command will be displayed after the audit passes; triggered by requests such as "draw a sequence diagram," "convert this code into an architecture diagram," or "write an API design document."
- Generating Mermaid code alone requires no additional tools; validation and image export require npm install -g @mermaid-js/mermaid-cli and Python 3.7 or higher; no account is needed.
Risks
- Not audited in this period, fixed at Grade C, installation command not displayed; SKILL.md instructs the agent to run bundled Python scripts and mmdc, creating a diagrams/ directory in the current working directory to write files, which aligns with its purpose, but the scripts have not been scanned; if validation fails, it sequentially calls perplexity, brave search MCP, gemini skills, and web search to find solutions, potentially sending diagram code to external services; on skills.sh, Gen Agent Trust Hub and Socket audits are Pass, while Snyk is Warn.
- Requires adding Unicode emojis to all diagrams and using specified high-contrast color schemes, which may not match project documentation styles; SKILL.md is approximately 2.3 bytes, consuming context when loaded.
- The installation curve over the past 8 weeks is nearly synchronized with this period's fastify-best-practices and nx-workspace (daily installs for fastify-best-practices, nx-workspace, and design-doc-mermaid are 986, 971, and 977 respectively), suggesting they may have been installed together as part of the same collection; install counts should not be interpreted as independent attention metrics.