About w-diagram
w-diagram is a workflow agent skill for producing Mermaid diagrams from inspected code or documentation. It helps with product, journey, and architecture docs while limiting diagrams to what the sources support.
Key features
- 01Selects diagram type based on the question
- 02Reads named MDX and DESIGN.md sources
- 03Limits documentation requests to two diagrams
- 04Explains diagrams and maps nodes to sources
Use cases
- 01Diagramming a documented product journey
- 02Visualizing code flow or structure
- 03Flagging documentation and code contradictions
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ blockmatic-icebox/ basilic-skills --skill w-diagramAfter installing, type/w-diagramin Claude Code to confirm it loaded.
Details
From the project READMEVisualize relationships, flow, or structure. Chat output unless the user gave a file path. Do not invent architecture that is not in the sources. Do not invent PRODUCT.md.
- If the request is product, journey, or architecture docs, read named MDX/
DESIGN.mdand emit at most two Mermaid diagrams from those sources. Flag contradictions between docs and code without proposing a new methodology. - Otherwise inspect the named code or docs. Choose flowchart, sequence, class, er, state, or journey only when it matches the question.
- Keep labels short. Split oversized graphs. Wrap output in a mermaid fence.
- Explain what the diagram shows in a few sentences. Nodes and edges must map to inspected sources.
Comments
Markdown supported