Skip to content

Last Update: 2026-06-30

Library Skills

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

プロジェクトにインストール済みのライブラリ( fastapisqlmodel など)を検出して、それぞれに対応するスキルを .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 … インストールできるスキル(ここでは fastapisqlmodel )と、その状態( 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


AIエージェント視点での効果

Claude Code に AI エージェント的にはどういう点でいいのか、人間にはわからないので教えてもらった。

Claude Code (Opus 4.8) より

エージェントの立場から見ると、 Library Skills は「このプロジェクトで実際に使うライブラリの、いまの正しい使い方」を手元に揃えてくれる仕組みになる。具体的にはこのあたりが効く。

  • カットオフ以降を補える: 私( Opus 4.8 )の知識には学習データのカットオフがあって、それより後のライブラリの変更は知らない。 SKILL.md はライブラリ本体に同梱された一次情報なので、カットオフ後の推奨パターンでも参照できる。
  • 手元のノイズが減る: 対象はプロジェクトにインストール済みのライブラリ( ここでは fastapisqlmodel )だけ。使わないライブラリの知識で .claude/skills/ が膨らまず、実際に書くコードに直結する知識だけが並ぶ。
  • バージョンに追従する: スキルは相対シンボリックリンクなので、 uvfastapi を上げればスキルも一緒に新しくなる。私が古い API シグネチャをそのまま提案してしまう事故が減る。
  • 確度が高い: SKILL.md は各ライブラリのメンテナが書いている。私が web を検索して断片を継ぎ接ぎするより確かだし、無駄な調べ物が減るぶんトークンも節約できる。
  • 自分でメンテできる: tool skill を入れておけば、スキルの状態確認・修復・更新を私自身で回せる。人間がいちいち面倒を見なくても、セットアップが保たれる。