Skill dependency graph visualization

[elijahr]

Problem

Spellbook has 60+ skills and commands with complex interdependencies (skills invoke commands, commands reference other commands, skills route to phase commands). Understanding this web is difficult from reading individual files.

Concept

Generate a visual dependency graph showing:

• Which skills depend on which commands
• Which commands invoke other commands
• Shared infrastructure (common commands used by many skills)
• Orphaned commands (not referenced by any skill)

Possible Approaches

1. Static Mermaid diagram - Generated by a script, embedded in docs. GitHub renders Mermaid natively.
2. Interactive D3.js visualization - Hosted on the docs site. Clickable nodes that link to skill/command docs.
3. CLI output - spellbook graph command that renders in the terminal using Rich/Textual.

Data Source

Parse YAML frontmatter and body content of all SKILL.md and command .md files. Look for:

• /command-name invocations in skill bodies
• Skill tool references in dispatch templates
• invoke the [X] skill patterns