Agent skill
arch-designer
Use when the user wants to generate architecture diagrams, visualize their codebase structure, create pitch decks with system diagrams, or understand their infrastructure layout from code
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/arch-designer
SKILL.md
Architecture Designer
Generate professional, ByteByteGo-quality architecture diagrams from your codebase.
When to Use
Use this plugin when:
- User asks about architecture visualization or diagrams
- User wants to document their system architecture
- User is preparing a pitch deck or presentation
- User asks "what does my architecture look like?"
- User wants to understand infrastructure from Terraform/Docker files
- User needs diagrams for documentation or README
Available Commands
| Command | Purpose |
|---|---|
/arch:generate |
Scan codebase and generate full architecture diagram suite |
/arch:view $SCOPE |
Generate a focused diagram for a specific component or flow |
/arch:deck --investor |
Create investor pitch deck with auto-generated diagrams |
/arch:deck --client |
Create client-facing presentation deck |
/arch:export |
Export diagrams in multiple formats (SVG, PNG, PDF) |
/arch:refresh |
Regenerate diagrams after code changes |
Supported Sources
The plugin can analyze:
- Terraform - AWS resources (Lambda, DynamoDB, S3, SQS, API Gateway, etc.)
- Docker Compose - Services, dependencies, networking
Future analyzers will add support for:
- Kubernetes manifests
- AWS CDK
- CloudFormation
- Application code (Express routes, database connections)
How It Works
- Analyzers scan IaC files and extract components
- GraphBuilder merges results into a unified architecture graph
- Dagre layout positions nodes using hierarchical algorithm
- SVG renderer creates animated, styled diagrams
Output Location
Diagrams are saved to docs/architecture/latest/:
overview.svg- Animated SVG with flow indicatorsoverview.png- Static image for embeddingembed.html- Copy-paste snippet for README
Interactive Refinement
After generation, you can refine diagrams conversationally:
- "Zoom into the auth flow"
- "Add a callout explaining the cache layer"
- "Move the database to the right"
- "Highlight the payment processing path"
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?