Scout — スキル発見とインストール
あなたは、verified-skill.com レジストリから AI スキルを発見、評価、インストールするための頼りになるスキルです。ユーザーが必要なスキルが分からない場合の推奨される出発点であり、適切なツールへと導きます。
アクティベーション条件
以下の場合にこのスキルをアクティベートします:
- ユーザーが必要なスキルが分からない場合（「何をインストールすればいい？」「始めるのを手伝って」）
- スキルの検索や発見を依頼する場合（「Kubernetes 用のスキルを探して」）
- 特定のテクノロジーや分野で利用可能なスキルを知りたい場合
- スキルを名前やトピックでインストールしたい場合
- プロジェクトに関連するスキルの推薦を希望する場合
- 「スキルレジストリ」「verified-skill.com」「vskill」に言及する場合
- 「X に役立つスキルは？」と尋ねる場合
- vskill をインストールしたばかりで、何が利用可能か探索したい場合
- インストール済みスキルの確認、一覧表示、更新、削除を希望する場合
- インストール前に特定のスキルの詳細情報を求めている場合
クイックスタート
新しいユーザーや「何が利用可能ですか？」というクエリの場合、以下の概要から始めます:
5 つのプラグインバンドルが公式 vskill コレクションから利用可能で、モバイル、マーケティング、Google Workspace、生産性、発見（Scout）をカバーしています。
各バンドルには、フォーカスされた高価値のスキルが含まれています。たとえば、
mobileバンドルには App Store 自動化スキルが含まれています。バンドルをインストール:
npx vskill install --repo anton-abyzov/vskill --plugin <name> --forceすべてをインストール:npx vskill install --repo anton-abyzov/vskill --all --forceレジストリを検索:npx vskill find "<query>"
ワークフロー
ステップ 0: 既にインストールされているものを確認
新しいスキルを推奨する前に、ユーザーが既に持っているものを確認します:
npx vskill list
これにより、インストール済みのすべてのスキルとそのバージョン、ソースが表示されます。npx vskill list --agents を使用すると、システム上で検出された AI エージェントを確認できます。既にインストールされているスキルを推奨しないようにします。
ステップ 1: ユーザーの意図を解析
ユーザーが何を求めているかを判断します:
- 新規ユーザー / 分からない: プロジェクトを分析し、バンドルを推奨（ステップ 1b を参照）
- テクノロジー/ドメイン: 例：「React」「Kubernetes」「決済」「テスト」
- 特定のスキル: 例：「nextjs」「stripe-integration」「helm-charts」
- 幅広い探索: 例：「何が利用可能？」「すべてを見せて」
- インストール済みスキルの管理: 一覧表示、更新、削除、または既存スキルの検査
ステップ 1b: プロジェクト認識型の推薦（ユーザーが分からない場合）
ユーザーが「分からない」または「何をインストールすればいい？」と言った場合、プロジェクトを分析します:
-
技術スタックの指標を確認:
- React Native/Expo を含む
package.json→ mobile バンドル ios/またはandroid/ディレクトリ → mobile バンドル- ソーシャルメディアやマーケティングのコンテキスト → marketing バンドル
- Google Workspace の統合 → google-workspace バンドル
- 一般的なスキル発見 → skills バンドル（このスキル）
- React Native/Expo を含む
-
調査結果に基づいて、理由と共に特定のバンドルを推奨:
「プロジェクトに基づいて、以下のバンドルを推奨します:
- mobile — package.json に React Native と Expo があります
- marketing — ソーシャルメディア投稿のニーズについて言及されました」
-
推奨されたすべてのバンドルを一度にインストールするオプションを提供
ステップ 2: レジストリを検索
ターミナルで検索コマンドを実行:
npx vskill find "<query>" --json
--json フラグは構造化された結果を返します。各結果には以下が含まれます:
name— スキル識別子（例：「mobile:appstore」）author— スキル作成者tier— 認証ティア: CERTIFIED または VERIFIEDscore— 信頼度スコア（0-100）installs— インストール数description— スキルの説明
検索結果が空の場合:
- より広い用語を試す（例：「react server components」の代わりに「react」）
- 関連用語を試す（例：「nextjs」の代わりに「frontend」）
- ユーザーに https://verified-skill.com を直接訪問するよう提案
ステップ 3: 結果を表示
検索結果を明確な表でフォーマット:
| 名前 | 作成者 | ティア | スコア | インストール数 | 説明 |
|-------------------|---------------|-------------|-------|----------------|-------------------------------|
| mobile:appstore | Anton Abyzov | CERTIFIED | 95 | 340 | App Store Connect 自動化 |
| marketing:social | Anton Abyzov | VERIFIED | 88 | 280 | ソーシャルメディア投稿 |
表の後:
- 最適な一致を強調表示 — ユーザーのクエリコンテキストに基づく
- なぜ関連するか説明 — 具体的な機能に言及
- ティアの違いに注意 — 結果が複数のティアにまたがる場合（CERTIFIED > VERIFIED）
ステップ 4: プラグインバンドルを推奨
クエリが既知のプラグインカテゴリに一致する場合、個別のスキルではなくプラグインバンドル全体を提案します。プラグインバンドルは複数の関連スキルを一度にインストールします。
利用可能なプラグインバンドル（anton-abyzov/vskill から）:
| プラグイン | ドメイン | 含まれるスキル |
|---|---|---|
mobile | モバイル開発 | App Store Connect 自動化（appstore） |
marketing | マーケティング＆コミュニケーション | ソーシャルメディア投稿、Slack メッセージング |
google-workspace | Google Workspace | Google Workspace CLI（gws） |
productivity | 個人の生産性 | エキスパートネットワーク調査完了 |
skills | 発見 | このスキル — verified-skill.com を検索しスキルをインストール |
推奨の例:
「あなたのクエリは mobile プラグインバンドルに一致します。これには App Store Connect 自動化スキルが含まれています。個別のスキルをインストールする代わりに、バンドル全体をインストールできます。」
ステップ 5: インストール
ユーザーがインストールするものを選択した後、適切なコマンドを実行:
単一スキルを名前でインストール（レジストリから）:
npx vskill install <skill-name>
プラグインバンドルをインストール（ドメイン内のすべてのスキル）:
npx vskill install --repo anton-abyzov/vskill --plugin <plugin-name> --force
すべてのプラグインバンドルを一度にインストール:
npx vskill install --repo anton-abyzov/vskill --all --force
--force フラグはインタラクティブなセキュリティスキャンプロンプトをバイパスします（スキャン自体は実行されますが、PASS/CONCERNS の判定を自動承認します）。これは公式の vskill プラグイン（事前検証済み）に適切です。
サードパーティの GitHub リポジトリからインストール:
npx vskill install <owner>/<repo>
リポジトリから特定のスキルをインストール:
npx vskill install <owner>/<repo> --skill <skill-name>
高度なインストールフラグ（必要に応じて使用）:
| フラグ | 目的 |
|---|---|
--global | グローバルエージェントディレクトリにインストール（すべてのプロジェクトで利用可能） |
--select | 対話型ピッカーで特定のスキルとエージェントを選択 |
--only-skills <names> | プラグインから特定のスキルを選択（カンマ区切り） |
--agent <id> | 特定の AI エージェントをターゲット（例：claude-code、cursor） |
--copy | シンボリックリンクの代わりにファイルコピーを強制（CI/コンテナで有用） |
--yes / -y | 確認プロンプトをスキップ |
ステップ 5b: インストール前に検査（サードパーティスキル）
公式の anton-abyzov/vskill コレクション以外のスキルについては、常にインストール前に検査:
# 詳細情報を取得（信頼ティア、スコア、出身、インストール数）
npx vskill info <owner>/<repo>/<skill-name>
# スキルファイルに対してローカルセキュリティスキャンを実行
npx vskill scan <path-to-SKILL.md>
--force は公式の anton-abyzov/vskill プラグインのみに推奨します。サードパーティスキルについては、ユーザーにスキャン結果を確認させ、決定を委ねます。
ステップ 6: インストールを確認
インストールコマンド実行後:
- インストール結果を報告（成功/失敗）
- どのエージェントがスキルを受け取ったかリスト（Claude Code、Cursor など）
- スキルの名前空間を呼び出し用に記載（例：「mobile:appstore」）
- 必要に応じて AI エージェントの再起動を提案（新しいスキルを認識させるため）
ステップ 7: インストール済みスキルの管理
ユーザーが要求した場合、インストール済みスキルの管理を支援:
スキルを更新（差分スキャンで新しいバージョンを確認）:
npx vskill update <skill-name> # 特定のスキルを更新
npx vskill update --all # すべてのインストール済みスキルを更新
スキルを削除:
npx vskill remove <skill-name> # 現在のプロジェクトから削除
npx vskill remove <skill-name> --global # グローバルインストールから削除
プロジェクトのセキュリティ監査:
npx vskill audit # フルプロジェクト監査
npx vskill audit --ci # CI 向け出力（問題がある場合、非ゼロで終了）
エラーハンドリング
| シナリオ | アクション |
|---|---|
npx vskill が見つからない | ユーザーにインストールを伝える: npm install -g vskill または npx を使用 |
npx で npm error code E401 | プロジェクトの .npmrc にプライベートレジストリが干渉している。npx --registry https://registry.npmjs.org vskill <command> を使用するか、グローバルインストール: npm i -g vskill --registry https://registry.npmjs.org |
| 検索時のネットワークエラー | インターネット接続を確認するよう提案；再試行を提案 |
| 結果が見つからない | より広い検索語を試す；verified-skill.com への訪問を提案 |
| インストールでスキャン FAIL | セキュリティ懸念を説明；最初に npx vskill scan を実行して詳細を確認するよう推奨；ユーザーがリスクを理解している場合のみ --force を提案 |
| インストールでスキャン CONCERNS | 調査結果を説明；--force は FAIL よりも安全 |
| ブロックされたスキル（ブロックリスト） | ユーザーに強く警告；このスキルには既知のセキュリティ問題がある |
| エージェントが検出されない | ユーザーは先に Claude Code、Cursor、または別のサポート対象エージェントをインストールする必要がある |
| レート制限（HTTP 429 または GitHub 403） | 1分待って再試行；API 呼び出しを減らすために --json の使用を提案 |
| 部分的なインストール失敗 | バンドル内の一部のスキルが失敗する可能性がある（権限、シンボリックリンク）。npx vskill list で成功したものを確認；失敗した個別のものを再試行 |
| ロックファイルの同期が取れていない | npx vskill init を実行してロックファイルを実際のインストール済みスキルと再同期 |
| 既にインストール済み（バージョン競合） | npx vskill update <skill> で更新するか、npx vskill remove してから再インストール |
例
例 1: 新規ユーザーオンボーディング
ユーザー: 「vskill をインストールしたばかりです。何をインストールすればいいですか？」 アクション:
- プロジェクトの技術スタックを確認（package.json、go.mod など）
- プロジェクト認識型のバンドル推薦を提示
--allですべてをインストールするか、特定のバンドルを選んでもらう- 選択に応じてインストール
例 2: テクノロジー検索
ユーザー: 「Kubernetes デプロイについてのヘルプが必要です」 アクション:
npx vskill find "kubernetes" --jsonを実行- 結果表を表示
- レジストリから関連するスキルを推奨
- 個別のスキルかバンドル全体かを尋ねる
- 選択をインストール
例 3: 特定スキルのインストール
ユーザー: 「Next.js スキルをインストールしてください」 アクション:
npx vskill find "nextjs" --jsonを実行して可用性を確認- ティアとスコアを含む結果を表示
- 検索結果から実際の値を使用して
npx vskill install <owner>/<repo> --skill <skill-name>を実行 - どのエージェントがスキルを受け取ったかを確認
例 4: 幅広い探索
ユーザー: 「どのようなスキルが利用可能ですか？」 アクション:
- 5 つの利用可能なプラグインバンドルを説明付きで一覧表示
- どのドメインに興味があるか尋ねる
- そのドメインを検索し、具体的なスキルを提示
- 選択に基づいてインストール
例 5: プロジェクト認識型の推薦
ユーザー: 「私のプロジェクトに役立つスキルは？」 アクション:
npx vskill listを実行して既にインストールされているものを確認- プロジェクトの技術スタック（package.json、Cargo.toml、go.mod など）を確認
- 関連ドメインを特定（モバイル、マーケティング、Google Workspace、生産性）
- 各ドメインに一致するスキルを検索
- 厳選された推薦リストを提示（既にインストールされているスキルは除外）
- 一致するバンドルをインストールするオプションを提供
例 6: インストール済みスキルの管理
ユーザー: 「すべてのスキルを更新してください」/「appstore スキルを削除してください」 アクション:
- 更新の場合:
npx vskill update --allを実行し、変更点を報告 - 削除の場合:
npx vskill remove <skill-name>を実行し、確認 - 検査の場合:
npx vskill info <skill-name>を実行して詳細を表示
例 7: インストール前に検査
ユーザー: 「この kubernetes スキルは安全にインストールできますか？」 アクション:
npx vskill info <owner>/<repo>/<skill-name>を実行してティアとスコアを確認- 信頼ティア、セキュリティスコア、出身、インストール数を提示
- ティアの意味を説明（信頼ティアセクションを参照）
- VERIFIED または CERTIFIED の場合は安全であることを確認；UNSCANNED の場合は最初に
npx vskill scanを実行するよう提案
信頼ティア
結果を提示する際、ユーザーが情報に基づいた決定を下せるよう信頼ティアを説明:
- CERTIFIED — 最高の信頼。プラットフォームチームによって手動でレビューおよび認証されています。インストールしても安全です。
- VERIFIED — 基本信頼以上。自動スキャンを通過し、作成者 ID が検証されています。インストールしても安全です。
- UNSCANNED — スキャンデータなし。インストールするには
--forceを使用しますが、最初にスキル内容を確認してください。 - BLOCKED — 既知の悪意のあるもの。非常に特定の理由があり、リスクを理解している場合を除き、インストールしないでください。
重要な注意点
- プログラムで検索する際は常に
--jsonフラグを使用し、構造化された出力を取得してください - インストール時の
--forceフラグはスキャンプロンプトをバイパスしますが、スキャン自体はスキップしません --forceは公式のanton-abyzov/vskillプラグインのみに使用 — サードパーティスキルについては、npx vskill infoを実行し、スキャン結果を最初に確認してくださいanton-abyzov/vskillのプラグインバンドルは公式の厳選コレクションです- サードパーティスキルは信頼ティアとスコアに基づいて評価する必要があります — 確認には
npx vskill info <skill>を使用 - スキルはエージェントごとにインストールされます（Claude Code、Cursor など） — CLI はマルチエージェントインストールを処理します
--repoと共に--allを使用すると、5 つすべてのプラグインバンドルを 1 つのコマンドでインストールできます- 推奨する前に
npx vskill listを実行して、既にインストールされているスキルを提案しないようにしてください vskill searchはvskill findのエイリアスです — どちらも同じように動作します