hub

Skill hub を管理します — 組織全体での Skill 発見のために保存された hub source です。

使うタイミング

search が問い合わせる、組織の Skill カタログをセットアップする
複数の hub（例: 全社共通 vs チーム固有）を切り替える
保存済みの hub source を一覧表示または削除する

hub add

hub source を config に保存し、search --hub で再利用できるようにします。

skillshare hub add <url> [options]

フラグ	説明
`--label`, `-l`	カスタムラベル（デフォルト: URL のホスト名から導出）
`--project`, `-p`	project config に保存
`--global`, `-g`	global config に保存

最初に追加された hub は自動的にデフォルトに設定されます。ラベルは大文字小文字を区別しません。

hub URL には、HTTP(S) URL、ローカルファイルパス、または SSH URL（git@host:org/repo.git の scp 形式、または ssh://git@host/org/repo.git のスキーム形式）を指定できます。SSH source の場合、インデックスファイルは //path サフィックス経由でリポジトリから読み込まれ、デフォルトはリポジトリルートの skillshare-hub.json です。SSH source は自分の SSH agent/鍵を使ってクローンされるため、プライベートリポジトリや GitHub Enterprise ホストでも動作します。

SSH hub に同一ホストの GitHub または GitHub Enterprise ドメインプレフィックス付きエントリが含まれる場合、Skillshare はその hub の SSH identity 経由でインストールを行います。例えば、[email protected]:Org/skills.git//hubs/team.json として追加された hub には acme.ghe.com/Org/skills/skills/reviewer を含めることができ、検索結果ではそれを [email protected]:Org/skills.git//skills/reviewer としてインストールします。SSH hub の外では、ドメインプレフィックス付きの source は引き続き HTTPS を意味します。

skillshare hub add https://internal.corp/hub.json --label team
skillshare hub add ./local-hub.json                          # ラベルは導出される: "local-hub"
skillshare hub add [email protected]:team/skills.git --label ghe
skillshare hub add [email protected]:team/skills.git//hubs/team.json --label ghe-team

hub list

保存済みの hub を一覧表示します。* はデフォルトの hub を示します。

skillshare hub list [options]

フラグ	説明
`--project`, `-p`	project の hub を表示
`--global`, `-g`	global の hub を表示

$ skillshare hub list
  * team   https://internal.corp/hub.json
    local  ./local-hub.json

エイリアス: hub ls

hub remove

ラベルを指定して保存済みの hub を削除します。

skillshare hub remove <label> [options]

フラグ	説明
`--project`, `-p`	project config から削除
`--global`, `-g`	global config から削除

削除された hub がデフォルトだった場合、デフォルトはクリアされます。

エイリアス: hub rm

hub default

search --hub（フラグなし）が使用するデフォルトの hub を表示または設定します。

skillshare hub default [label] [options]

フラグ	説明
`--reset`	デフォルトをクリア（community hub に戻す）
`--project`, `-p`	project config を使用
`--global`, `-g`	global config を使用

skillshare hub default              # 現在のデフォルトを表示
skillshare hub default team         # デフォルトを "team" に設定
skillshare hub default --reset      # デフォルトをクリア → community hub

hub index

インストール済みの Skill から skillshare-hub.json インデックスファイルを構築します。生成されたインデックスは、プライベートかつオフラインでの Skill 発見のために search --hub で利用できます。

使い方

skillshare hub index [options]

オプション

フラグ	説明
`--source`, `-s`	スキャンする source ディレクトリ（デフォルト: 自動検出）
`--output`, `-o`	出力ファイルパス（デフォルト: `<source>/skillshare-hub.json`）
`--full`	フルメタデータを含める（flatName、type、version など）
`--audit`	各 Skill にセキュリティ監査を実行し、リスクスコアを含める
`--project`, `-p`	project mode を使用（`.skillshare/`）
`--global`, `-g`	global mode を使用（`~/.config/skillshare`）
`--help`, `-h`	ヘルプを表示

出力モード

Minimal（デフォルト） — 検索とインストールに必要な最小限のフィールドのみ:

{
  "schemaVersion": 1,
  "generatedAt": "2026-02-12T10:00:00Z",
  "sourcePath": "/home/user/.config/skillshare/skills",
  "skills": [
    {
      "name": "my-skill",
      "description": "A useful skill",
      "source": "owner/repo/.claude/skills/my-skill",
      "tags": ["workflow"]
    }
  ]
}

Full（--full） — 監査と管理のためのメタデータを含む:

{
  "name": "my-skill",
  "description": "A useful skill",
  "source": "github.com/owner/repo/.claude/skills/my-skill",
  "tags": ["workflow"],
  "flatName": "my-skill",
  "type": "github-subdir",
  "repoUrl": "https://github.com/owner/repo.git",
  "version": "abc1234",
  "installedAt": "2026-02-10T03:49:06Z",
  "isInRepo": false
}

Audit（--audit） — skillshare audit によるセキュリティリスクスコアを追加:

{
  "name": "my-skill",
  "description": "A useful skill",
  "source": "owner/repo/.claude/skills/my-skill",
  "riskScore": 0,
  "riskLabel": "clean",
  "auditedAt": "2026-02-22T10:00:00Z"
}

--audit は --full と組み合わせて、メタデータとリスクスコアの両方を含めることができます。リスクラベル: clean（0）、low（1–25）、medium（26–50）、high（51–75）、critical（76–100）。

メタデータフィールドは omitempty を使用しており、冗長な値は省略されます。

flatName は name と同じ場合は省略
relPath は source と同じ場合は省略
isInRepo は false の場合は省略

例

# minimal インデックスを構築（デフォルト）
skillshare hub index

# フルメタデータで構築
skillshare hub index --full

# セキュリティリスクスコア付きで構築
skillshare hub index --audit

# フルメタデータ + リスクスコア
skillshare hub index --full --audit

# カスタム出力パス
skillshare hub index -o /shared/team/skillshare-hub.json

# カスタム source ディレクトリ
skillshare hub index -s ~/my-skills

# project mode
skillshare hub index -p

ワークフロー

典型的なプライベート hub のワークフロー:

Skill をインストール        → skillshare install ...
インデックスを構築          → skillshare hub index
インデックスファイルを共有  → Commit/host skillshare-hub.json (HTTP, file, or Git repo)
チームメンバーが検索        → skillshare search --hub [path-url-or-ssh]

インデックスがプライベートまたは GitHub Enterprise リポジトリに存在する場合、チームメンバーは各自でローカルにクローンすることなく、--hub を SSH 経由で直接指定できます（git@host:org/repo.git）。

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

Config 形式

保存済みの hub は config.yaml の hub: キーの下に格納されます。

hub:
  default: team
  hubs:
    - label: team
      url: https://internal.corp/hub.json
    - label: local
      url: ./local-hub.json
    - label: ghe
      url: [email protected]:team/skills.git//hubs/team.json

public hub は組み込みのデフォルトであり、保存する必要はありません。カスタムのデフォルトが設定されていない場合、search --hub は自動的にこれにフォールバックします。このリポジトリを fork して、自分の組織の hub を立ち上げてください。

使うタイミング​

hub add​

hub list​

hub remove​

hub default​

hub index​

使い方​

オプション​

出力モード​

例​

ワークフロー​

Config 形式​