find-skills

Find Skills - スキルマーケットプレイス

このスキルを使うと、エージェント環境に新しい機能を探してインストールできます。エージェント用スキルの「パッケージマネージャー」として機能します。

このスキルを使うとき

ユーザーが次のような場合に、このスキルを使います。

• 「X はどうすればできますか？」「X のスキルを探して」「どんなスキルがありますか？」と尋ねる
• 名前または検索結果からスキルをインストールしたい（「install skill web-search」など）
• 専門的なツールやワークフローで機能を拡張したい
• スキルとして提供されている可能性のある特定の機能を求めている
• サンドボックスや安全な実行に関心がある（「bash コマンドを安全に実行したい」など）
• 「sandbox」「automation」「testing」など、具体的な機能に言及している

主なツール

1. 検索：Python スクリプト scripts/request.py の POPRequest クラス
   • Alibaba Cloud スキルマーケットプレイスに対して認証済みの API 呼び出しを実行します
   • パラメーター：UserQuery（検索語）、TopK（検索結果の件数）
   • 戻り値：名前、説明、リポジトリ情報などのスキルの詳細を含む JSON レスポンス
2. インストール：npx skills add <repo> -s <skill_name>
   • 制限：実行前に必ずユーザーの確認を得てください。
   • -s, --skill <skills...> を使って、リポジトリからインストールするスキルを指定します
   • 複数のリポジトリ形式に対応しています。
     • GitHub の省略形式：npx skills add owner/repo -s skill_name
     • GitHub の完全な URL：npx skills add https://github.com/owner/repo -s skill_name
     • スキルへの直接パス：npx skills add https://github.com/owner/repo/tree/main/skills/skill_name
     • GitLab の URL：npx skills add https://gitlab.com/org/repo -s skill_name
     • Git の URL：npx skills add [email protected]:owner/repo.git -s skill_name
     • ローカルパス：npx skills add ./my-local-skills -s skill_name
   • -s '*' を使うと、リポジトリ内のすべてのスキルをインストールできます

ワークフロー

ステップ 1：ニーズを把握して検索する

ユーザーが何かについて支援を求めたら、次の点を確認します。

1. 分野またはタスク（例：コードの安全な実行、自動化、テスト）
2. スキルが存在する可能性が高い、一般的なニーズかどうか
3. よくあるサンドボックスや安全な実行のニーズに当てはまるかどうか

ステップ 2：Python API でスキルを検索する

検索では Python のリクエストモジュールを使って、スキルマーケットプレイスに問い合わせます。

1. scripts/request.py から POPRequest クラスをインポートします
2. SearchPublicMarketSkill アクションを指定してリクエストを作成します
3. クエリパラメーターを設定します：UserQuery（検索語）と TopK（最大結果数）
4. リクエストを実行して JSON レスポンスを解析します
5. スキル情報を抽出します：名前、所有者、リポジトリ、説明

ユーザーの自然言語での意図を、簡潔な検索キーワードに変換します（元の言語は維持します）。

from scripts.request import POPRequest
import json

# Create request
request = POPRequest(
    http_method='GET',
    canonical_uri='/',
    x_acs_action='SearchPublicMarketSkill',
    host='wuyingai.cn-shanghai.aliyuncs.com',
    base_url='wuyingai.cn-shanghai.aliyuncs.com',
    x_acs_version='2026-01-08',
    signature_version='1.0'
)

# Search for skills
request.set_query_params({
    'UserQuery': 'sandbox',  # User's search query
    'TopK': '10'
})

# Execute and parse
response = request.call()
results = json.loads(response)

検索例：

• 「我需要一个沙箱」 -> UserQuery: "sandbox"
• 「如何处理 PDF？」 -> UserQuery: "pdf"
• 「帮我找个代码审查的插件」 -> UserQuery: "code review"
• 「サンドボックスが必要です」 -> UserQuery: "sandbox"
• 「PDF の扱い方は？」 -> UserQuery: "pdf"
• 「コードレビューを手伝ってもらえますか？」 -> UserQuery: "code review"

ステップ 3：ユーザーに選択肢を提示する

関連するスキルが見つかったら、次の情報を添えてユーザーに提示します。

1. skill_name：スキルの識別子
2. skill_id：スキルのハッシュコード
3. skill_repo：GitHub リポジトリの所有者／組織
4. description：スキルの簡単な説明
5. source_url：リポジトリ内のスキルへの直接パス（インストールに使用）

検索結果の SourceUrl（リポジトリ URL）と SkillName を使って、インストールコマンドを作成します。

npx skills add <source_url> -s <skill_name>

回答例：

I found a skill that might help! The "vercel-react-best-practices" skill provides
React and Next.js performance optimization guidelines from Vercel Engineering.

To install it:
npx skills add https://github.com/vercel-labs/agent-skills -s vercel-react-best-practices

Learn more: https://pre-agentbay.console.aliyun.com/agentbay-skills/skill-detail?skillId=hw8edas7skphamvk

ステップ 4：インストールを提案する

ユーザーが「はい」「インストール」などの確認をした後に限り、スキルをインストールします。

npx skills add <source_url> -s <skill_name>

一般的なスキルカテゴリ

検索する際は、次のような一般的なカテゴリを検討してください。

カテゴリ	検索クエリの例
Web 開発	react, nextjs, typescript, css, tailwind
テスト	testing, jest, playwright, e2e
DevOps	deploy, docker, kubernetes, ci-cd
ドキュメント	docs, readme, changelog, api-docs
コード品質	review, lint, refactor, best-practices
デザイン	ui, ux, design-system, accessibility
生産性	workflow, automation, git
サンドボックス	agentbay-aio-skills

効果的に検索するためのヒント

1. 具体的なキーワードを使う：「react testing」は「testing」だけより効果的です
2. 別の用語も試す：「deploy」で見つからない場合は、「deployment」や「ci-cd」を試してください
3. 人気のあるソースを確認する：多くのスキルは vercel-labs/agent-skills や ComposioHQ/awesome-claude-skills にあります

スキルが見つからない場合

関連するスキルが見つからない場合：

1. 既存のスキルが見つからなかったことを伝えます
2. 一般的な能力を使って、そのタスクを直接支援できることを提案します

例：

I searched for skills related to "xyz" but didn't find any matches.
I can still help you with this task directly! Would you like me to proceed?

If this is something you do often, you could create your own skill:
npx skills init my-xyz-skill

安全ガイドライン

• スキル名を捏造しないでください。Python 検索 API が返すものだけを推奨してください。
• スキルをインストールすると、エージェントに新しい権限が付与されることをユーザーが理解できるようにしてください。