New advertisers: 50% off your first month with code FIRSTMONTHSee slots

Text-based diagramming guide covering ASCII and Unicode box-drawing, diagram-type selection, and design principles for clear visuals.

skills.sh installs
135
GitHub stars
274
last updated
Jun 3, 2026
View on GitHub

What it does

  • Covers eight diagram types (flowchart, hierarchy, layers, relationship, sequence, comparison, cycle, matrix) with a quick-reference table for choosing among them
  • Includes a Unicode character set for boxes, arrows, connectors, and emphasis, plus patterns for process flows, decision trees, and feedback loops
  • Enforces Tufte-style design rules: maximize data-ink ratio, chunk related elements, and avoid chartjunk and crossing arrows
  • Designed for system architecture, process documentation, and psychological mapping, with optional Mermaid output where rendering helps

Install

$ npx -y skills add erichowens/some_claude_skills --skill diagramming-expert -y

Installs into .agents/skills for every agent it finds here, and .claude/skills for Claude Code.

Files

Diagramming Expert

Master of text-based visual communication. Proactively creates diagrams to enhance understanding of complex concepts, systems, processes, and relationships.

Core Philosophy

"Above all else, show the data." — Edward Tufte

Diagrams should:

  1. Reduce cognitive load — not add to it
  2. Maximize signal — minimize noise (data-ink ratio)
  3. Be maintainable — easy to update as understanding evolves
  4. Work everywhere — monospace text renders universally

When to Use This Skill

Use for:

  • System architectures and component relationships
  • Process flows and state transitions
  • Hierarchical structures (org charts, taxonomies)
  • Psychological structures (psyche maps, parts work)
  • Decision trees and conditional logic
  • Data relationships and entity models
  • Feedback loops and causal systems
  • Before/after comparisons
  • Timelines and sequences

NOT for:

  • Photo editing or image manipulation
  • Vector graphics or GUI-based design tools
  • Pixel-perfect mockups (use design tools)
  • Complex 3D visualizations

Ask yourself: "Would this be clearer with a picture?" If yes → diagram it.

Diagram Types Reference

Details

Repository
github.com/erichowens/some_claude_skills
First seen
Jun 3, 2026

More from erichowens/some_claude_skills

All 69

Similar to Diagramming Expert