README.md

June 21, 2026 ยท View on GitHub

Library Skills

Library Skills, AI Agents using libraries, as intended, always up to date.

Test Coverage Python package version npm package version

Documentation: https://library-skills.io

Source Code: https://github.com/tiangolo/library-skills

Let your AI agents use libraries as intended, always up to date.

Supporting libraries (e.g. FastAPI, Streamlit) include their own AI skills (https://agentskills.io) embedded, updated in sync with each new version of the library.

In Python, you can install them with:

uvx library-skills

In JavaScript/TypeScript, you can install them with:

npx library-skills

This will scan the dependencies for the current project, find the installed libraries, and show the current skill installation status.

It can install new skills, repair managed symlinks that point to old skill locations, and remove managed symlinks for packages or skills that disappeared.

It will only remove managed symlinks, not hand-authored skill directories.

Then it will ask where to install new skills and add them as symbolic links, so when you update the libraries, the skills are updated too.

The symlinks are relative, so projects with stable repo-local installs can commit them to Git. They may be broken before dependencies are installed, then resolve after setup. On Windows, real symlink checkout can require Developer Mode or elevated permissions; use --copy if symlinks are not practical.

By default it selects .agents/skills, the agent-neutral target. If the project already has a .claude/ directory, it selects .claude/skills too.

/// tip

If you are using Claude Code, select .claude/skills when asked for installation targets, as Claude Code doesn't support the standard .agents directory. For non-interactive installs, add the --claude CLI option to install the skills in .claude/skills too.

///

Why Library Skills

LLMs are great at helping you code, but are trained on data that existed until a certain point in time, which in the end, is always old data.

Additionally, they are trained on a lot of code examples, that in many cases use old patterns.

When there are new features or changes in the libraries, agents normally don't know about them, don't know how to use them, and insist on using old, deprecated, and sometimes hallucinated patterns.

But library authors can help them, providing official library skills that are always up to date, included in each new version of the package, in sync with the version of the library installed.

And you can install and use these official Library Skills for Agents with one command.

License

This project is licensed under the terms of the MIT license.