skill-visualizer

name	skill-visualizer
description	Generate interactive HTML visualizations of the skills collection, codebase structure, or dependency graphs. Uses D3.js for interactive visualization with collapsible nodes, color-coded categories, and hover details. Triggers on "visualize skills", "generate skill map", "codebase visualization", or "show skill dependencies".
allowed-tools	Bash(python *), Read, Glob, Write
argument-hint	[type: skills|codebase|deps]

Skill Visualizer

Generate interactive HTML visualizations for exploring skills, codebase structure, and dependencies.

Overview

This skill creates browser-viewable HTML files with interactive diagrams. It supports multiple visualization types and outputs self-contained HTML files that open directly in any browser.

Arguments

• $0: Output type - skills, codebase, or deps (default: skills)

Examples:

• /skill-visualizer - Generate skills collection map
• /skill-visualizer skills - Generate skills collection map
• /skill-visualizer codebase - Generate codebase structure visualization
• /skill-visualizer deps - Generate skill dependency graph

Visualization Types

Skills Map (skills)

Generates an interactive force-directed graph of all skills showing:

• Skill nodes with name and type indicator
• Color coding by skill type:
  • Green: Orchestrators (context: fork)
  • Blue: Read-only (allowed-tools restrictions)
  • Orange: Hybrid (standard skills)
• Hover tooltips with skill descriptions
• Drag to reposition nodes

Codebase Structure (codebase)

Generates a treemap visualization of the project structure:

• Directory hierarchy with expandable nodes
• File type distribution by color
• Size indicators for each file/directory

Dependency Graph (deps)

Generates a directed graph showing skill dependencies:

• Which skills invoke other skills
• Integration points between skills
• Visual workflow representation

Usage

1. Invoke the skill with desired output type
2. The skill runs Python scripts to analyze the codebase
3. Generates self-contained HTML with embedded CSS/JS
4. Opens in default browser automatically

# Run directly
python ~/.claude/skills/skill-visualizer/scripts/visualize.py skills

# Output location
docs/visualizations/skills-map-YYYY-MM-DD.html

Output

All visualizations are saved to docs/visualizations/:

• skills-map-YYYY-MM-DD.html
• codebase-structure-YYYY-MM-DD.html
• skill-deps-YYYY-MM-DD.html

HTML Features

• Self-contained: No external dependencies (D3.js embedded)
• Responsive design: Works on any screen size
• Interactive: Pan, zoom, drag nodes
• Tooltips: Hover for details
• Dark theme: Easy on the eyes
• Export-ready: Can screenshot for documentation

Python Scripts

The skill uses Python scripts in scripts/ directory:

• visualize.py - Main visualization generator
• Requires only standard library (no pip install needed)