skill-finder

スキルファインダー

skills.sh からスキルを見つけてインストールする最もスマートな方法です。

トリガーフレーズ

• /skill-finder
• /skill-finder [説明]
• 「〜に使えるスキルを探して」
• 「〜用のスキルはありますか？」
• 「何のスキルを使えばよいですか？」

プロセスの概要

User Request
     │
     ▼
┌─────────────────────────┐
│ 0. Check Installed      │ ← Don't recommend what user already has
└─────────────────────────┘
     │
     ▼
┌─────────────────────────┐
│ 1. Detect Agent         │ ← Auto-detect Claude Code, Cursor, etc.
└─────────────────────────┘
     │
     ▼
┌─────────────────────────┐
│ 2. Parse Intent         │ ← Extract keywords, map to search terms
└─────────────────────────┘
     │
     ▼
┌─────────────────────────┐
│ 3. Targeted Search      │ ← Search with specific keywords + categories
└─────────────────────────┘
     │
     ▼
┌─────────────────────────┐
│ 4. Context Check        │ ← Only if needed for disambiguation
└─────────────────────────┘
     │
     ▼
┌─────────────────────────┐
│ 5. Rank & Compare       │ ← Quality signals + comparison mode
└─────────────────────────┘
     │
     ▼
┌─────────────────────────┐
│ 6. Recommend            │ ← Present with quality badges
└─────────────────────────┘
     │
     ▼
┌─────────────────────────┐
│ 7. Install              │ ← Global or project, auto-detect agent
└─────────────────────────┘
     │
     ▼
┌─────────────────────────┐
│ 8. Related Skills       │ ← Suggest complementary skills
└─────────────────────────┘

---

ステップ 0：インストール済みスキルを確認する

検索する前に、インストール済みのスキルを確認します：

# Check common skill locations
ls -la .claude/skills/ 2>/dev/null
ls -la .cursor/rules/ 2>/dev/null
ls -la .agents/skills/ 2>/dev/null
ls -la ~/.claude/skills/ 2>/dev/null  # Global

ユーザーが必要とするスキルがすでにインストールされている場合：

You already have **{skill-name}** installed at `{path}`.

→ Want me to invoke it now, or find alternatives?

古いバージョンがインストールされている場合：

You have **{skill-name}** installed, but there may be updates.

→ Want me to check for updates, or use the current version?

---

ステップ 1：エージェントを検出する

ユーザーが使用している AI エージェントを自動検出します：

確認対象	エージェント	インストールフラグ
.claude/ ディレクトリまたは CLAUDE.md	Claude Code	-a claude-code
.cursor/ ディレクトリ	Cursor	-a cursor
.github/copilot/ ディレクトリ	GitHub Copilot	-a copilot
.cline/ ディレクトリ	Cline	-a cline
.codex/ ディレクトリ	Codex	-a codex
.continue/ ディレクトリ	Continue	-a continue

検出したエージェントをインストール手順で使用できるように保存します。

複数のエージェントが検出された場合、または何も検出されなかった場合：

• Claude Code のコンテキストでは claude-code をデフォルトにします
• または、使用しているエージェントをユーザーに尋ねます

---

ステップ 2：意図を解析してキーワードを抽出する

ユーザーのリクエストから、以下を抽出します：

• 主なトピック（例：「決済」「認証」「テスト」）
• 言及された具体的なテクノロジー（例：「Stripe」「Supabase」「Playwright」）
• アクションの種類（例：「追加する」「構築する」「改善する」「デバッグする」）

検索キーワードに対応付けます：

ユーザーの発言	検索キーワード
決済、請求、チェックアウト	stripe, payment, billing, checkout, subscription
認証、ログイン、サインイン	auth, authentication, login, oauth, jwt, session, clerk, better-auth
テスト、テスト実行、TDD	test, testing, playwright, jest, vitest, e2e, tdd, qa
データベース、DB、データ	postgres, supabase, prisma, mongodb, sql, database, migration
AI、LLM、RAG、埋め込み	rag, llm, embedding, ai-sdk, mcp, vector, openai, anthropic
フロントエンド、UI、React	react, nextjs, vue, svelte, frontend, tailwind, ui, component
バックエンド、API、サーバー	fastapi, express, nestjs, backend, api, server, node
DevOps、CI/CD、デプロイ	docker, k8s, kubernetes, github-actions, terraform, deploy, ci
メール、通知	email, resend, notification, messaging, smtp
ドキュメント、PDF、Excel	pdf, docx, xlsx, pptx, document, report
動画、アニメーション	remotion, video, animation, threejs, canvas, webgl
スクレイピング、自動化	browser, scrape, automation, crawl, puppeteer, playwright
マーケティング、SEO、成長	seo, marketing, cro, copywriting, analytics, conversion
モバイル、React Native、iOS	react-native, ios, android, swiftui, mobile, flutter, expo
セキュリティ	security, auth, encryption, vulnerability, audit, secrets

---

ステップ 3：対象を絞って検索する

重要：適切なスキル参照を取得するため、最初に CLI の検索コマンドを使用します：

npx skills search {keyword} --limit 10

このコマンドは、スキルを正しい形式 author/repo@skill-name で返します。

形式について：

• author/repo@skill-name — 検索結果から得られる完全なスキル参照
• author/repo — npx skills add に渡す値（そのリポジトリ内のすべてのスキルをインストールします）

WebFetch を代替手段として使う場合（CLI が利用できない場合）：

WebFetch: https://skills.sh/?search={primary_keyword}
Prompt: List matching skills with:
        - Full reference (author/repo@skill-name format)
        - Install count
        - Description
        Focus on skills matching: {specific_technologies_mentioned}

ユーザーのリクエストが曖昧な場合（/skill-finder のみの場合）：

• 「何を実現しようとしていますか？」と尋ねます
• 検索する前に、回答を待ちます

---

ステップ 4：コンテキストの確認（必要な場合のみ）

次の場合は、コンテキストの収集を省略します。

• ユーザーが技術を明確に指定している（例：「Stripe」、「Playwright」）
• 検索結果から、明確に最適なものが 1 つ見つかった
• ユーザーのリクエストが曖昧でない

次の場合は、コンテキストを収集します。

• 類似したスキルが複数見つかった（区別するために技術スタックの確認が必要）
• ユーザーのリクエストが一般的である（例：「データベースのベストプラクティス」）
• 互換性の確認が必要

簡易コンテキストチェック：

ファイル	抽出する情報
package.json	フレームワーク（react、next、vue）、主要な依存関係、supabase/stripe などの有無
pyproject.toml	Python フレームワーク（fastapi、django、flask）
go.mod	Go プロジェクトであることの確認
Cargo.toml	Rust プロジェクトであることの確認
.env.example	統合されているサービス（Stripe、Supabase など）

次の形式で要約します。 Stack: {framework}, {language}, {key_dependencies}

---

ステップ 5：品質シグナルで順位付けする

順位付けで考慮する品質指標：

シグナル	確認方法	重み
公式／認証済み	作成者が stripe/、anthropics/、vercel/、supabase/、resend/	高
インストール数が多い	インストール数が 1000 以上	中
技術スタックとの一致	ユーザーの検出された技術スタックにスキルが合っている	高
具体的な一致	スキル名にユーザーの検索語がそのまま含まれている	高

公式／認証済みの作成者（⭐ バッジを表示）：

• stripe/ - Stripe 公式
• anthropics/ - Anthropic 公式
• vercel/ または vercel-labs/ - Vercel 公式
• supabase/ - Supabase 公式
• resend/ - Resend 公式
• remotion-dev/ - Remotion 公式
• better-auth/ - Better Auth 公式
• callstackincubator/ - Callstack（React Native のエキスパート）
• cloudai-x/ - Three.js スキル
• trailofbits/ - セキュリティのエキスパート

---

ステップ 5b：比較モード

関連性の高いスキルが複数ある場合は、比較を表示します。

## Comparing {Category} Skills

| Feature | {skill-1} | {skill-2} | {skill-3} |
|---------|-----------|-----------|-----------|
| Installs | {count} | {count} | {count} |
| Official | ⭐ Yes | No | No |
| Your Stack | ✅ Match | ✅ Match | ❌ Different |
| Focus | {focus} | {focus} | {focus} |

**Recommendation:** {skill-name} ({reason})

→ Want details on any of these, or should I install the recommendation?

次の場合は比較モードを開始します。

• 上位 2～3 件のスキルの関連度スコアが近い
• ユーザーが「……の違いは何ですか？」と尋ねている
• 同じ目的でもアプローチが異なるスキルがある

---

安全性チェック

スキルを推奨する前に、必ず確認します。

1. 作成者の確認

✅ TRUSTED - Official/Verified authors (install without warning):
   stripe/, anthropics/, vercel/, vercel-labs/, supabase/, resend/,
   remotion-dev/, better-auth/, callstackincubator/, trailofbits/

⚠️ COMMUNITY - Other authors (show warning before install):
   "This skill is from a community author. Review before installing."

2. タイポスクワッティングの確認

推奨する前に、スキル名が人気のあるスキル名の誤記のように見えないか確認します。

• stripe-best-pracitces → 不審（stripe-best-practices の誤記）
• react-best-prctices → 不審
• supabase-postgers → 不審

不審な場合： 推奨しないか、ユーザーに明示的に警告します。

3. インストールの確認

インストール前に、必ず次を表示します。

**About to install:** {skill-name}
**Author:** {author}
**Source:** https://github.com/{author}/{repo}

⚠️ Installing skills runs code on your machine.
   Review the source if you don't trust the author.

→ Proceed with installation? (y/n)

4. ソースへのリンク

ユーザーが確認できるよう、GitHub リンクを必ず提示します。

📂 **View source:** https://github.com/{author}/{repo}/blob/main/skills/{skill}/SKILL.md

---

ステップ 6：推奨内容を提示する

品質バッジを付けて表示します。

## Recommended Skills

Based on your {stack} project and goal to {userIntent}:

1. **{skill-name}** by {author} ({installs} installs) ⭐ Official
   {Why this matches - be specific about the fit}

2. **{skill-name}** ({installs} installs)
   {Why this is relevant, any trade-offs vs #1}

3. **{skill-name}** ({installs} installs)
   {When you'd choose this instead}

→ Want me to install any of these?

品質バッジ：

• ⭐ = 公式／認証済みの作成者
• 🔥 = トレンド（インストール数が多い）
• ✅ = 技術スタックに完全に一致

---

ステップ 7：インストール

重要：CLI では author/skill-name ではなく、author/repo 形式を使用します。

jezweb/claude-skills@tanstack-query のような検索結果の場合：

• jezweb/claude-skills = リポジトリ（インストール時に使用）
• tanstack-query = そのリポジトリ内の特定のスキル名

⚠️ 重要：リポジトリをインストールすると、その中のすべてのスキルがインストールされます。

スキルが多数含まれているリポジトリもあります。

• jezweb/claude-skills には 90 以上のスキルがあります（おそらく多すぎます）
• vercel-labs/next-skills には 3 つのスキルがあります（対象が絞られています）

ユーザーのニーズに合ったスキルが少数含まれている、対象を絞ったリポジトリを優先します。

大規模なリポジトリしか選択肢がない場合：

1. ユーザーに警告します：「このリポジトリには {N} 個のスキルが含まれています。インストールしますか？」
2. すべてのスキルを確認できるよう、https://skills.sh/{author}/{repo} を案内します
3. インストール後、不要なスキルの削除を提案します

インストール範囲について確認します。

Install **{skill-name}** from `{author}/{repo}` to:
1. **This project** (./agents/skills/) - Recommended
2. **Globally** (all your projects)

→ Which do you prefer? (default: this project)

⚠️ Note: This will install {N} skills from this repo.

インストールコマンド：

# Project-level (default) - uses author/repo, NOT skill name
npx skills add {author}/{repo} -a {detected_agent} -y

# Global installation
npx skills add {author}/{repo} -a {detected_agent} -y -g

インストールが正常に完了した後：

✓ Installed skills from **{author}/{repo}** to {install_path}

Agent: {detected_agent}
Scope: {project|global}
Skills installed: {list of skill names}

---

ステップ 8：関連するスキルを提案する

インストール後に、補完的なスキルを提案します：

インストール済みスキル	提案する関連スキル
stripe-*	webhook-patterns, subscription-management, billing-automation
*-auth, authentication	session-management, secrets-management, security-*
supabase-*	row-level-security, database-migration, sql-optimization
playwright-*, testing	test-driven-development, e2e-testing-patterns, qa-test-planner
react-*	react-testing, react-performance, react-state-management
nextjs-*	vercel-deployment, nextjs-app-router-patterns
fastapi-*	async-python-patterns, python-testing-patterns
docker-*	k8s-*, deployment-pipeline-design
ai-sdk, rag-*	embedding-strategies, mcp-builder, llm-evaluation
remotion-*	動画処理スキル、アニメーションスキル

形式：

**You might also need:**
- **{related-skill-1}** - {why relevant to what they just installed}
- **{related-skill-2}** - {why relevant}

→ Want me to install any of these too?

---

ステップ 9：更新を確認する（任意）

ユーザーがスキルをインストール済みの場合、更新の確認を提案します：

npx skills check

更新がある場合：

📦 **Updates Available**

| Skill | Current | Latest | Changes |
|-------|---------|--------|---------|
| stripe-integration | 1.0.0 | 1.2.0 | New webhook patterns |
| react-best-practices | 2.1.0 | 2.3.0 | React 19 support |

→ Want me to update these?

更新コマンド：

npx skills update

---

エラー処理

一致するものが見つからない場合

I couldn't find skills that directly match "{user_request}".

**Suggestions:**
- Try different keywords (e.g., "auth" instead of "login system")
- Be more specific (e.g., "Supabase auth" instead of "auth")
- Browse skills.sh directly: https://skills.sh/

**Popular categories you might explore:**
- Authentication: `better-auth`, `clerk-auth`, `supabase-auth`
- Testing: `playwright-skill`, `webapp-testing`
- Payments: `stripe-best-practices`

What would you like to try?

skills.sh にアクセスできない場合

I'm having trouble reaching skills.sh right now.

**Options:**
1. Try again in a moment
2. Browse directly: https://skills.sh/
3. Tell me what you need and I'll help without a skill

What would you like to do?

インストールに失敗した場合

Installation failed: {error_message}

**Try manually:**
```bash
npx skills add {author}/{skill-name}

または、スキルを閲覧してください：https://skills.sh/{author}/{skill-name}

よくある解決方法：

• npm cache clean --force を実行して再試行する
• インターネット接続を確認する
• -g フラグを付けてグローバルにインストールしてみる

### Skill Already Installed

```markdown
**{skill-name}** is already installed at `{path}`.

**Options:**
1. Invoke it now for your current task
2. Check for updates
3. Find alternative skills
4. Reinstall (overwrite)

What would you like to do?

---

例

迅速な方法（意図が明確な場合）

User: /skill-finder Stripe payments

Agent: Let me search for Stripe skills...
       [Runs: npx skills search stripe --limit 10]

       ## Recommended Skills

       Based on your goal to add Stripe payments:

       1. **stripe-best-practices** from `stripe/ai-skills` (354 installs) ⭐ Official
          Official Stripe patterns - checkout, webhooks, subscriptions
          Repo contains 2 skills (focused)

       2. **stripe-integration** from `wshobson/agents` (349 installs)
          End-to-end integration patterns
          ⚠️ Repo contains 15 skills

       → Want me to install any of these?

User: Install #1

Agent: Install from `stripe/ai-skills` to:
       1. This project (./agents/skills/) - Recommended
       2. Globally (all your projects)

       This repo contains 2 skills - both Stripe-related.

User: 1

Agent: [Runs: npx skills add stripe/ai-skills -a claude-code -y]

       ✓ Installed 2 skills from **stripe/ai-skills** to .agents/skills/

       Skills installed:
       - stripe-best-practices
       - stripe-webhooks

       → Want me to apply these to your current task?

比較モードを使用する場合

User: /skill-finder authentication

Agent: I found several auth skills. Here's a comparison:

       ## Comparing Authentication Skills

       | Feature | better-auth | clerk-auth | supabase-auth |
       |---------|-------------|------------|---------------|
       | Installs | 3,373 | 129 | 142 |
       | Official | ⭐ Yes | No | No |
       | Self-hosted | ✅ | ❌ Cloud | ✅ |
       | Social login | ✅ | ✅ | ✅ |
       | Your Stack | ✅ Next.js | ✅ Next.js | ⭐ You use Supabase |

       **Recommendation:** supabase-auth (best fit - you already use Supabase)

       → Want me to install supabase-auth, or details on another?

すでにインストール済みの場合

User: /skill-finder React testing

Agent: You already have **webapp-testing** installed at `.claude/skills/webapp-testing/`.

       **Options:**
       1. Invoke it now for your React testing needs
       2. Find additional/alternative testing skills
       3. Check for updates

       What would you like to do?

User: 2

Agent: ## Additional Testing Skills

       Since you have webapp-testing, here are complementary skills:

       1. **react-testing** (412 installs)
          React-specific testing patterns (RTL, hooks testing)

       2. **test-driven-development** (1,289 installs) ⭐ Popular
          TDD methodology and workflow

       → Want me to install any of these?

更新の確認

User: /skill-finder --check-updates

Agent: 📦 **Checking your installed skills...**

       | Skill | Status |
       |-------|--------|
       | stripe-best-practices | ✅ Up to date |
       | webapp-testing | 🔄 Update available (1.2.0 → 1.3.0) |
       | react-best-practices | ✅ Up to date |

       → Want me to update webapp-testing?

---

パフォーマンスのヒント

1. 具体的に指定する — 「payments」より「Stripe checkout」のほうが適切な候補を見つけられます
2. 使用しているスタックを伝える — 「React Native auth」なら結果を絞り込めます
3. 一度に1つのトピックを扱う — 「auth and payments」は2つの検索に分けます
4. まずインストール済みか確認する — /skill-finder --installed で重複を避けます
5. 公式スキルを使う — 品質が検証済みであることを示す ⭐ バッジを探します