@crafter/skillkit 0.1.3 → 0.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +113 -0
- package/package.json +1 -1
- package/src/bin.ts +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
# skillkit
|
|
2
|
+
|
|
3
|
+
Local-first analytics for AI agent skills. Track usage, measure context budget, and prune what you don't use.
|
|
4
|
+
|
|
5
|
+
## Why
|
|
6
|
+
|
|
7
|
+
AI coding agents load skills into their context window on every session. More skills = less room for your actual code. But which skills do you actually use? Which ones are wasting context budget?
|
|
8
|
+
|
|
9
|
+
**skillkit** answers these questions by scanning your session files, tracking invocations, and surfacing actionable insights - all locally on your machine.
|
|
10
|
+
|
|
11
|
+
## Quick Start
|
|
12
|
+
|
|
13
|
+
```bash
|
|
14
|
+
npx @crafter/skillkit scan
|
|
15
|
+
npx @crafter/skillkit stats
|
|
16
|
+
npx @crafter/skillkit health
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
Or install globally:
|
|
20
|
+
|
|
21
|
+
```bash
|
|
22
|
+
npm i -g @crafter/skillkit
|
|
23
|
+
skillkit scan
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
## Commands
|
|
27
|
+
|
|
28
|
+
| Command | Description |
|
|
29
|
+
|---------|-------------|
|
|
30
|
+
| `skillkit scan` | Discover installed skills and index session data |
|
|
31
|
+
| `skillkit list` | List installed skills with size and context budget |
|
|
32
|
+
| `skillkit stats` | Usage analytics with sparklines (last 30 days) |
|
|
33
|
+
| `skillkit health` | Health check: unused skills, context budget, DB |
|
|
34
|
+
| `skillkit prune` | Remove unused skills to reclaim context budget |
|
|
35
|
+
|
|
36
|
+
Install skills via [skills.sh](https://skills.sh): `npx skills add <owner/repo>`
|
|
37
|
+
|
|
38
|
+
## How It Works
|
|
39
|
+
|
|
40
|
+
### Scan
|
|
41
|
+
|
|
42
|
+
Discovers skills from `~/.claude/skills/` and indexes session files from `~/.claude/projects/`. Detects whether each skill was installed via skills.sh or manually.
|
|
43
|
+
|
|
44
|
+
```
|
|
45
|
+
$ skillkit scan
|
|
46
|
+
Scanning ~/.claude/skills/ ...
|
|
47
|
+
Found 12 skills (8 via skills.sh, 4 manual)
|
|
48
|
+
Scanning sessions...
|
|
49
|
+
Indexed 211 sessions · 1,847 invocations
|
|
50
|
+
|
|
51
|
+
Ready. Run skillkit stats to see usage.
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
### Stats
|
|
55
|
+
|
|
56
|
+
Parses JSONL session files for `Skill` tool_use blocks and shows sparkline trends.
|
|
57
|
+
|
|
58
|
+
```
|
|
59
|
+
$ skillkit stats
|
|
60
|
+
SKILL ████████████████████ 42 ▂▃▅▇█▆▅▇█
|
|
61
|
+
commit ████████████████████ 42 ▂▃▅▇█▆▅▇█
|
|
62
|
+
review ████████████████ 38 ▁▃▅▆▇▇▆▅▃
|
|
63
|
+
deploy ████████████ 27 ▁▁▂▃▅▇█▇▅
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
### Health
|
|
67
|
+
|
|
68
|
+
Checks metadata budget usage (name + description loaded at startup) and flags unused skills.
|
|
69
|
+
|
|
70
|
+
```
|
|
71
|
+
$ skillkit health
|
|
72
|
+
[████████░░] 78% metadata budget (12.5K / 16.0K)
|
|
73
|
+
! 3 skills unused in 30d — run skillkit prune
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
### Prune
|
|
77
|
+
|
|
78
|
+
Removes skills that haven't been used in the last 30 days.
|
|
79
|
+
|
|
80
|
+
```
|
|
81
|
+
$ skillkit prune
|
|
82
|
+
x scaffold (0.9K)
|
|
83
|
+
x lint (2.1K)
|
|
84
|
+
|
|
85
|
+
2 skills · 3.0K context reclaimable
|
|
86
|
+
|
|
87
|
+
Run with --yes to confirm deletion.
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
## Data Storage
|
|
91
|
+
|
|
92
|
+
All data stays on your machine. No telemetry. No signup.
|
|
93
|
+
|
|
94
|
+
| Path | Purpose |
|
|
95
|
+
|------|---------|
|
|
96
|
+
| `~/.skillkit/analytics.db` | SQLite database with invocation history |
|
|
97
|
+
| `~/.claude/skills/` | Installed skills (read-only) |
|
|
98
|
+
| `~/.claude/projects/**/*.jsonl` | Session files (read-only) |
|
|
99
|
+
|
|
100
|
+
## Supported Agents
|
|
101
|
+
|
|
102
|
+
Works with any agent that logs tool use in JSONL session files:
|
|
103
|
+
|
|
104
|
+
- Claude Code
|
|
105
|
+
- Cursor
|
|
106
|
+
- Codex
|
|
107
|
+
- VS Code (via extensions)
|
|
108
|
+
- Windsurf
|
|
109
|
+
- Gemini CLI
|
|
110
|
+
|
|
111
|
+
## License
|
|
112
|
+
|
|
113
|
+
MIT
|
package/package.json
CHANGED