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
The Agent Hierarchy Diagram skill is a specialized developer tool designed to visualize the structural complexity of multi-agent systems. By generating ASCII trees, Mermaid diagrams, and GraphML files, it transforms abstract agent delegation logic into clear, readable visual hierarchies, essential for documenting orchestration flows and system architecture.
Use Cases
- Technical Documentation: Automatically generate and embed Mermaid diagrams into GitHub READMEs or agent-specific documentation to show system structure.
- Team Onboarding: Provide new developers with a clear visual map of agent relationships, levels (L0-L5), and delegation chains to accelerate project understanding.
- Architecture Design & Review: Use visual diagrams to communicate complex multi-agent orchestration strategies to stakeholders and during architectural planning sessions.
- System Debugging: Identify structural inefficiencies or incorrect delegation paths by visualizing the hierarchy of specialized agents and their supervisors.
| 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 |
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