diagram_skill

Overview

This skill renders clear, editable diagrams (SVG and PNG) using an iterative render-and-check workflow. It enforces CRAP-based self-critique (Contrast, Repetition, Alignment, Proximity) and reduced-size checks before presenting output. The skill composes with brand styling when available and produces production-ready visuals for slides, docs, and presentations.

How this skill works

Ask for a diagram (flow chart, Venn, architecture, etc.) and the skill first clarifies structure, content, and purpose. It generates a structured SVG on a 1280×720 canvas, renders a PNG for visual checks, runs automated CRAP and composition checks, fixes issues, and re-renders until the diagram meets quality criteria. If a brand skill exists, its palette and typography are applied automatically.

When to use it

• Creating conceptual diagrams: Venn diagrams, flows, system architecture
• Designing visual explanations for slides or reports
• Generating human-editable SVGs that need to be polished before delivery
• Producing diagrams that must follow brand guidelines and accessible contrast
• Iterating on layout where alignment, spacing, and hierarchy matter

Best practices

• Clarify structure, content, and purpose before drawing
• Group related items and keep annotations close to targets
• Limit font sizes to 3–4 levels and reuse a small color palette
• Test rendered PNG at 50–75% size to reveal hierarchy and contrast issues
• Prefer contained keys or no key at all; avoid scattered meta-info

Example use cases

• A product manager asks for a Venn diagram showing overlapping stakeholder concerns
• An engineer requests a service architecture diagram styled to company brand colors
• A presenter needs a flow chart that remains legible when projected
• A data analyst wants a conceptual chart exported as an editable SVG for handoff
• A designer wants a PNG preview after automatic CRAP adjustments before final delivery