Skill Cabinetとは？
Skill Cabinetは、コンピューターにインストールされたエージェントスキルのローカルカタログです。.agents、.claude、.codex、.cursorなどのユーザーレベルのドロワーをスキャンし、Cursorプラグインも含めて検出します。また、その他の一致する~/.* /skillsフォルダーも確認します。
このアプリケーションは、検出したスキルをブラウザーベースのインターフェースに表示します。カタログを検索したり、各スキルの内容とYAMLフロントマターを確認したり、スキルのフォルダーにある追加ファイルを開いたり、不要なスキルをディスクから削除したりできます。
Skill Cabinetは127.0.0.1にのみバインドされるため、サーバーはパブリックネットワークインターフェースではなく、ローカルマシンから利用できます。
主な機能
- 自動検出：対応しているユーザーレベルのエージェントツール用ドロワーとスキルフォルダーをスキャンします。
- フィルタリング：ドロワーでカタログを絞り込みます。
- 検索：名前、説明、パス、フロントマターに一致する項目を検索します。
- スキルの確認：スキル本文をレンダリング形式またはソース形式で表示します。
- メタデータへのアクセス：スキルに関連付けられたYAMLフロントマターを表示します。
- フォルダーの参照：スキルと同じ場所に保存された追加ファイルを読み取れます。
- スキルの削除：1つのスキル、または選択した複数のスキルをまとめて削除します。
- テーマ：Themeメニューから選択可能なスキンを利用でき、デフォルトはCarbonです。
- キーボード操作：移動、検索、選択、削除のショートカットに対応しています。
必要条件
Skill CabinetにはNode.js 20以降が必要です。起動する前に、インストールされているNode.jsのバージョンを確認してください。
node --version表示されたメジャーバージョンが20未満の場合は、Node.jsをアップグレードしてから、もう一度コマンドを実行してください。
Skill Cabinetを実行する
npmパッケージを起動する
アプリケーションを起動する最も簡単な方法はnpxを使うことです。
npx skill-cabinetこのコマンドは127.0.0.1でローカルサーバーを起動し、デフォルトでポート3781を使用して、ブラウザーでインターフェースを開きます。
GitHubリポジトリから直接実行する
npmパッケージの代わりに、リポジトリ版を実行できます。
npx github:subsy/skill-cabinetブラウザーの自動起動を防ぐ
ブラウザーのタブを置き換えたり開いたりせずにサーバーを起動する場合は、SKILL_CABINET_NO_OPENを設定します。
SKILL_CABINET_NO_OPEN=1 npx skill-cabinet起動後、準備ができたらアプリケーションに表示されたローカルアドレスを開いてください。
別のポートを選択する
デフォルトの3781以外のポートを使用するには、PORT環境変数を設定します。
PORT=4000 npx skill-cabinetこの例では、Skill Cabinetは127.0.0.1:4000で実行されます。
スキルを参照・検索する
npx skill-cabinetでSkill Cabinetを起動します。- ローカルインターフェースがブラウザーで開くまで待ちます。
- ドロワーフィルターを使って、特定の対応場所にあるスキルに絞り込みます。
- 検索を使って、スキルの名前、説明、パス、フロントマターを対象に検索します。
- 結果を選択して内容を確認します。
説明の一部、ディレクトリパス、またはYAMLメタデータに保存された値しか覚えていない場合、検索が役立ちます。
スキルを確認する
スキルを選択すると、本文をレンダリング形式またはソース形式で読めます。読みやすさを重視する場合はレンダリング表示、元のテキストを確認する必要がある場合はソース表示を使ってください。
スキルのYAMLフロントマターを確認したり、そのディレクトリに含まれる追加ファイルを読んだりすることもできます。これらの表示を組み合わせることで、変更を加える前に、スキルの内容とインストール場所を把握できます。
スキルを慎重に削除する
Skill Cabinetでは、個別のスキル、または選択した複数のスキルをまとめて削除できます。削除すると、スキルのディレクトリ全体がディスクから削除されます。
警告：元に戻すことはできません。削除する前に、選択したスキルとそのパスを十分に確認してください。
組み込みのCursorスキルやプラグインキャッシュに保存されたコピーは、関連するツールが次回更新されたときに再び現れることがあります。そのため、これらのコピーを削除しても完全には削除されない場合があります。
キーボードショートカットを使う
キーボードコマンドを使うと、大きなカタログをより速く操作できます。
jで次の項目に移動します。kで前の項目に移動します。/で検索を開始します。xで項目を選択します。dで選択したスキル、または選択済みのスキル項目を削除します。
実用的な操作手順は、/を押して検索し、jとkで結果を移動し、xで対象項目を選択して、すべてのパスを確認してから削除することです。
インターフェースのテーマを変更する
Themeメニューを開くと、利用可能なスキンを切り替えられます。デフォルトではCarbonが選択されています。テーマを変更しても、検出されたスキルやそのファイルは変更されず、インターフェースの外観だけが変わります。
Skill Cabinetをローカルで開発する
ソースコードを扱うには、リポジトリをクローンして依存関係をインストールします。
git clone git@github.com:subsy/skill-cabinet.git
cd skill-cabinet
npm install
npm run dev次に、ブラウザーでhttp://127.0.0.1:5173を開きます。
本番ビルドを実行する
次のコマンドでアプリケーションをビルドし、本番モードで起動します。
npm run build
npm startリポジトリに貢献する場合は、プロジェクトの貢献ガイドラインが記載されたCONTRIBUTING.mdを確認してください。
高度なヒント
- 削除前に確認する: パス、ソース、フロントマター、追加ファイルを確認し、意図したディレクトリを選択していることを確かめます。
- 絞り込みと検索を組み合わせる: まずドロワーを選択し、絞り込まれたカタログ内を名前、説明、パス、メタデータで検索します。
- 一括整理にはマーキングを使う:
xで複数のエントリをマークし、dを押す前に対象がすべて揃っていることを確認します。 - 現在のブラウザー状態を維持する: 起動時にインターフェースを自動で開きたくない場合は、
SKILL_CABINET_NO_OPEN=1を使用します。 - ポートの競合を避ける: ポート
3781がすでに使用中の場合は、別のPORT値を指定してアプリケーションを起動します。 - 管理対象のスキルは戻る可能性がある: Cursorの組み込みスキルやプラグインキャッシュのコピーは、後続のツール更新によって復元されることがあります。
まとめ
Skill Cabinetは、複数のツールディレクトリに分散したエージェントスキルを見つけて確認するための、ローカルに特化したインターフェースを提供します。検索可能なメタデータ、ソース表示とレンダリング表示、フォルダー検査、テーマ、キーボード操作、一括削除により、ローカルスキルの管理を簡素化します。削除は元に戻せないため、削除する前に検査機能を使って各スキルを確認してください。
Skill CabinetはMITライセンスの下で公開されています。