Library Skills¶

Library Skills は、 Python ライブラリ用の「エージェントスキル」を、プロジェクトの AI コーディングエージェント（ Claude Code など）に向けてインストールする CLI ツール。 uvx で実行できる。

プロジェクトにインストール済みのライブラリ（ fastapi や sqlmodel など）を検出して、それぞれに対応するスキルを .claude/skills/ などへ相対シンボリックリンクで配置する。エージェントがそのライブラリの使い方を把握した状態で作業できるようにするためのもの。

スキルの中身（ SKILL.md ）は library-skills が持っているわけではなく、各ライブラリ側にエージェントスキルとして同梱されている。たとえば fastapi なら fastapi/.agents/skills/fastapi/SKILL.md がそれで、 library-skills はこれを読み込んで .claude/skills/ に配置する。

実行してみる¶

uvx library-skills を実行すると、対話形式でセットアップが進む。

ざっくりこんな流れ。

• context … プロジェクトルート・対象の Python 環境（ .venv ）・ site-packages を検出して表示する。
• status … インストールできるスキル（ここでは fastapi と sqlmodel ）と、その状態（ new ）を一覧にする。
• install … 入れるスキルと、入れ先（ターゲット）を選ぶ。ここでは Claude Code（ .claude/skills ）を選んでいる。
• 選んだスキルが .claude/skills/fastapi のように相対シンボリックリンクで配置される。リポジトリにコミットしておけば、依存をインストールし直したあとにリンクが解決される。
• 最後に「 Library Skills tool skill をプロジェクトにコピーするか」を聞かれる。入れておくと、エージェント自身がスキルの更新・修復・確認をできるようになる。

スキルの更新¶

スキルは相対シンボリックリンクとして置かれるので、ライブラリをアップデートすればスキルも自動で新しくなる。更新は気にしなくていい: cf. https://library-skills.io/

add them as symbolic links, so when you update the libraries, the skills are updated too