---
title: "npx skillsを使ってAIエージェントのスキルフラグメンテーション（機能の断片化）を解消する方法"
description: "Claude CodeやKimiなどの複数のAIエージェントを使用中ですか？ npx skills CLIを利用して、重複を解消し1つのフォルダでスキルを一元管理する方法を解説。"
canonical_url: "https://techvoyage.dev/ja/article/centralised-the-skills-for-agents"
last_updated: "2026-06-14T11:05:29.714Z"
---

パソコン上でHermes、Claude Code、Codex、Antigravity、Kimiなど、複数のAIエージェントやCLIツールを動かしているなら、ある非常にイライラする問題に直面したことがあるでしょう。それは**スキルの断片化（フラグメンテーション）**です。各エージェントやCLIがそれぞれ独自の`skills`フォルダを個別に保持しているため、同じスキルの重複インストール、バージョンの不一致、そして管理上のオーバーヘッドが発生してしまいます。

私たちはAIエージェントを活用する中で、頻繁に以下のような課題に直面していました。

- **重複インストール**: あるエージェント用に新しいスキルをインストールした際、別のエージェントでも全く同じスキルを何度も再インストールしなければならない。
- **バージョンの不一致（Version Drift）**: 1つのエージェント用にスキルをカスタマイズしたり修正したりしたのに、他のエージェントでの更新を忘れてしまい、結果としてエージェントごとに挙動が異なってしまう。
- **非効率なスキル管理**: システム全体に散らばる各エージェントの`skills`フォルダを1つずつ確認しないと、どのスキルが実際にインストールされているか把握できない。

Vercelがオープンソースで提供している`npx skills` CLIは、1つの**一元管理された（セントライズされた）skillsフォルダ**を作成し、それをすべてのエージェントで共有することで、この課題を見事に解決します。詳細は[`npx skills`のGitHubリポジトリ](https://github.com/vercel-labs/skills)をご確認ください。

## スキルの一元管理化

コンセプトは非常にシンプルです。すべての子エージェントの`skills`フォルダを**同じ物理フォルダ**に紐づければ、断片化の問題は完全に解消されます。

`npx skills` CLIを使ってスキルをインストールすると、そのスキルはパソコン上の共有一元化フォルダ（`~/.agents/skills`）にダウンロードされます。その後、CLIが各エージェントの`skills`フォルダから、その一元化フォルダに向けた**シンボリックリンク（Symlink、ファイル実体への参照）**を自動で作成します。

例えば、Claude Codeが`~/.claude/skills/`内でスキルを探す際、自動的かつ透過的に`~/.agents/skills`へとリダイレクトされます。一元化フォルダ内のスキルに少し手を加えるだけで、すべてのエージェントにその変更が即座に反映されます。手動コピーや同期スクリプトは不要で、ディスク容量も一切無駄になりません。

## `npx skills`のインストールとスキルの追加

以下のコマンドを実行して開始し、最初のスキルを追加してみましょう。

```bash
npx skills add https://github.com/coleam00/excalidraw-diagram-skill --skill excalidraw-diagram
```

![npx skills add コマンドを使用して GitHub からスキルをインストールする](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/npx-skills-add-command.webp)

CLIは、この設定を特定のプロジェクト用にするか、それともグローバルにするかを尋ねてきます。サポートされているすべての子エージェントからアクセスできるように、通常は**global**を選択することをお勧めします。
![npx skills CLI でグローバルインストールオプションを選択する](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/npx-skills-install-global-prompt.webp)

次に、**唯一の真実のソース（Single Source of Truth）**を確保するために、必ず`Symlink`を選択してください。
![スキルの同期にシンボリックリンク（Symlink）方式を選択する](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/npx-skills-symlink-option.webp)![CLI でのスキルインストールおよびシンボリックリンク作成の完了確認](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/npx-skills-installation-completed.webp)

設定が完了したら、スキルが一元化フォルダ（`~/.agents/skills`）に正しくインストールされているかを確認できます。
![中央ディレクトリにインストールされたスキルを確認・検証する](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/npx-skills-directory-verification.webp)

Kimi CLI（またはお好みのエージェント）を起動すれば、`excalidraw-diagram`スキルがすぐに利用可能になっています！
![Kimi CLI が中央スキルのロードを完了し、使用可能な状態を示す画面](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/kimi-cli-skills-integration.webp)

## スキルをゼロから自作する

独自のカスタムスキルを作成したい場合は、Anthropicの`skill-creator`ツールを利用できます。以下のようにインストールします。

```bash
npx skills add https://github.com/anthropics/skills --skill skill-creator
```

インストール後、Kimiやその他のエージェントに以下のプロンプトを入力します。

```text
Use the skill-creator to help me build a skill for creating a product landing page
```

エージェントが自動的に`skill-creator`を認識し、ステップバイステップでスキルの作成手順を案内してくれます。
![Kimi CLI で実行されるインタラクティブな skill-creator ウィザード](https://inimages.techvoyage.dev/articles/Centralised%20the%20skills%20for%20agents/kimi-cli-skill-creator-setup.webp)

## その他便利な `npx skills` コマンド

知っておくと便利なその他のコマンドは以下の通りです。

- `npx skills ls -g`: グローバルにインストールされているすべてのスキル一覧を表示
- `npx skills update`: 1つのコマンドですべてのスキルを最新状態に一括アップデート
- `npx skills remove`: インタラクティブにスキルをアンインストール/削除

その他のコマンドや仕様については、[`npx skills` のGitHubリポジトリ](https://github.com/vercel-labs/skills)を参照してください。

## さらに一歩進んだ活用法

すべてのスキルが1つの場所（`~/.agents/skills`）に集約されたため、このフォルダ自体をGitリポジトリとして初期化し、GitHubやGitLabにプッシュして管理できます。

```bash
cd ~/.agents/skills
git init
git add .
git commit -m "Initial skills folder"
git remote add origin https://github.com/Tech-Voyage-Dev/skills
git push -u origin main
```

これにより、スキルの全変更履歴を管理できるようになり、万が一アップデートで不具合が生じても簡単に元の状態にロールバックできます。また、ノートPCとデスクトップPCなど、複数のパソコン間で`git pull`を実行するだけで、スキルの状態をシームレスに同期することも可能です。

## 注意すべき点（セキュリティとリスク）

- **互換性の違い**: エージェントのプラットフォームによっては、カスタムフックや特定の許可ツールなど、一部の機能にまだ対応していない場合があります。あるエージェントでは正常に動くスキルでも、別のものでは制限がかかることがあります。
- **ソースの信頼性**: 信頼できるソースからのスキルのみをインストールするようにしてください。
- **実行前のコードレビュー**: カスタムスキルやサードパーティ製スキルを使用する場合は、エージェントに実行させる前に、ファイル（特に`scripts/`フォルダ内）の中身を必ず目視で確認してください。
- **最小特権の原則**: スキルに対して、動作に必要以上の過剰なツール権限やアクセス権を与えないようにしましょう。
- **シークレット of ハードコード厳禁**: APIキーやパスワードなどの機密情報は、絶対にスキルファイル内に直接書き込まないでください。

`npx skills`を使って「唯一の真実のソース」を構築することで、私たちの開発チームは二度手間やバージョン同期のストレスから完全に解放されました。非常にお勧めの設定ですので、ぜひ試してみてください。スキルの成長に伴い、AIエージェントの可能性も大きく広がります！