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

library-skills

GitHub

用于发现、安装、刷新、修复和检查由已安装包捆绑的代理技能。管理.symlinks状态，支持首次设置、列表查看及自动化扫描，确保项目内技能依赖正确同步。

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

触发场景

需要发现并安装包捆绑的代理技能修复或检查过期的符号链接验证管理的技能链接状态

安装

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

更多选项

非标准路径

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

不安装直接使用

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.