skls
skls (skills list) — a TUI for managing agent skills across Cursor, Claude Code, Codex, and 20+ other hosts.
See which skills are installed, where they apply, and whether they are used — then add, delete, or update them from the same screen.

Features
- Inventory: 27 agent hosts (Cursor loads
~/.agents/skillstoo). Filter by project / user scope and agent; multi-select for bulk actions - Metrics: Compute activation rate from conversation logs and show a delete-recommendation score (
delete_score) - Add: Install with
gh skillornpx skills(chosen each time). Defaults to cursor / claude-code / codex;*selects every host - Delete: Remove inventory paths (confirmation required). npx-sourced skills also run
npx skills remove. Warns on shared-store paths - Update: Choose
gh skill/npx skills. If provenance can be inferred, Enter accepts the suggestion
Dependencies
| Required | Optional |
|---|---|
| Rust 1.85+ (edition 2024) | gh (gh skill) |
Node.js / npx (npx skills) |
Listing and activation metrics work without gh / npx. Only operations that need a missing CLI are disabled.
Install / run
From crates.io:
From source:
# or: cargo run --release
CLI options
On startup the skill list appears first, then activation is sampled. With defaults, the list usually shows within about 1–2 seconds.
Screen
List on the left, detail on the right. [ ] / [x] mark multi-select. Default sort is delete_score (higher = stronger delete candidate).
sample: in the title is the activation analysis cap; sampled (-N older) in the status is how many older sessions were skipped.
Keybindings
| Key | Action |
|---|---|
j / k |
Move |
Space |
Toggle row selection |
* |
Select / clear all visible |
x |
Clear selection |
/ |
Search name / description |
f |
Filter panel |
s |
Cycle sort (name → rate → delete_score → last_hit) |
a |
Add flow |
d |
Delete confirm (selection if any, else current row) |
u |
Update (pick backend; Enter uses suggestion when available) |
r |
Light rescan (list only) |
R |
Recompute activation stats |
? |
Help |
q |
Quit |
Filter (f)
| Key | Meaning |
|---|---|
p / u / a |
project / user / all scopes |
j / k · Space |
Move / toggle agent filter (empty = all) |
* / 0 |
Clear agent filter (all agents) |
x |
Clear agent filter |
c |
Clear all filters |
Add (a)
Step through dialogs. Esc goes back one step; q cancels.
- Backend:
1/g=gh skill,2/n=npx skills - Source (gh: search query; npx:
owner/repoorowner/repo@skill) - Pick result (gh only)
- Agents (
j/kmove,Spacetoggle,*all,xnone;Enternext) → scope (p/u) to run
Delete (d)
- Starts with all agents present on the target skills selected
j/kmove,Spacetoggle,*select all,xclear ally/Enterconfirm;n/q/Esccancel- Removes inventory paths first; for
source: npx, also runsnpx skills removeper selected agent - Paths under a shared store (e.g.
~/.agents/skills) produce a warning; duplicate paths are deduped - After delete, only the list is rescanned. Press
Rto recompute activation
Update (u)
- Agents:
j/kmove,Spacetoggle,*all,xnone;Enternext - Backend:
1/g=gh skill,2/n=npx skills(Escreturns to agent selection) - When a suggestion exists,
Enteraccepts it - If only one CLI is available, the backend picker is skipped
Suggestion priority:
| Signal | Suggested |
|---|---|
SKILL.md has github-repo / github-tree-sha, or provenance from gh skill list |
gh skill |
Present in ~/.agents/.skill-lock.json (or project lock) |
npx skills |
| Both | prefer gh skill |
| Mixed / unknown | no suggestion (pick manually) |
gh skill update prefers host dirs with metadata (.cursor / .codex, …) for --dir. npx skills update adds -g / -p from scope.
Scan roots
| Agent | project | user |
|---|---|---|
| cursor | .agents/skills/ · .cursor/skills/ |
~/.cursor/skills/ · ~/.agents/skills/ · ~/.cursor/skills-cursor/ |
| claude-code | .claude/skills/ |
~/.claude/skills/ |
| codex | .agents/skills/ · .codex/skills/ |
~/.codex/skills/ |
| gemini-cli | — | ~/.gemini/skills/ |
| antigravity / antigravity-cli / antigravity2.0 | — | ~/.gemini/antigravity{,-cli}/skills/ · ~/.gemini/config/skills/ |
| github-copilot | — | ~/.copilot/skills/ |
| opencode | — | ~/.config/opencode/skills/ |
| pi | — | ~/.pi/agent/skills/ |
| amp / kimi-cli / replit | — | ~/.config/agents/skills/ |
| qwen-code | — | ~/.qwen/skills/ |
| augment / continue / droid / kilo / qoder / roo / trae / codebuddy | — | ~/.<host>/skills/ (droid → ~/.factory/skills/) |
| grok / warp / devin | — | ~/.grok/skills/ · ~/.warp/skills/ · ~/.config/devin/skills/ |
| cline / warp / universal | — | also linked to shared ~/.agents/skills/ |
The same skill on multiple hosts is merged into one row. Add flow defaults to cursor / claude-code / codex (* selects every host).
Extra metadata:
- If
gh skill list --jsonis available, attachsource_url/version/pinned - If
~/.agents/.skill-lock.jsonexists, setsource: npx(startup does not callnpx skills list)
Scope vocabulary follows gh skill (project / user). npx skills -g is treated as user.
Activation rate and delete score
Parse session logs for the last N days (default 30) and count skill-name or path mentions uniquely per session.
| Source | Path |
|---|---|
| Cursor | ~/.cursor/projects/**/agent-transcripts/**/*.jsonl |
| Claude Code | ~/.claude/projects/**/*.jsonl |
| Codex | ~/.codex/sessions/**/rollout-*.jsonl |
activation_rate=hits / sessions_total(N/A when sessions are 0)delete_scoreis higher for stronger delete candidates (sum of the points below)- Detail labels:
keep(under 35) /review(35–59) /consider delete(60+)
delete_score points (see src/analytics/score.rs):
| Factor | Condition | Points |
|---|---|---|
| Activation rate | no sessions / unknown | +25 |
| 0% | +40 | |
| under 5% | +30 | |
| under 15% | +15 | |
| under 30% | +5 | |
| Last hit | none | +20 |
| over 60 days | +25 | |
| over 30 days | +15 | |
| over 14 days | +8 | |
| Host count | 3+ agents | +10 |
| 2 agents | +5 | |
| Provenance | manual and no source_url |
+5 |
| Hits | hits == 0 |
+10 |
Log matching is heuristic — not a precise “skill execution count”. Use it as a signal before deleting.
For speed, defaults read only the latest 80 sessions per agent and up to 256KiB per file. Change with --max-sessions / --max-bytes / --full-scan.
Development
See AGENTS.md for layout and contributor notes.
Changelog
See CHANGELOG.md (日本語).