Skip to content

Use Library Skills

In your project directory, run:

$ uvx library-skills

$ npx library-skills

Tip

That's all you need, if that worked, you can close this page, go build something. 😎

If you want to learn more, continue reading.

How It Works

This command will:

  • Check the dependencies you have defined, in pyproject.toml or package.json.
  • Scan your project installation environment, e.g. a .venv directory or PEP 832 .venv redirect file in Python, or node_modules in Node.js.
  • Find the skills available from the libraries you have installed, by default, filtered by your direct dependencies.
  • Ask you which skills you want to install.
  • For each skill you select, it will create a symbolic link in the .agents directory. If you are in a system that doesn't support symbolic links, you can make it copy the file with --copy.

Tip

Only use --copy if your system doesn't support symbolic links (e.g. could happen on Windows).

By default, it will create symbolic links, which means that if you update the library, its skills will be automatically updated.

Agents

This will work with AI Agents that support the .agents directory (most of them), including:

  • Codex
  • Cursor
  • GitHub Copilot
  • Pi
  • Antigravity
  • OpenCode

Claude Code

If you are using Claude Code, it doesn't support the .agents directory, only the .claude directory. Then you can run the commands with --claude to use the .claude directory.

$ uvx library-skills --claude

$ npx library-skills --claude

Other Installations

The CLI program library-skills is designed to make it work with uvx or npx.

That way, it will run in its own temporary environment, but will still check and scan your project's environment for the libraries you have installed.

But in the end, it's just a Python or JavaScript CLI package that you can install and run in any other way.

For example, with pip:

$ pip install library-skills
$ library-skills

Or with Bun:

$ bunx library-skills

Python and Node.js

The CLI is built in parallel in both Python and TypeScript, so you can use it from the ecosystem you prefer.

So, if you use Python, you can stay in Python, you don't even need Node.js installed.

And if you use Node.js, you can stay in Node.js, you don't even need Python installed.

In both cases, it will scan both the Python and Node.js environments, if available.

JSON Output

For automation or scripts, use scan --json to get the discovered skills as machine-readable JSON:

$ uvx library-skills scan --json

$ npx library-skills scan --json

The output includes the project root, detected Python environment, detected node_modules directory, discovered skills, and any warnings.

Use list --json to include the current installation status too:

$ uvx library-skills list --json

$ npx library-skills list --json

The list --json output has the same fields as scan --json, plus an installed array with installed skill targets and status.