agent-hierarchy-diagram
Generate visual hierarchy diagrams of agent system showing levels and delegation. Use for documentation or onboarding.
When & Why to Use This Skill
This Claude skill automates the creation of visual hierarchy diagrams for agent systems, providing clear insights into delegation structures and system architecture through ASCII, Mermaid, and GraphML formats. It is designed to enhance system transparency and streamline the documentation process for complex multi-agent environments.
Use Cases
- Technical Documentation: Automatically generate and embed live-updating agent hierarchy diagrams in GitHub READMEs, technical wikis, or project documentation.
- Team Onboarding: Accelerate the ramp-up process for new developers by providing a clear visual map of agent relationships, levels, and delegation flows.
- Architecture Auditing: Visualize complex multi-agent systems to identify bottlenecks, redundant delegation layers, or structural inconsistencies in the design.
- Stakeholder Presentations: Export professional Mermaid or GraphML diagrams to communicate the operational logic and organizational structure of AI agents to non-technical stakeholders.
| name | agent-hierarchy-diagram |
|---|---|
| description | "Generate visual hierarchy diagrams of agent system showing levels and delegation. Use for documentation or onboarding." |
| mcp_fallback | none |
| category | agent |
| user-invocable | false |
Agent Hierarchy Diagram
Generate visual diagrams showing agent system structure and relationships.
When to Use
- Documenting agent system for team
- Understanding delegation structure
- Onboarding new contributors
- Visualizing agent relationships for presentations
Quick Reference
# Generate ASCII tree diagram
./scripts/generate_hierarchy_diagram.sh
# Generate Mermaid diagram
./scripts/generate_mermaid_diagram.sh > hierarchy.mmd
# Save to documentation
./scripts/generate_hierarchy_diagram.sh > agents/hierarchy-visual.txt
ASCII Tree Format
Chief Architect (L0)
├── Foundation Orchestrator (L1)
│ ├── Repository Design (L2)
│ │ ├── Directory Specialist (L3)
│ │ │ └── Junior Engineer (L5)
│ │ └── Config Specialist (L3)
│ └── Config Design (L2)
├── Shared Library Orchestrator (L1)
│ └── Tensor Module Design (L2)
│ └── Tensor Specialist (L3)
└── Tooling Orchestrator (L1)
Mermaid Format
graph TD
A[Chief Architect L0] --> B[Foundation Orchestrator L1]
B --> C[Repository Design L2]
C --> D[Directory Specialist L3]
D --> E[Junior Engineer L5]
Use Cases
- Add to
/agents/hierarchy.mdfor reference - Include in onboarding documentation
- Create presentation materials
- Understand delegation chains
- Communicate structure to stakeholders
Output Formats
ASCII: Human-readable in terminals, copy-pasteable in docs
Mermaid: Renders in GitHub markdown, editable in Mermaid editor
GraphML: Import into diagram tools (yEd, Graphviz)
References
/agents/hierarchy.md- Existing hierarchy documentationagent-test-delegation- Validate diagram accuracy.claude/agents/- Agent configuration source