skill-graph-audit

# Skill Graph Audit ## Overview Build a directed graph of `Skill(plugin:name)` invocations across the marketplace and surface composition patterns: which skills are heavily referenced (hubs), which orchestrate many others (orchestrators), which have no incoming or outgoing references (isolates), and which point at non-existent skills (dangling references). The federation graph is now derivable from source rather than hand-curated. ## When To Use - Before a documentation pass on skill composition - After a renaming or retirement to catch broken `Skill()` references - During quarterly audits to spot orphaned skills - When evaluating consolidation candidates (hubs are higher-risk to merge) - When a new skill's outbound references should be sanity-checked ## When NOT To Use - For per-skill quality scoring, use `Skill(abstract:skills-eval)` instead - For frontmatter/structure validation, use `Skill(abstract:plugin-review)` - For hook-specific audits, use `Skill(abstract:hooks-eval)` ## Quick Start ```bash python3 plugins/abstract/scripts/skill_graph.py \ --plugins-root plugins --top-n 10 ``` For machine-readable output: ```bash python3 plugins/abstract/scripts/skill_graph.py \ --plugins-root plugins --format json --output reports/skill-graph.json ``` See `modules/usage.md` for full CLI reference and example workflows. ## Core Outputs | Output | Meaning | Action when high | |--------|---------|------------------| | Hubs | Most-referenced skills | Treat as core API...