search

GitHub リポジトリから Skill を発見し、インストールします。

こんなときに使う

ハブのインデックスからコミュニティの Skill を発見する
名前、タグ、説明で Skill を探す
インストール前に利用可能な Skill を閲覧する

クイックスタート

skillshare search vercel       # キーワードで検索
skillshare search              # 人気の Skill を閲覧

これは、クエリに一致する SKILL.md ファイルを含むリポジトリを GitHub 上で検索します。

ブラウズモード

クエリを指定しない場合、search は GitHub 上の人気の Skill を閲覧します。

skillshare search              # 人気の Skill を閲覧
skillshare search --list       # 人気の Skill を一覧表示

これは filename:SKILL.md を GitHub のクエリとして使用し、スター数でソートして、最も人気のある Skill リポジトリを先頭に表示します。

仕組み

skillshare search [query]
        │
        ▼
GitHub Code Search API (filename:SKILL.md + query)
        │
        ▼
Fetch star counts for each repository
        │
        ▼
Sort by stars (most popular first)
        │
        ▼
Interactive selector → Install selected skill

プレビュー

操作方法:

↑ ↓ — 検索結果を移動
Enter — 選択した Skill をインストール
Ctrl+C — キャンセルして終了
入力すると結果をフィルタ

インストール後、再度検索するか、Enter を押して終了できます。

オプション

フラグ	説明
`--project`, `-p`	プロジェクトレベルの config（`.skillshare/`）にインストール
`--global`, `-g`	グローバル config（`~/.config/skillshare`）にインストール
`--hub [URL]`	ハブインデックスから検索（デフォルト: skillshare-hub。またはカスタムの URL/パス）
`--list`, `-l`	インストールプロンプトなしで結果のみ表示
`--json`	JSON として出力（スクリプト向け）
`--limit N`, `-n N`	最大結果数（デフォルト: 20、最大: 100）
`--help`, `-h`	ヘルプを表示

自動検出

--project も --global も指定されない場合、skillshare は自動検出を行います。カレントディレクトリに .skillshare/config.yaml が存在すればプロジェクトモードに、存在しなければグローバルモードになります。

使用例

基本的な検索

skillshare search pdf           # インタラクティブに検索してインストール
skillshare search "code review" # 複数単語の検索

リストモード

skillshare search commit --list

出力:

  1.  fix                      facebook/react/.claude/skills/fix        ★ 242.7k
      Use when you have lint errors, formatting issues...
  2.  verify                   facebook/react/.claude/skills/verify     ★ 242.7k
      Use when you want to validate changes before committing...
  3.  commit-helper            cockroachdb/cockroach/.claude/skills/commit-helper ★ 31.8k
      Help create git commits and PRs with properly formatted messages...

JSON 出力

skillshare search react --json --limit 5

[
  {
    "Name": "react-patterns",
    "Description": "React and Next.js performance optimization...",
    "Source": "facebook/react/.claude/skills/react-patterns",
    "Stars": 242700,
    "Owner": "facebook",
    "Repo": "react",
    "Path": ".claude/skills/react-patterns"
  }
]

プロジェクトモード

skillshare search pdf -p           # 検索してプロジェクトにインストール
skillshare search react --project  # 同じ動作、ロングフラグ版

インストールされた Skill は .skillshare/skills/ に配置され、プロジェクト config は自動的に更新されます。プロジェクトがまだ初期化されていない場合、skillshare は先に init -p を実行します。

結果数の制限

skillshare search frontend -n 5   # 上位 5 件のみ表示

認証

GitHub Code Search API には認証が必要です。skillshare は自動的に認証情報を検出します。

GitHub CLI（推奨） — gh でログイン済みの場合:
```
gh auth login
```
環境変数 — GITHUB_TOKEN または GH_TOKEN を設定:
```
export GITHUB_TOKEN=ghp_your_token_here
```

トークンの作成

gh CLI を使用していない場合:

GitHub Settings → Tokens にアクセス
新しいトークンを生成（classic）
パブリックリポジトリにはスコープ不要
トークンを設定:
```
export GITHUB_TOKEN=ghp_your_token_here
```

検索結果のランキング方法

検索 — GitHub Code Search がクエリに一致する SKILL.md ファイルを探す
フィルタ — フォークされたリポジトリ（重複）を除去
スター数の取得 — 各ユニークなリポジトリのスター数を取得
ソート — スター数（人気順）で並び替え
上限 — 上位 N 件を返す

これにより、高品質で人気のある Skill が先頭に表示されます。

コミュニティ Hub

skillshare-hub からコミュニティがキュレーションした Skill を閲覧・インストールできます。

skillshare search --hub                # skillshare-hub 内のすべての Skill を閲覧
skillshare search react --hub          # skillshare-hub 内で "react" を検索

--hub を URL なしで使用すると、コミュニティの skillshare-hub インデックスがデフォルトで使われます。

あなたの Skill をコミュニティと共有しませんか？PR を開いて Skill を追加してください — CI がすべての投稿に対して skillshare audit を実行します。

保存済みのハブラベル

hub add でハブを保存し、フル URL を入力する代わりにラベルで検索できます。

# 一度ハブを保存
skillshare hub add https://internal.corp/hub.json --label team

# ラベルで検索
skillshare search react --hub team

# 引数なしの --hub のデフォルトに設定
skillshare hub default team
skillshare search --hub              # "team" ハブを使用

--hub <value> の解決順序:

URL またはパス（http、/、.、~、file://、または git@…/ssh://… のような SSH URL で始まる）→ そのまま使用
それ以外 → 保存済みハブからのラベル検索
値なしの --hub → config のデフォルト → コミュニティハブへのフォールバック

保存済みハブの管理については hub を参照してください。

プライベートインデックス検索

GitHub の代わりにプライベートなハブインデックスから検索します。

# ローカルファイル
skillshare search react --hub ./skillshare-hub.json

# HTTP URL
skillshare search react --hub https://internal.corp/skills/skillshare-hub.json

# SSH URL — リポジトリをクローンしてインデックスを読み込む（プライベート/GHE ホストでも動作）
skillshare search react --hub [email protected]:org/skills.git
skillshare search react --hub [email protected]:team/skills.git//hubs/team.json

# すべての Skill を閲覧（空のクエリ）
skillshare search --hub ./skillshare-hub.json --json

# イコール構文も使用可能
skillshare search react --hub=./skillshare-hub.json

SSH ハブソース

SSH の --hub 値は、（あなたの SSH エージェント/キーを使って）リポジトリをシャロークローンし、その中のインデックスファイルを読み込むことで解決されます。リポジトリ内のファイルパスは //path サフィックスから決まります — git@host:org/repo.git//hubs/team.json — 省略した場合はリポジトリルートの skillshare-hub.json がデフォルトになります。scp スタイル（git@host:org/repo.git）とスキームスタイル（ssh://git@host/org/repo.git）の両方の URL がサポートされます。

web ダッシュボードでは、SSH ハブソースは事前に保存しておく必要があります。サーバーは保存済みのハブのみをクローンします。

インデックスの構築には hub index を使用します。

skillshare hub index                           # skillshare-hub.json を生成
skillshare search --hub ./skillshare-hub.json  # それを検索

デフォルトハブ

skillshare search --hub（URL なし）は、デフォルトでコミュニティの skillshare-hub インデックスを使用するため、毎回フル URL を入力する必要はありません。または skillshare hub default <label> で独自のデフォルトを設定できます。

詳細は Hub Index Guide を参照してください。

ヒント

公式の Skill を探す

有名な組織を検索します。

skillshare search anthropic    # Anthropic の Skill
skillshare search facebook     # Meta/Facebook の Skill
skillshare search vercel       # Vercel の Skill

特定の機能を探す

やりたいことで検索します。

skillshare search "pull request"
skillshare search deployment
skillshare search testing
skillshare search database

連続検索

インタラクティブモードでは、Skill をインストール（またはキャンセル）した後、再起動せずに再検索できます。

? Search again (or press Enter to quit): react

トラブルシューティング

"GitHub Code Search API requires authentication"

gh auth login を実行するか、GITHUB_TOKEN を設定してください。認証を参照してください。

"GitHub API rate limit exceeded"

認証済みユーザー: Code Search で 1 分間に 30 リクエスト
1 分待って再試行してください
API 呼び出しを減らすために --limit を使用してください

新しいリポジトリが見つからない

GitHub は新しいリポジトリのインデックス化に遅延があります（数時間〜数日）。リポジトリが見つからない場合:

直接インストールしてください: skillshare install owner/repo/path/to/skill
GitHub がリポジトリをインデックスするのを待ってください

検索結果がクエリと一致しない

GitHub Code Search は SKILL.md ファイル内のコンテンツにマッチします。説明に "vercel" と書かれた Skill は、たとえ Vercel に特化していなくても、vercel の検索結果に表示されます。

インストール前に結果を確認するには --list を使用してください。

こんなときに使う​

クイックスタート​

ブラウズモード​

仕組み​

プレビュー​

オプション​

使用例​

人気の Skill を閲覧​

基本的な検索​

リストモード​

JSON 出力​

プロジェクトモード​

結果数の制限​

認証​

トークンの作成​

検索結果のランキング方法​

コミュニティ Hub​

保存済みのハブラベル​

プライベートインデックス検索​

ヒント​

公式の Skill を探す​

特定の機能を探す​

連続検索​

トラブルシューティング​

"GitHub Code Search API requires authentication"​

"GitHub API rate limit exceeded"​

新しいリポジトリが見つからない​

検索結果がクエリと一致しない​