The dashboard screenshots predated the Projects page and showed codex at its old path, and the guides for dashboard-only features (AGENTS.md sharing, MCP, plugins, backups, hubs) had no pictures at all. - Re-shoot the dashboard screenshots (docs and README copies) and add ones for targets, extras, shared AGENTS.md, MCP, project MCP, plugins, backups, hubs and project mode. - Add diagrams for sharing AGENTS.md, MCP sync and migrating with collect; fix codex's path in the getting-started diagram. - Replace terminal screenshots with real output as text, and remove images nothing referenced. - Fix text that no longer matched the dashboard (project mode, hub navigation, backup list output).
13 KiB
sidebar_position
| sidebar_position |
|---|
| 5 |
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
プレビュー
$ skillshare search runkids
▸ Searching runkids
│
├─ Found 20 skill(s) (12.0s)
Select skills to install (0/20 selected)
▌ [ ] skillshare ★ 2.7k
▌ runkids/skillshare/skills/skillshare
▌ [ ] skill-sharing ★ 654
▌ majiayu000/claude-skill-registry/skills/skills/skill-sharing
▌ [ ] skillshare-changelog ★ 2.7k
▌ runkids/skillshare/.skillshare/skills/skillshare-changelog
…
20 skills · Page 1 of 2
─────────────────────────────────────────
Description: Manage skills, agents, extras, plugins, and MCP connection settings with the Skillshare CLI.
Use when the user asks to configure or run Skillshare, install or sync resources across AI
tools, import MCP settings, manage targets, audit skills, recover backups, or troubleshoot...
Source: runkids/skillshare/skills/skillshare
Stars: 2.7k
↑↓ navigate ←→ page space toggle a all enter install s search again / filter esc cancel
操作方法:
↑↓— 検索結果を移動、←→— ページを切り替えSpace— Skill を選択または解除、a— 表示中の項目をすべて選択Enter— 選択した Skill をインストール(何も選択していない場合はキャンセル)/— 結果をフィルタ、s— 再検索Escまたは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 |
ヘルプを表示 |
:::tip 自動検出
--project も --global も指定されない場合、skillshare は自動検出を行います。カレントディレクトリに .skillshare/config.yaml が存在すればプロジェクトモードに、存在しなければグローバルモードになります。
:::
使用例
人気の Skill を閲覧
skillshare search # 人気の Skill を閲覧(クエリなし)
基本的な検索
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 git@github.com:org/skills.git
skillshare search react --hub git@ghe.corp.com:team/skills.git//hubs/team.json
# すべての Skill を閲覧(空のクエリ)
skillshare search --hub ./skillshare-hub.json --json
# イコール構文も使用可能
skillshare search react --hub=./skillshare-hub.json
:::note 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 # それを検索
:::tip デフォルトハブ
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 を使用してください。