メインコンテンツまでスキップ

集中管理型 vs ローカルファースト

Skill 管理ツールは一般的に、集中管理型プラットフォームかローカルファーストのいずれかのアーキテクチャアプローチを採用しています。どちらが普遍的に優れているというわけではなく、それぞれにトレードオフがあります。このページでは両方を解説し、あなたのワークフローに合うものを判断できるようにします。

これは機能比較ではありません

機能レベルの違い（インストールフロー、設定形式など）については、Skill 管理アプローチの比較 を参照してください。このページでは、データがどこに置かれるか、発見の仕組み、何をコントロールできるかといったアーキテクチャ上のトレードオフに焦点を当てます。

2つのアプローチ​

集中管理型プラットフォーム​

集中管理型プラットフォームは、Skill が公開・検索・ランキングされる統一されたレジストリをホストします。インストール活動はダウンロード数やトレンドランキングといったコミュニティ指標に集約されます。

強み:

  • 組み込みの発見機能 — 1か所で Skill を閲覧、検索、比較できる
  • コミュニティシグナル — ダウンロード数やトレンドが人気の Skill を可視化する
  • 低い導入コスト — 発見のためのセットアップが不要で、検索してインストールするだけ

考慮点:

  • インストール活動はプラットフォームによって追跡される
  • ランキングやカウントのルールはプラットフォーム運営者が管理する

ローカルファースト（skillshare）​

skillshare はすべての状態をあなたのマシン上に保持します。Skill は git clone でインストールされ、ローカルの設定ファイルで管理されます。リモートサーバーには何も送信されません。

強み:

  • テレメトリなし — インストールの追跡もデータ送信も一切ない
  • 完全な所有権 — Skill はあなた自身のファイルシステムに存在する
  • 初回インストール後はオフラインで動作可能
  • 単一バイナリで、ランタイム依存なし

考慮点:

  • 組み込みのコミュニティ指標（ダウンロード数、トレンド）がない
  • 発見には Hub のセットアップまたは接続が必要

発見（Discovery）​

ローカルファーストだからといって発見機能がないわけではありません。skillshare は3つの発見チャネルを提供します。

チャネル仕組み
GitHub 検索skillshare search <query> — 公開 GitHub リポジトリを直接検索
公開 Hubskillshare search --hub — 組み込みの コミュニティ Hub に問い合わせる
カスタム Hubskillshare search --hub <url> — あなたや組織が運用する任意の Hub に問い合わせる

Hub とは何か​

Hub は、Skill の名前、説明、Source、タグを列挙した静的な JSON ファイル（skillshare-hub.json）です。Git リポジトリ、HTTP サーバー、ローカルファイルシステムなど、どこにでも置くことができます。

# インストール済みの Skill からインデックスを構築
skillshare hub index

# 組織の内部 Hub を検索
skillshare search --hub https://internal.corp/skills/hub.json

# ローカルのインデックスファイルを検索
skillshare search --hub ./skillshare-hub.json

Hub は独立した存在です — 誰でも作成でき、ユーザーは複数の Hub に同時に接続できます。これにより、公開 Hub と並行してプライベートな Skill カタログを維持する必要がある組織に適しています。

詳しい手順は Hub Index ガイド を参照してください。

セルフホスト指標​

skillshare 自体はインストールを追跡しませんが、自分のサーバーで Hub をホストする場合、好きな分析レイヤーを追加できます。

  1. skillshare-hub.json を自分のサーバーでホストする
  2. リクエストログや軽量な分析エンドポイントを追加する
  3. 検索ヒット数、インストール参照元など、任意の指標を追跡する

これにより、Skill の作者や組織は自分たちの基準で採用状況を測定できます。

適切なアプローチの選び方​

集中管理型プラットフォームが適しているのは:

  • すぐに使える組み込みのコミュニティ指標やトレンドが欲しい場合
  • Skill を発見するための単一の閲覧先を好む場合
  • 使う AI CLI が1つだけで、ツール間の同期が不要な場合

ローカルファーストが適しているのは:

  • 複数の AI CLI を使っていて、統一的な管理が欲しい場合
  • インストール活動を自分のマシンに留めたい場合
  • オフライン動作が必要、または制限されたネットワーク環境で作業している場合
  • どの Skill を利用可能・発見可能にするかをコントロールする必要がある組織の場合

関連項目​