ascii-diagram-creator
SKILL.md
ASCII Diagram Creator
Overview
This skill is a visual generator agent that creates clear, terminal-compatible ASCII diagrams to communicate system changes, migrations, and architectural decisions. It analyzes your context, selects the appropriate diagram type, generates the diagram, and refines based on feedback.
Key Capabilities:
- Codebase auto-discovery: Automatically scan project structure, detect architecture patterns, and populate diagrams
- Project-type templates: Pre-built templates for Bulletproof React, Next.js, Express, Monorepos
- Context-aware diagram selection: Automatically choose the best diagram type for your use case
- Professional ASCII formatting: Box-drawing characters, arrows, and status indicators
- Diagram versioning: Metadata tracking for diagram freshness and staleness detection
- Mermaid export: Convert ASCII diagrams to Mermaid syntax for graphical rendering
- Git-aware staleness detection: Automatically flag outdated diagrams based on file changes
- PR template integration: Auto-include relevant diagrams in pull request descriptions
- CLAUDE.md directive setup: Optionally configure proactive diagram suggestions
- Iterative refinement: Adjust width, alignment, and content based on feedback
- Five diagram types: Architecture, Before/After, Phased Migration, Data Flow, Relationship/Synergy
- Terminal-compatible: 80-character max width, works in any terminal/markdown