Metadata-Version: 2.4
Name: skillstat
Version: 0.1.0
Summary: Diagnose, audit, and optimize your AI agent skill usage across tools
Project-URL: Homepage, https://github.com/QY0831/skillstat
Project-URL: Repository, https://github.com/QY0831/skillstat
Project-URL: Issues, https://github.com/QY0831/skillstat/issues
Author: Qin-Yu Chen
License-Expression: MIT
License-File: LICENSE
Keywords: agent,ai,analytics,claude,cli,copilot,skills
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Requires-Dist: inquirerpy>=0.3.4
Requires-Dist: rich>=13.0
Description-Content-Type: text/markdown

# skillstat 🩺

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

## Install

```bash
# 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

```bash
# 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
