show-me-diagram
Installation
SKILL.md
Show the topic as one diagram the user opens in a browser. The diagram is for the user's own understanding, so stay with plain text when you only need to explain something to another agent.
- Load the
diagram-designskill and follow it for the build. Don't restate or replace its rules, since it changes upstream. - Use the profile the user names; otherwise use the default that
profiles/index.mdmarks. Read that profile fromprofiles/beside this file and apply its choices on top of diagram-design's style guide for this diagram. Don't save it into diagram-design's install or profile library, since other projects share them. - Pick the diagram type that fits the point, from the types
diagram-designlists: a flowchart or sequence for a process, a state machine for status, a tree or layer stack for structure, a timeline for progress. Make one diagram per point. Above about nine nodes, split it. - Check the borders before you show it. Draw each outline after every fill next to it, and put focal outlines last in the SVG, since a later fill paints over half of an earlier border. Export or screenshot at 2x, since 1px lines smear across two pixels at 1x. Zoom in and check that every border is the same width on all sides.
- Open the file for the user, with one or two lines on what it shows. Keep the rest of the reply short, since the diagram carries the point.
References
profiles/index.md: the profiles, which one is the default, and the layers every profile fills in, and how to check one.