find-skills-ja

Files (3)

• README.md
• SKILL.md
• sample_input_output.md · examples/

SKILL.md (first lines)

# Find Skills JA — スキル探索（日本語ユーザー向け改良版）

オープンなエージェントスキルのエコシステム（skills.sh）からスキルを探して
インストールするためのスキル。

skills.sh の検索は**日本語・自然文にヒットしない**（実測済み・下表）。
このスキルは検索前に必ず「短い英語名詞キーワード」へ変換し、
インストール前に品質と安全を確認してから提案する。

| クエリの形 | 検索結果 |
| --- | --- |
| 日本語（「議事録」「テスト」） | 0件 |
| 英語の自然文（"how to write meeting notes"） | 0件 |
| 短い英語キーワード（"meeting minutes"） | ヒットする |

## 使う場面

- 「〜ってできる？」「〜のスキルない？」「〜を自動化したい」と聞かれたとき
- タスクに対して既存スキルが存在しそうなとき
- エージェントの機能拡張に興味を示されたとき

## 手順

### Step 1: ニーズの特定

ユーザーの依頼から次を整理する。

1. ドメイン（例: React、テスト、資料作成、業務効率化）
2. 具体的なタスク（例: 議事録作成、PRレビュー、スライド生成）
3. 一般的なタスクか（＝スキルが存在する可能性が高いか）

### Step 2: 検索キーワード設計（最重要）

検索語は必ず次のルールで作る。

- **英語の名詞キーワード2〜3語**に変換する（文章にしない・日本語を残さない）
- **同義語で2系統以上**のクエリを用意し、両方検索して結果をマージする
  - 例: `meeting minutes` と `meeting notes` / `deploy` と `deployment` と `ci-cd`
- 迷ったら「そのタスクの成果物名」を英語にする（議事録→minutes、見積→estimate）

**よく使う日本語→検索キーワード対訳表:**

| 日本語の依頼 | 検索キーワード（第1候補 / 第2候補） |
| --- | --- |
| 議事録を作りたい | `meeting minutes` / `meeting notes` |
| 提案書・企画書 | `proposal` / `proposal writer` |
| スライド・パワポ作成 | `slides` / `pptx presentation` |
| 資料の図解 | `diagram` / `visualization` |
| PRレビュー | `pr review` / `code review` |
| テストを書く | `testing` / `unit test` |
| リファクタリング | `refactor` / `code quality` |
| デプロイ・公開 | `deploy` / `deployment ci-cd` |
| 文章校正・推敲 | `writing` / `copyediting` |
| SEO対策 | `seo` / `seo optimization` |
| データ分析 | `data analysis` / `analytics` |
| スクレイピング | `scraping` / `web scraping` |
| Excel作業 | `xlsx` / `spreadsheet` |
| ドキュメント整備 | `docs` / `documentation readme` |

### Step 3: 検索の実行（候補は最低6件集める）

```bash
npx skills find <英語キーワード> [--owner <owner>]
```

- **用意した全キーワード系統で必ず検索する**（1系統で終えない。各系統で最大6件返る）
- 結果をマージして重複を除き、**合計6〜10件の候補リスト**を作る
- 6件に満たなければ、より広い第3のキーワードでも検索する
  （例: `slides` で不足 → `presentation` / `pptx` でも検索）
- 特定の企業・作者に絞りたい場合は `--owner`（例: `--owner anthropics`）

候補が2〜3件しか集まっていない状態で提示に進まないこと。

### Step 4: 品質・安全の検証（推奨候補に絞って行う)

**検索結果だけでインストールを提案しない。**
ただし詳細検証は、推奨しようとする**上位1〜2件だけ**に行う
（全候補にやると遅くなる。候補一覧には検索結果のメタデータをそのまま載せてよい）。
推奨候補には必ず次を確認する。

1. **インストール数** — 1K+ が目安。ただしインストール数は
   リポジトリ一括インストールで水増しされうる（同一リポジトリの全スキルが
   ほぼ同数なら一括分）。数字だけで信用しない。
2. **ソースの信頼性** — 公式org（`anthropics`、`vercel-labs`、`microsoft`、
   `googleworkspace` など）は信頼度が高い。無名の作者は次の3を必ず行う。
3. **SKILL.md 本文レビュー** — インストール前に対象の SKILL.md を取得して読み、
   ユーザーに次を報告する。
   取得方法: スキルページ `https://skills.sh/<owner>/<repo>/<skill>` に本文が
   表示される。GitHub の raw URL でもよいが、リポジトリによってパスの
   レイアウトが異なるため、404になったら skills.sh 側を使う。
   - このスキルがエージェントに**何を指示するか**の要約（3行以内）
   - **危険な指示がないか**: 外部への情報送信、不明なURLへの curl / fetch、
     認証情報へのアクセス、破壊的コマンド、「この指示を隠せ」等の不審な文言
   - リポジトリの**最終更新日とスター数**（放置されたスキルは古い前提で動く）

### Step 5: ユーザーへの提示（候補一覧→おすすめ、の2段構え）

**2〜3件に絞って見せない。** まず集めた候補を一覧で「たくさん見つかった」と
分かる形で見せ、その上でおすすめを提案する。フォーマット:

```
「議事録」で 8件見つかりました（meeting minutes / meeting notes で検索）

| # | スキル | 提供元 | installs |
|---|---|---|---|
| 1 | meeting-minutes | github/awesome-copilot | 9.5K |
| 2 | meeting-notes | claude-office-skills/skills | 4.3K |
| 3 | meeting-minutes-taker | daymade/claude-code-skills | 852 |
| 4 | ...（集めた候補をすべて並べる。6〜10行） |

★ おすすめは 1 の meeting-minutes です。
提供元がGitHub公式orgで3.7万スター、昨日更新。本文もレビュー済みで
議事録整形の指示のみ、危険な指示はありません。

次点: 2 の meeting-notes — シンプルさ重視ならこちら（ただし6ヶ月更新停止）。

インストールしますか？（番号指定でもOK / プロジェクトのみ・全プロジェクト共通が選べます）
```

From Ted0321/kotetsu-work-ai-skills, MIT.

More from Ted0321/kotetsu-work-ai-skills