Agent Skills › tiangolo/library-skills › library-skills

library-skills

GitHub

管理项目中通过包捆绑的 Agent Skills，支持发现、安装、刷新、修复和检查技能链接。适用于处理过时、损坏或孤立的符号链接，确保 Agent 能正确识别和使用已安装的技能。

src/library_skills/tool_skill/SKILL.md tiangolo/library-skills

Trigger Scenarios

需要发现并安装由依赖包提供的 Agent Skills 检查或修复过时的技能符号链接验证已安装技能的链接状态

Install

npx skills add tiangolo/library-skills --skill library-skills -g -y

More Options

Non-standard path

npx skills add https://github.com/tiangolo/library-skills/tree/main/src/library_skills/tool_skill -g -y

Use without installing

npx skills use tiangolo/library-skills@library-skills

指定 Agent (Claude Code)

npx skills add tiangolo/library-skills --skill library-skills -a claude-code -g -y

安装 repo 全部 skill

npx skills add tiangolo/library-skills --all -g -y

预览 repo 内 skill

npx skills add tiangolo/library-skills --list

SKILL.md

Frontmatter

{
    "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.