Agent Skills を skills.json で管理するためのツール skm を作成した

Agent Skills を管理するためのツール @stefafafan/skm を作成しました。

課題感

Agent Skills は基本的にはプロンプト集で、特定のディレクトリに保存するものですが、今後あらゆるサービスや人が Agent Skills を無尽蔵に公開していくと色々と管理について課題が出るんじゃないかともやもや思っていました。

.agents/skills とか .claude/skills にファイルをコピーして入れたりしていて、どのファイルがいつどこから入れたものかわからない
- 更新があるかどうかも不明
Skills の仕組みとしては、 name と description の自然文をエージェントが読んで、発火すべきかどうかを判断しているそうだけど、命名規則とかがふわふわしているのが気になる

npm におけるパッケージ管理と同じようなイメージで、 package.json や package-lock.json を真似して、 skills.json と skills.lock.json で管理するというふうにしてみました。

skm add stefafafan/skills みたいにスキルを追加できる
- スキルの実態はいままで通り .agents/skills とかに保存されるが、どのGitHub Repositoryから入れたものかとかが skills.json に記録されている
skm rename old-name new-name みたいにスキルの名前を変更できる
- 自分の好きな命名規則にスキルを揃えていける
- これは単にスキルのディレクトリ名と name メタデータを書き換えているのみ。もしスキル間で依存関係があるとしたら困るが..

アイデアを思いついた後怒涛のAgentic Codingをしたことで一気に完成したけど、あまりコードの中身をわからないまま進めていてこれでいいんだろうかとなった
- あとから、リファクタリングを頼んだり、エッジケースの修正などを依頼した
npm パッケージ今まで公開したことなかったので、公開のプロセスを体感できてよかった
なぜか公開して即、定期的にダウンロードが来ているけどどういうことだろう..となった https://www.npmjs.com/package/@stefafafan/skm?activeTab=versions
それらしい専用サイトも公開した https://getskm.dev/
- Codex と frontend-skill を使ったらこういう感じになった
- Cloudflare Workers と Astro で構成されています
あとから気づいたけどやっぱり似たようなライブラリはもうあった
- https://github.com/pi0/skillman: vercel-labs/skills のラッパーで、 skills.json で管理も同じアイデア。私がやってるような、コミットハッシュを記録したり rename コマンドを用意したりとかはしてなさそう。
- https://github.com/reorx/skm: 名前が被ってしまった、こちらはグローバルなSkillの管理を意図しているもの。skm とは違ってPython製。