| name | library-skills |
| description | Use Library Skills to discover, install, refresh, repair, check, and manage agent skills from installed packages. |
Library Skills
Use this skill when a project might benefit from agent skills bundled by its installed packages, or when existing Library Skills-managed symlinks are stale, broken, orphaned, or need to be checked.
Run commands from the project root.
Agents bundle their own skills by including an .agents/skills directory. More details in Library Skills.
First-Time Setup
- Make sure project dependencies are installed first, for example with
uv sync for Python projects or npm install / bun install for Node.js projects.
- Run
uvx library-skills or npx library-skills to discover skills bundled by the installed packages and install selected skills interactively.
- Use
uvx library-skills --all or npx library-skills --all only when all newly discovered skills should be installed without selecting individual skills.
- Use
uvx library-skills --tool-skill or npx library-skills --tool-skill to copy this Library Skills tool skill into the project so future agents know how to discover, install, update, repair, and check skills.
Commands
- Run
uvx library-skills or npx library-skills to discover package-provided skills, install selected new skills, and reconcile existing managed symlinks.
- Run
uvx library-skills list or npx library-skills list to inspect discovered and installed skills.
- Run
uvx library-skills list --json or npx library-skills list --json for machine-readable installed status.
- Run
uvx library-skills scan --json or npx library-skills scan --json for discovery-only automation.
- Run
uvx library-skills --check or npx library-skills --check to validate managed skill symlink state without changing files.
- Run
uvx library-skills --yes or npx library-skills --yes to repair stale managed symlinks and remove orphaned managed symlinks non-interactively.
- Add
--claude when .claude/skills should also be managed.
- Add
--skill NAME to install a specific discovered skill by name.
Safety
- Prefer rerunning
library-skills over editing managed symlinks manually.
- If installed skill symlinks are broken, dependencies may not be installed yet. Try the project's normal install command first, such as
uv sync, npm install, or bun install, then rerun library-skills.
- Do not delete or overwrite hand-authored skill directories.
- Library Skills only removes managed symlinks. It should not remove copied or hand-authored skill directories.
