Skill Dependency Mapper

Map and visualize skill interdependencies. Find unused skills, detect circular dependencies, and discover complementary skill combinations.

Quick Start

# Scan all skills and build dependency map
python3 scripts/skill-mapper.py scan

# Show dependency graph as text tree
python3 scripts/skill-mapper.py graph

# Find unused/orphaned skills
python3 scripts/skill-mapper.py unused

# Suggest complementary skills for a given skill
python3 scripts/skill-mapper.py suggest --skill memory-health-monitor

# Health check of skill ecosystem
python3 scripts/skill-mapper.py health

# Export dependency data
python3 scripts/skill-mapper.py export --format json

Commands

| Command | Purpose |

|---------|---------|

| scan | Analyze all installed skills, build dependency map |

| graph | Display dependency graph as text tree |

| unused | Find skills with no references or imports |

| suggest | Suggest complementary skills |

| health | Ecosystem health check (missing deps, circular refs, stale skills) |

| export | Export dependency map as JSON/DOT |

| categories | Group skills by functional category |

How Dependencies Are Detected

1. Import scanning — Python import and from statements in scripts/

2. File references — Paths referenced in SKILL.md and scripts

3. Shared data files — Skills that read/write the same memory files

4. Semantic similarity — Skills with overlapping descriptions/keywords

5. Pipeline references — Skills mentioned in pipeline/queue files