/install

sidebar_position: 3

install

GitHub リポジトリ、git URL、またはローカルパスから Skill を追加します。

概要

flowchart TD
    INSTALL["install"] --> SOURCE["source"]
    SOURCE --> SYNC1["sync"] --> TARGETS["targets"]
    SOURCE --> UPDATE["update"]
    SOURCE --> UNINSTALL["uninstall"] --> SYNC2["sync"] --> REMOVED["removed from targets"]

こんなときに使う

• GitHub、GitLab、Bitbucket、Azure DevOps、またはローカルパスから新しい Skill を追加する
• 組織で共有している Skill リポジトリをインストールする（`--track` を使用）
• 既存の Skill を再インストールまたは更新する（`--update` または `--force` を使用）

---

クイックサンプル

# GitHub から（省略形）
skillshare install anthropics/skills/skills/pdf

# リポジトリ内の利用可能な Skill を閲覧
skillshare install anthropics/skills

# ローカルパスから
skillshare install ~/Downloads/my-skill

# トラック対象のリポジトリとして（チーム共有用）
skillshare install github.com/team/skills --track

# サブディレクトリへインストール（カテゴリ別に整理）
skillshare install ~/my-skill --into frontend

# config に記載された全 Skill をインストール（引数なし）
skillshare install

ソースの形式

GitHub 省略形

`owner/repo` 形式を使うと、自動的に `github.com/owner/repo` に展開されます。

skillshare install anthropics/skills                    # ブラウズモード
skillshare install anthropics/skills/skills/pdf         # 直接インストール
skillshare install ComposioHQ/awesome-claude-skills     # 別のリポジトリ

GitLab / Bitbucket / その他のホスト

GitHub 以外のホストでは `domain/owner/repo` 形式を使用します。

skillshare install gitlab.com/user/repo                 # GitLab
skillshare install bitbucket.org/team/skills            # Bitbucket
skillshare install git.company.com/team/skills          # セルフホスト

フル URL や SSH も使用できます。

skillshare install https://gitlab.com/user/repo.git
skillshare install git@gitlab.com:user/repo.git

:::tip カスタムドメイン上のセルフマネージド GitLab ホスト名に `gitlab` または `jihulab` を含む場合、ネストしたサブグループのサポートを含めて自動検出されます。その他のカスタムドメイン上のセルフマネージド GitLab インスタンス（例: `git.company.com`）の場合は、config の [`gitlab_hosts`](/docs/reference/targets/configuration#gitlab_hosts) にホスト名を追加すると、skillshare が URL パス全体をリポジトリとして扱うようになります。config を設定しない場合は、回避策として `.git` を末尾に付けることもできます: `git.company.com/team/frontend/ui.git`。 :::

Azure DevOps

`ado:` の省略形、またはフルの Azure DevOps URL を使用します。

# 省略形（ado:org/project/repo）
skillshare install ado:myorg/myproject/myrepo
skillshare install ado:myorg/myproject/myrepo/skills/react    # サブディレクトリ付き

# フル HTTPS URL
skillshare install https://dev.azure.com/myorg/myproject/_git/myrepo

# レガシー形式（自動正規化）
skillshare install https://myorg.visualstudio.com/myproject/_git/myrepo

# SSH
skillshare install git@ssh.dev.azure.com:v3/myorg/myproject/myrepo

ブラウズモード（Skill の閲覧）

パスを指定しない場合、skillshare はリポジトリをクローンし、Skill をスキャンして、インタラクティブなピッカーを表示します。

skillshare install anthropics/skills

<p> <img src="/img/install-demo.png" alt="install demo" width="720" /> </p>

ディスカバリーは `.git` のみをスキップし、すべてのディレクトリを `SKILL.md` ファイルについてスキャンします。つまり、`.curated/` や `.system/` のような隠しディレクトリ内の Skill も自動的に検出されます。複数の Skill が見つかった場合、選択プロンプトはディレクトリごとにグルーピングされ、閲覧しやすくなります。

リポジトリのルートに `.skillignore` ファイルがある場合、一致する Skill はディスカバリーから自動的に除外されます。詳細は下記の [.skillignore](#skillignore) を参照してください。

Skill の `SKILL.md` に `license:` フロントマターフィールドが含まれている場合、そのライセンスは選択プロンプト（例: `my-skill (MIT)`）と、単一 Skill インストール時の確認画面に表示されます。

**Tip**: インストールせずにプレビューするには `--dry-run` を使用します。

skillshare install anthropics/skills --dry-run

選択インストール（非インタラクティブ）

プロンプトなしで、複数 Skill を含むリポジトリから特定の Skill を選びます。`--skill` フラグは **fuzzy matching** と **glob パターン** をサポートしています。完全一致する名前が見つからない場合、glob マッチング（`*`、`?`、`[...]`）を試し、それでも見つからなければ最も近い部分文字列マッチにフォールバックします。

# 名前で特定の Skill をインストール（完全一致または fuzzy）
skillshare install anthropics/skills -s pdf,commit

# glob パターンに一致する Skill をインストール
skillshare install anthropics/skills -s "core-*"

# 検出されたすべての Skill をインストール
skillshare install anthropics/skills --all

# 自動承認（複数 Skill のリポジトリでは --all と同じ）
skillshare install anthropics/skills -y

# 他のフラグと組み合わせる
skillshare install anthropics/skills -s pdf --dry-run
skillshare install anthropics/skills --all -p

glob マッチングは大文字小文字を区別しません: `"Core-*"` は `core-auth`、`CORE-DB` などにマッチします。

:::tip シェルの glob 展開への対策 シェルがカレントディレクトリのファイル名に `*` を展開してしまわないよう、glob パターンは常にクォート（`"core-*"`）してください。 :::

CI/CD パイプラインやスクリプト化されたワークフローに便利です。

直接インストール（特定のパス）

フルパスを指定して即座にインストールします。

# サブディレクトリ付き GitHub
skillshare install anthropics/skills/skills/pdf
skillshare install google-gemini/gemini-cli/packages/core/src/skills/builtin/skill-creator

# ファジーなサブディレクトリ — 完全一致するパスが存在しない場合、Skill 名でマッチ
skillshare install runkids/my-skills/vue-best-practices

# フル URL
skillshare install github.com/user/repo/path/to/skill

# SSH URL
skillshare install git@github.com:user/repo.git

# サブディレクトリ付き SSH URL（// セパレータを使用）
skillshare install git@github.com:user/repo.git//path/to/skill

# ローカルパス
skillshare install ~/Downloads/my-skill
skillshare install /absolute/path/to/skill

:::tip ファジーなサブディレクトリ解決 `owner/repo/skill-name` のようなサブディレクトリパスを指定した際、そのパスがリポジトリ内に完全一致で存在しない場合、skillshare はすべての `SKILL.md` ファイルをスキャンし、ディレクトリのベース名でマッチさせます。同名の Skill が複数存在する場合は、フルパス付きの曖昧性エラーが表示されるので、正確なパスを指定できます。 :::

Config からのインストール（引数なし） {#install-from-config-no-arguments}

ソースの引数を指定せずに実行すると、`skillshare install` は記録済みのリモート Skill メタデータ（グローバルモード）またはプロジェクトの `skills:` マニフェスト（プロジェクトモード）を読み込み、まだローカルに存在しないすべてのリモート Skill をインストールします。

# グローバル — ~/.config/skillshare/config.yaml を読む
skillshare install

# プロジェクト — .skillshare/config.yaml を読む
skillshare install -p

これにより、記録済みのメタデータ／マニフェストは **持ち運び可能な Skill セットアップ** になります。どのマシンでも同じ Skill 構成を再現するために共有できます。

# 新しいマシンのセットアップ
skillshare install       # メタデータからリモート Skill とトラック対象リポジトリを復元
skillshare sync          # ターゲットへ sync

# 新しいチームメンバーのオンボーディング
git clone github.com/team/project && cd project
skillshare install -p    # プロジェクト config からすべてのリモート Skill をインストール
skillshare sync

`tracked: true` の Skill は（`--track` と同様に）完全な git 履歴付きでクローンされるため、`skillshare update` が正しく動作します。すでにディスクに存在する Skill はスキップされます。これは、トラック対象リポジトリのディレクトリが gitignore されていてローカルに存在しない状態で、クローン直後に実行する復旧コマンドです。

:::tip push/pull と install from config の違い `push`/`pull` は実際の