antfu/skills-npm

何を解決するか

"エージェントスキル"（AIコーディングエージェント用の指示やツール）の配布および管理に関連する摩擦を解消します。Gitリポジトリから手動でスキルをクローンするという方法は、バージョンの不一致やチームでのセットアップのオーバーヘッド、手動でのメンテナンスを引き起こしがちですが、このツールではスキルをnpmパッケージ内にバンドルして直接配布できるようになります。

仕組み

skills-npm は、プロジェクトの node_modules または package.json をスキャンして、インストールされたnpmパッケージによって提供されるスキルを検出するCLIツールです。その後、検出されたAIコーディングエージェント（例：CursorやWindsurf）の設定ディレクトリにそのパッケージへのシンボリックリンクを作成します。package.json の prepare スクリプトに統合することで、依存関係がインストールされるたびにスキルが自動的に再同期されるようになります。

対象ユーザー

• 開発者：AIコーディングエージェントを使用しており、npm経由でエージェントスキルを簡単にインストール・更新したい方。
• パッケージ作成者：自作ツールに組み込みのスキルを提供し、ユーザーのAIエージェントが自らのソフトウェアとより効果的に連携できるようにしたい方。

特徴

• 自動検出：npmパッケージにバンドルされたエージェントスキルを検出し、自動的にシンボリックリンクを張ります。
• エージェントの自動検出：設定ディレクトリやCLIのパスをチェックすることで、システム上にインストールされているコーディングエージェントを識別します。
• シームレスな統合：npmの prepare フックを使用して、依存関係の更新とスキルの同期を維持します。
• 柔軟な設定：include/excludeフィルタ、パッケージ用のワイルドカードパターン、モノレポの再帰的スキャンをサポートします。