skillstat 0.1.0

Diagnose, audit, and optimize your AI agent skill usage across tools

skillstat 🩺

Diagnose, audit, and optimize your AI agent skill usage across tools.

Install

# Option 1: pipx (recommended — isolated env, global command)
pipx install skillstat

# Option 2: curl one-liner
curl -fsSL https://raw.githubusercontent.com/QY0831/skillstat/main/install.sh | bash

# Option 3: pip
pip install skillstat

Usage

# Interactive mode (prompts for source, time window, etc.)
skillstat

# Non-interactive
skillstat --source copilot claude --all
skillstat --source copilot --days 30 --json
skillstat --source opencode --all --limit 20

What it does

⚡ skillstat
  ✓ Found 100 installed skills
  ✓ Health check: 95 healthy, 5 with issues
  ✓ GitHub Copilot: 70 skill events
  ✓ Claude Code: 25 skill events

╭───────────────── 📊 Skill Usage Report ──────────────────╮
│   Sources:   GitHub Copilot, Claude Code                  │
│   Skills:    100 installed, 28 used, 72 unused            │
╰──────────────────────────────────────────────────────────╯

  # Skill          Loads  Sessions  Projects
  1 diagnose          18       15         7  ████████
  2 aws-cdk            7        6         5  ███░░░░░
  ...

╭───────────────── 🔍 Skill Audit ─────────────────────────╮
│  ⭐ MOST USED — last 4 weeks                              │
│  ▲ RISING — diagnose ↑1600%                               │
│  ⚠ STALE — find-skills (unused 28+ days)                  │
│  ◈ CROSS-PROJECT — diagnose (7 projects)                  │
│  ◇ ONE-OFF — aws-serverless (used once)                   │
╰──────────────────────────────────────────────────────────╯

Supported agents

Agent	Storage	Detection method
GitHub Copilot	~/.copilot/session-store.db	<skill-context name="...">
Claude Code	~/.claude/	Slash commands + Skill tool_use
Codex CLI	~/.codex/sessions/	<name>X</name> in responses
OpenCode	~/.local/share/opencode/	SQLite tool='skill'
Grok CLI	~/.grok/sessions/	<command-name> in updates
Droid CLI	~/.factory/sessions/	Skill "X" is now active

Features

• Health Check — validates SKILL.md structure (name, description, file size)
• Skill Audit — classifies skills: most-used / rising / declining / stale / one-off / cross-project
• Multi-source — aggregates across all your AI tools in one report
• JSON output — --json for piping to jq, dashboards, CI
• Zero config — auto-detects installed agents, no setup needed

Skill directories scanned

~/.agents/skills/
~/.claude/skills/
~/.copilot/skills/
~/.copilot/installed-plugins/
~/.claude/plugins/

License

MIT