pma-draw
Installation
SKILL.md
ReactFlow Diagram Creator
Generate .rfd.json files that encode meaning in shape, position, and connection — consumed by a ReactFlow-based viewer (pma-viewer) with a predefined catalog of custom node types.
Keep this entry file small. Load only the references needed for the current diagram.
Always-On Rules
- Isomorphism first: node layout and edge topology must mirror the concept's structure. If removing all labels still communicates the idea, the design is right.
- Use predefined node types only. Pull every node
typefromreferences/node-types.md. Never invent new types unless the user asks and the viewer supports them. - Use predefined edge types only. Pull every edge
typefromreferences/edges.md. Avoid rawdefaultunless no preset fits. - Colors come from
references/colors.md. Node styling is driven by the preset; override only when semantics require it. - Grouping via parent-child, not by drawing a container rectangle. Use
parentNode+extent: "parent"on child nodes and agrouptype parent. - Every relationship needs an edge. Proximity alone is not a connection.
- No local render: the skill emits
.rfd.jsononly. Rendering and export happen in pma-viewer (SPA). Quality must be enforced at JSON level — seereferences/validation.md. - Build large diagrams section-by-section. Append nodes/edges per edit, namespace IDs by section prefix (
ingest__,process__,deliver__) to keep cross-section references readable.