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

library-skills

GitHub

管理代理技能库，用于发现、安装、刷新、修复和检查由已安装包捆绑的Agent技能，处理符号链接状态。

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

Trigger Scenarios

项目依赖安装后需要发现并安装捆绑的技能管理的技能符号链接陈旧、损坏或孤立需要修复

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/ts/src/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.