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). Scans skills bundled in Claude Code / Cursor / Codex / agents plugins. Filter by project / user scope and agent; multi-select for bulk actions - Sidebar: left nav splits the list into manual (plus plugin-bundled skills) / gh / npx / plugins / mcp, then project scan roots (divider between the two groups).
h/l(or Tab) move focus;j/kon the sidebar changes category;tstill cycles - Metrics: Compute activation rate from conversation logs and show a delete-recommendation score (
delete_score) - Add: Skills via
gh skill/npx skills. Plugins viaclaude plugin/copilot plugin/codex plugin(Cursor has no catalog CLI) - Delete: Remove inventory paths (confirmation required). npx-sourced skills also run
npx skills remove. Plugin delete uses the host catalog CLI first. Warns on shared-store and plugin paths - Update: Skills via
gh skill/npx skills. Plugins via the same catalog CLIs (Codex re-runsplugin add)
Dependencies
| Required | Optional |
|---|---|
| Rust 1.85+ (edition 2024) | gh (gh skill) |
Node.js / npx (npx skills) |
|
claude / copilot / codex (plugin catalog add / update / delete) |
Listing and activation metrics work without gh / npx / plugin CLIs. 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.
Config file
~/.config/skls/config.toml ($XDG_CONFIG_HOME/skls/config.toml when set). Extra folders are project-scope scan roots, in addition to the current directory (or --project-root). If the file is missing, skls walks only these home children — repos, src, dev, code, work, projects, orca, Documents, Developer, ghq, git — to depth 6 (cap 4000 visits / 80 projects) for directories that contain .cursor/skills, .claude/skills, .agents/skills, or .codex/skills, then writes that list. If nothing is found, the file is not created (the next launch can try again). An existing file is never overwritten. Delete the file to rediscover.
= [
"~/src/my-app",
"/abs/path/to/other-app",
]
# Activation analysis defaults (CLI flags win when passed)
= 30
= 80
= 262144
Relative paths, missing paths, and home itself are skipped with a warning. ~ expands to home. If the current directory (or --project-root) is home, that path is not scanned as a project; listed projects still are. Skills with the same name in different projects show as separate rows. The list PROJECT column is the directory name; user-scope rows show -.
Project-scope add still targets only the active root (cwd / --project-root), not the project selected in the sidebar. If that root is home, choose user scope or pass --project-root.
Screen
The left sidebar splits the inventory: manual (plus plugin-bundled skills) · gh · npx · plugins · mcp, then a gray divider, then projects from config / cwd (directory name). The divider is visual only (not selectable). Selecting a project shows only skills whose paths sit under that root. List in the center, detail on the right. h/l (or Tab) move focus between sidebar and list. [ ] / [x] mark multi-select.
Skills columns: NAME · SCOPE · PROJECT · SRC (plugin / gh skill / npx skills / manual) · AUTHOR · RATE · SCORE. NAME / PROJECT / SRC / AUTHOR grow with the longest visible value; leftover width goes to NAME. SCOPE / RATE / SCORE stay fixed. Default sort is delete_score descending (higher = stronger delete candidate). S toggles asc/desc; cycling with s resets to that key's default direction. Author comes from the SKILL.md frontmatter, the plugin manifest, or the GitHub owner of the source repo.
Plugins columns: NAME · SCOPE · MARKET · SK (bundled skills) · MCP. NAME / MARKET grow the same way.
MCP columns: NAME · TRANS (stdio / http / sse) · PLUGIN · AGENTS. NAME / PLUGIN / AGENTS grow the same way. Servers are read from plugin mcp.json / .mcp.json (Agent Plugins 1.0, plus a looser command/url form).
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 |
|---|---|
h / l |
Focus sidebar / list (Tab toggles) |
j / k |
Move (sidebar or list) |
Ctrl+F / PgDn |
Page down (no wrap; list) |
Ctrl+B / PgUp |
Page up (no wrap; list) |
gg / Home |
Jump to first row (list) / first nav item (sidebar) |
L / Ctrl+L / End |
Jump to last row (list) / last nav item (sidebar) |
t |
Cycle sidebar (manual → gh → npx → plugins → mcp → projects) |
Space |
Toggle row selection |
* |
Select / clear all visible |
x |
Clear selection |
/ |
Search name / description |
f |
Filter panel |
s |
Cycle sort key (name → rate → delete_score → last_hit → author → source); resets direction to that key's default |
S |
Toggle sort direction (asc / desc) |
a |
Add flow (manual: pick gh/npx; gh/npx nav: that backend; plugins: catalog CLI) |
d |
Delete confirm (selection if any, else current row) |
u |
Update |
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)
On the manual nav, 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
On the gh / npx nav, the backend picker is skipped and that installer is used directly.
On the plugins nav, enter a catalog spec (name@marketplace), pick hosts that have a plugin CLI (claude-code / copilot / codex), then scope. Cursor has no catalog CLI — install from the host marketplace.
On the mcp nav, a / u point you at the plugins sidebar item (servers are bundled in plugins).
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) or inside a plugin install produce a warning; duplicate paths are deduped - After delete, only the list is rescanned. Press
Rto recompute activation
Plugin delete (plugins view, or MCP view via the parent plugin) runs the host catalog CLI first:
| Host | CLI |
|---|---|
| Claude Code | claude plugin uninstall SPEC --scope user|project |
| Copilot | copilot plugin uninstall NAME |
| Codex | codex plugin remove NAME |
| Cursor | no CLI — message only; path left in place |
If every CLI call fails, inventory paths are removed as a fallback.
Update (u)
Skills
- 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.
Plugins pick agents then run:
| Host | CLI |
|---|---|
| Claude Code | claude plugin update SPEC --scope … |
| Copilot | copilot plugin update NAME |
| Codex | codex plugin add SPEC (re-install) |
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.
Plugins
Skills bundled inside agent plugins are attributed to the host that owns the files:
| Store | Path | Attributed to |
|---|---|---|
| Claude Code | ~/.claude/plugins/ (via installed_plugins.json, scope from the manifest) |
claude-code |
| Cursor | ~/.cursor/plugins/cache/*/*/*/skills/ |
cursor |
| Codex | ~/.codex/plugins/cache/*/*/*/skills/ |
codex |
| agents | ~/.agents/plugins/ (lenient walk for skills/ dirs) |
the shared-store hosts (cursor / cline / warp / universal) |
Plugin skills are marked source: plugin. They are not updated via gh / npx, and deleting a skill path inside a plugin warns that the path lives inside a plugin install.
Use the plugins view (t) to add / update / uninstall the package from a catalog instead. Bundled MCP servers (mcp.json / .mcp.json) appear on the mcp view.
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 (日本語).