Drawio
Git-versioned agent memory: agents that never make the same mistake twice. Anthropic-Skill folder standard, multi-runtime (Claude Code, Cursor, Gemini CLI, OpenCode).
npx -y skills add sordi-ai/skill-everything --skill drawioAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 17 stars17 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Apply when creating or reviewing architecture diagrams, Mermaid diagrams, or draw.io files.
The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.
SKILL.md
2.4 KB, as published. Nobody here has run it
Sub-Skill: Diagrams (draw.io / Mermaid)
Purpose: Ensure diagrams are version-controlled as source, rendered consistently, and kept in sync with the system they describe.
Rules
Source Control
- Commit source, not just exports. Always commit diagram source files (
.drawio,.mmd,.puml) alongside or instead of rendered image exports. Reference: ERR-2026-027 - No binary-only diagrams. Never commit only a PNG or SVG export without the editable source; reviewers cannot diff or modify a raster image.
- One source file per diagram. Use a single canonical source file per diagram; avoid duplicating the same diagram in multiple formats.
Format Selection
- Prefer diagram-as-code. Prefer Mermaid or PlantUML over draw.io XML when the diagram fits a supported diagram type; text diffs are reviewable.
- Match diagram type to content. Use
sequenceDiagramfor request flows,flowchartfor decision logic,C4Context/C4Containerfor architecture,erDiagramfor data models. - Set layout direction explicitly. Always declare layout direction (
LR,TD) in Mermaid flowcharts; never rely on the default, which varies by renderer.
Rendering Pipeline
- Document the render command. Always include the render command or CI step in the repo README or Makefile so any contributor can regenerate exports.
- Regenerate exports in CI. Ensure CI regenerates diagram exports from source and fails if the committed export differs from the generated one.
- Pin renderer version. Always pin the Mermaid CLI or draw.io CLI version in CI to prevent silent rendering changes across upgrades.
Quality & Consistency
- Use consistent node naming. Always use the same label for the same system component across all diagrams in the repo; divergent names cause confusion.
- Add alt text to exported images. Always add descriptive alt text to diagram images embedded in documentation for accessibility.
- Review diagrams in PRs. Before merging, verify that any diagram change accurately reflects the system change described in the PR.
See also
skills/svg-check/SKILL.mdskills/error-log/SKILL.md