SkillRoster CLI
SkillRoster scans skills across all your agents, finds duplicates and broken links and builds a per-agent roster with undo.
- 54 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- It reads the skill folders of all agents and, once confirmed, moves and changes files.
- Agent hookup edits its configuration after a plan is shown.
Install
- Works in
Manual install
brew install tt-a1i/skillroster/skillrosterThe 30-second section of the README for macOS and Linux. Then `skillroster scan --summary` and `skillroster report`.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- It reads the skill folders of all agents and, once confirmed, moves and changes files.
- Agent hookup edits its configuration after a plan is shown.
This is third-party code. Review the repository files before installing.
What it does
SkillRoster is a Rust CLI that tidies the skills of several agents. It builds one library from the folders of Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Copilot, Hermes and pi, then finds duplicates, same-named skills with different content and links that lead nowhere. A Roster is built per agent: a selected list of abilities with the rest available on demand. Every change is first described as a Plan, a verification receipt remains after applying, and the action can be reversed with Undo. `skillroster scan --summary` and `skillroster report` give an overview, and `skillroster setup --json` shows where an agent hookup would go.
Who it is for. People who keep skills across several coding agents and worry that duplicates and old versions clutter the lists.
Good fit when
- The same skill sits in three folders and versions may have diverged.
- Codex's default list is too long but trimming it is scary.
- A full change plan and a way to revert are needed before cleanup.
- An agent cannot find rarely needed skills and they must open on demand.
Not a fit when
- You use one agent and a few skills.
- A service that downloads new skills is needed.
- Skill folders must not be touched even after a Plan and confirmation.
Example request
Check my skills, show duplicates and broken links and propose a Plan for Codex, changing nothing until I confirm.Limitations
The README is written in Chinese, with an English version available. Homebrew installation covers macOS and Linux, while Windows and Cargo are described in the guide. Read the Plan carefully before applying changes: the tool touches your agents' skill folders. After a successful Undo, rescan the library. Agent hookup through `setup --agent` first shows target files and refuses if a shared target cannot be changed in isolation.
How to disable. Remove the package with `brew uninstall skillroster` and drop the agent hookup that `skillroster setup --json` describes. Undo the needed changes before uninstalling.
FAQ
How do I install it?
On macOS and Linux run `brew install tt-a1i/skillroster/skillroster`, then `skillroster --version`. Windows, Cargo and releases are in `docs/installation.md`.
What does a Roster do?
It assembles a selected set of skills per agent from the shared library. Other skills stay available for on-demand search.
Can changes be undone?
Yes. A Plan is built before any change, a verification receipt is created after applying, and Undo reverses the action.
Which agents are supported?
Claude Code, Codex, Cursor, Gemini CLI, OpenCode, Copilot, Hermes and pi, judging by the project's test folders.
Must I hook up an agent?
Optional. The CLI works on its own, and agent hookup, `setup --agent codex`, is a separate step after a preview.
Discussion
No questions or reviews yet.
Related
CLI toolsA Go CLI that keeps skills, agents and rules in one place and syncs them into every AI agent with one command
cafe3310's personal skill collection: spec-driven project work, reviews, reports, browser, 3D and video in one repository
A desktop app and skm CLI: one copy of each skill in a central hub, symlinked into every AI tool
293 skills in 16 categories for Codex, Claude Code and Cursor with an npx installer, provenance and license checks
Skills Manager keeps skills in one library and mounts them into Claude Code, Cursor, Codex and other agents through symlinks, with no file copies
Four skills for a person with several AI assistants: a task register, evidence-based acceptance, beginner instructions
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| SkillRoster (this card) | no | 54 | |
| Universal Skills Manager | no | 115 | manages and syncs skills; SkillRoster finds duplicates and builds a per-agent list with a Plan and undo |
| skillshare | no | 3,070 | syncs skills between tools; SkillRoster picks a visible set per agent and checks versions |
README in short
The library holds the full list of known skills and a Roster is the subset an agent sees. Original files stay where they are.