コンテンツにスキップ

スキルのインストールと管理

このガイドでは、GitHub からワークスペースにスキルを揃える方法を説明します。 リポジトリをソースとして追加し、そこから必要なスキルをインストールし、その後も 最新の状態に保ちます。

始める前に知っておくべき重要事項: ソースリポジトリは信頼できません。 その 名前、説明、スター数は、リポジトリの所有者が書いたものです。Control Center が 信頼する唯一の安全シグナルはウイルス対策スキャンの判定であり、ディスクやエージェントの プロンプトに何かが届く前に、すべてのインストールがこの判定を通過します。理由を 知りたい場合は エージェントモデルのスキルのセクションを お読みください。このページは実際の操作に徹します。

スキルは 設定 → ワークスペース → スキル (/workspaces/<id>/settings/workspace/skills)にあります。スキルはワークスペース 単位です。ここでインストールしたスキルは、このワークスペースにのみ属します。ページには 2 つのタブがあります: インストール済み(ローカルのスキル。新しいスキル エディターを含みます)と ソース(GitHub のカタログ)です。どちらの書き込みも 同じスキャンゲートを通過します。

  1. 設定 → ワークスペース → スキルを開き、ソースタブに切り替えます。
  2. リポジトリを追加を押します。
  3. GitHub リポジトリの URL を貼り付けます(例: https://github.com/anthropics/skills)。そして確定します。

サーバーは、そのリポジトリが存在し、資格情報で参照できることを確認してから、左側の レールに追加します。間にキュレーションされたストアはありません: どの GitHub リポジトリでも使えるということは、評判を判断するのはあなた自身だということでもあります — スター数は証拠にはなりますが、保証には決してなりません。

リポジトリのスキルとは、SKILL.md を含むディレクトリのことです(最大 3 階層まで。 加えて Claude のプラグインマーケットプレイス形式 plugins/<plugin>/skills/<skill> も対象となり、依存関係とベンダーのツリーは スキップされます)。後でグリッドにこのリポジトリにはスキルがないと表示されたら、 それはそのとおりの意味です: リポジトリ内にスキルの規約に一致するディレクトリが ないということです。

レールでリポジトリを選択すると、そのスキルが右側にグリッドで表示され、上の フィルターフィールドで名前、説明、slug からカタログを絞り込めます。カードを クリックすると詳細ビューが開きます。詳細ビューには 3 つの情報があります:

  • README — markdown としてレンダリングされます。スキルディレクトリの README.md、または README がない場合は SKILL.md の本文です。
  • スキャンプレビュー — 判定(pass、warn、quarantine)、スキルの内容が 宣言するケイパビリティ(シェルを実行、ファイルを書き込む、ネットワークに アクセス…)、そしてスキャナーが記録したすべての検出結果です。
  • ファイル数 — インストールでは、その SKILL.md だけでなくスキルの ディレクトリ全体が書き込まれます。

プレビューは、インストールが書き込むのとまったく同じバイト列をスキャンするため、 目にしている判定がそのままインストール時の判定になります。あなたの知らないうちに 判定し直されることはありません。

  1. スキルの詳細ビューを開きます。
  2. スキャン判定を読みます。warn または pass の判定なら、インストールを 押します。
  3. quarantine の判定の場合、リスクを理解したうえでインストールするに チェックを入れるまでインストールは無効のままです。この上書きは記録されます。 暗黙に認められることはありません。

インストールするとスキルのディレクトリがワークスペースに書き込まれ、 skills-lock.json にピン(ソースリポジトリ、パス、取得元のコミット、コンテンツ ハッシュ)が記録され、そのスキルがワークスペースのエージェントから利用できるように なります。使用中の名前と表示されたカードは、別のスキルがすでにその名前を ローカルで使用していることを意味します — 先にそちらをアンインストールしてください。

インストール済みスキルのカードにはバッジが付きます: インストール済み、または ピンしたコミットよりリポジトリが先に進んでいる場合は 更新あり です。詳細ビューを 開いて 更新 を押すと、新しいコミットで再取得します。更新はインストールと同じ スキャンゲートを通過します — 新しいバージョンが隔離されるスキルは拒否され、手元の バージョンはそのまま残ります。古いバージョンのハッシュは、ロック内のロールバック 参照として保持されます。

スキルをアンインストールし、リポジトリを削除する

「スキルをアンインストールし、リポジトリを削除する」というセクション

アンインストール(インストール済みスキルの詳細ビュー、または インストール済み タブでの削除)は、スキルのディレクトリとロックのピンをまとめて削除します — アンインストールされたスキルは何も残しません。

レールからのリポジトリの削除はカタログだけを削除します: そこからインストールした スキルはインストールされたままで、引き続き更新されます。ピンはソースエントリへの 参照ではなく、リポジトリを名前で記録しているためです。もう一度閲覧したい場合は、 リポジトリを追加し直してください。

スキルは独自の名前空間で呼び出されるため、組み込みのスラッシュコマンド (/plan、/goal、/loop、/compact)と衝突しません:

  • /skill:<name> — このワークスペースにインストールされたスキル、または エージェントに添付されたスキル
  • /skill:<repo>:<name> — このスペースにチェックアウトされたリポジトリが 提供するスキル

名前空間ができる前に書かれたメッセージのために、組み込みでない裸の名前も解決されます。 plan という名前のスキルに届くのは /skill:plan であり、/plan は常に組み込みです。

チェックアウトされたリポジトリは、.agents/skills/、.agent/skills/、 .claude/skills/、.opencode/skills/ または skills/ に、独自のスキルを 同梱できます。それらはこのページからはインストールされません。エージェントが 保持するのは、現在作業しているリポジトリのスキルだけであり、リポジトリを移動すると 入れ替わります。コンポーザーはそのようにはスコープされません: /skill:<repo>:<name> はスペース内のどのリポジトリにも届きます。

リポジトリのスキルは、そのフロントマターがプロンプトに届く前に、同じフェイル クローズドなスキャン(pass / warn / quarantine)を通過します。warn は 許可され、quarantine は差し止められます。この経路に運用者による上書きは ありません。

リポジトリ単位のスキル と スラッシュコマンドを参照してください。