Turns ASCII art and Unicode box-drawing characters into proper visual documentation for systems, processes, and architectures. Built around Tufte's data-ink ratio principles, so it pushes you toward clean, maintainable diagrams that actually reduce cognitive load instead of adding decoration. Covers the usual suspects like flowcharts and layer diagrams, but also handles psychological structures and parts work if you're doing Jungian mapping. The character reference and anti-pattern examples are legitimately useful. It'll proactively suggest diagrams when concepts get complex, which is the right instinct. Works everywhere because it's just monospace text, no special rendering required.

skills.sh installs
135
GitHub stars
113
last updated
Jun 3, 2026

Install

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

Installs into .claude/skills of the current project.

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

Sponsors

Details

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

More from erichowens/some_claude_skills

All 73

Recommended

1juliusbrussee avatarcavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
2mattpocock avatargrill-memattpocock/skillsA relentless interview to sharpen a plan or design.1.5Mskills.sh installs
3shadcn avatarimproveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
4obra avatarsystematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
5forrestchang avatarkarpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
6vercel-labs avatarfind-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs