pnpm v12.11: パッケージに同梱された SKILL.md を、承認したものだけ .claude/skills にリンクする
pnpm v12.11 から、依存パッケージが同梱しているエージェント用スキル(SKILL.md)をプロジェクトのスキルフォルダにリンクできる。リンクされるのは pnpm approve で承認したものだけで、承認結果は pnpm-workspace.yaml の permissions に残る。
どんな時に使う?
- ライブラリ作者が「このライブラリの正しい使い方」をスキルとして配っている
- そのスキルを手でコピーせず、依存のバージョンと一緒に管理したい
手順
- pnpm を v12.11 以上にする
- スキルを同梱したパッケージを入れると、承認待ちになる
pnpm approveで、リンクしてよいスキルを選ぶ。結果は pnpm-workspace.yaml の permissions に保存される- 承認したスキルが
.claude/skills(ほかに.agents/skills、.cursor/skills)にリンクされる
注意点
- 一度承認すると、そのパッケージの新しいバージョンにも承認が引き継がれる。スキルはエージェントへの指示そのものなので、更新時の中身の変化に気をつける(承認の考え方はビルドスクリプトと同じ: pnpm の「ビルドスクリプトを無視しました」は全部許可せず、Claude に1件ずつ仕分けさせる)
- global インストール、
pnpm dlx、pnpm deployではリンクされない - 公式ドキュメントのページは今回見つけられなかった(pnpm.io/docs/next/skills は 404)。仕様は投稿の説明によるので、使う前にリリースノートで確かめる