$npx -y skills add crafter-station/skill-kit --skill skillLocal-first analytics for AI agent skills. Use when user asks about skill usage, analytics, health, context budget, or wants to clean up unused skills.
| 1 | # SkillKit |
| 2 | |
| 3 | Analytics for AI agent skills. Tracks usage, measures context budget, and prunes what you don't use. |
| 4 | |
| 5 | ## Commands |
| 6 | |
| 7 | SkillKit is an npm CLI. Run commands with `npx @crafter/skillkit <command>` or install globally first (`npm i -g @crafter/skillkit`). |
| 8 | |
| 9 | - `npx @crafter/skillkit stats` - Usage analytics with sparklines (auto-scans on first run) |
| 10 | - `npx @crafter/skillkit stats --all` - Show all skills, not just top 10 |
| 11 | - `npx @crafter/skillkit stats --days N` - Change time range (default: 30) |
| 12 | - `npx @crafter/skillkit stats --all --days 90` - Full list over 90 days |
| 13 | - `npx @crafter/skillkit list` - List installed skills with size and context budget |
| 14 | - `npx @crafter/skillkit health` - Health check: unused skills, context budget, DB status |
| 15 | - `npx @crafter/skillkit prune` - List unused skills. Add `--yes` to confirm deletion |
| 16 | - `npx @crafter/skillkit scan` - Force re-scan (runs automatically, rarely needed) |
| 17 | - `npx @crafter/skillkit scan --include-commands` - Also track slash commands |
| 18 | - Any command with `--claude` or `--opencode` to filter by agent |
| 19 | |
| 20 | ## When to Use |
| 21 | |
| 22 | - User asks "which skills do I use the most?" |
| 23 | - User asks "are there unused skills?" or "clean up my skills" |
| 24 | - User wants to see skill analytics, usage trends, or context budget |
| 25 | - User wants to optimize their skill setup |
| 26 | - User asks about context window usage from skills |
| 27 | - User asks "show me all my skill usage" or "full stats" |
| 28 | |
| 29 | ## Decision Guide |
| 30 | |
| 31 | 1. First time? Run `npx @crafter/skillkit stats` - it auto-discovers and indexes everything |
| 32 | 2. Full picture? Run `npx @crafter/skillkit stats --all --days 90` |
| 33 | 3. Want cleanup? Run `npx @crafter/skillkit health` then `npx @crafter/skillkit prune --yes` |
| 34 | 4. Quick overview? Run `npx @crafter/skillkit list` for installed skills with sizes |
| 35 | 5. Filter by agent? Add `--claude` or `--opencode` to any command |
| 36 | |
| 37 | ## How It Works |
| 38 | |
| 39 | Discovers skills for Claude Code and OpenCode. Scans skill directories and project-local `.claude/skills/` for installed skills. Indexes Claude Code JSONL sessions and OpenCode SQLite sessions. Extracts `Skill` tool_use blocks from assistant messages and `<command-name>` tags from user messages. Auto-deduplicates on every scan. All data stored locally in `~/.skillkit/analytics.db`. |