init

初回セットアップ。インストール済みの AI CLI を自動検出し、Target を設定します。

skillshare init              # インタラクティブセットアップ
skillshare init --dry-run    # 変更を加えずにプレビュー

使うタイミング

• マシンで初めて skillshare をセットアップするとき
• 新しいコンピュータへの移行時（既存リポジトリに接続する --remote 付き）
• project に skillshare を追加するとき（--project 付き）
• 新しくインストールされた AI CLI を発見するとき（--discover 付き）

実行される処理

init は Skill の source ディレクトリと、それに並ぶ agents/ ディレクトリを一度に作成するため、両方のリソース種別がすぐに使える状態になります。agents ディレクトリはサイレントに作成されます — 追加のプロンプトやフラグはありません。agent ファイルの形式については Agents を参照してください。

universal Target

いずれかの AI CLI が検出されると、init は自動的に universal Target（~/.agents/skills）を推奨します。これは、互換性のあるすべての agent に一括で Skill を提供するために vercel-labs/skills（npx skills list）が使用する共有ディレクトリです。

agents source path

agents source のデフォルトは <source parent>/agents（デフォルトインストールの場合は ~/.config/skillshare/agents/）です。config.yaml で agents_source: を設定すると場所を上書きできます。project mode では常に project ディレクトリ内の agents/ を使用し、agents_source は無視されます。Agent 対応の Target（Claude、Cursor、Augment、OpenCode）は skillshare sync を実行すると自動的に agent を取り込みます。

Project Mode

-p を使って project レベルの Skill を初期化します。

skillshare init -p                              # インタラクティブ
skillshare init -p --targets claude,cursor  # 非インタラクティブ
skillshare init -p --visible                    # 可視の skillshare/ ディレクトリを使用

実行される処理

init 後は、project ディレクトリ（skills/ と agents/ の両方）を git にコミットしてください。--visible を使うと .skillshare/ の代わりに skillshare/ を作成します。完全なガイドは Project Setup を参照してください。

Discover モード

既存のセットアップに対して init を再実行し、新しい AI CLI Target を検出して追加します。

グローバル

skillshare init --discover              # インタラクティブ選択
skillshare init --discover --select codex,opencode  # 非インタラクティブ

まだ config にない、新しくインストールされた AI CLI をスキャンし、追加するようプロンプトを表示します。universal Target（~/.agents/skills）は、いずれかの CLI が検出されると自動的に推奨されます。

プロジェクト

skillshare init -p --discover           # インタラクティブ選択
skillshare init -p --discover --select antigravity  # 非インタラクティブ

project ディレクトリをスキャンして新しい AI CLI ディレクトリ（例: .agents/）を検出し、Target として追加します。

Discover + Mode の動作

--discover と --mode を組み合わせると、mode はこの discover 実行で追加された Target にのみ適用されます。 config 内の既存 Target は変更されません。

# cursor を mode=copy で追加、既存の Target は変更しない
skillshare init --discover --select cursor --mode copy

# project mode の場合（同じルール）
skillshare init -p --discover --select cursor --mode copy

ヒント

すでに初期化済みのセットアップに対して --discover なしで skillshare init を実行すると、エラーメッセージがそれを使うようヒントを表示します。

オプション

フラグ	説明
--source, -s <path>	カスタム source ディレクトリ（インタラクティブモードでは未設定時にプロンプトを表示）
--remote <url>	git remote を設定（--git を暗黙指定。remote に Skill があれば自動 pull し、組み込み Skill のプロンプトをスキップ）
--project, -p	現在のディレクトリに project レベルの Skill を初期化
--copy-from, -c <name|path>	特定の CLI またはパスから Skill をコピー
--no-copy	空の source から開始（コピーのプロンプトをスキップ）
--targets, -t <list>	カンマ区切りの Target 名
--all-targets	検出されたすべての Target を追加
--no-targets	Target 選択をスキップ
--mode, -m <mode>	新たに設定される Target のデフォルト mode を設定（merge、copy、symlink）。--discover を伴う場合、新たに追加された Target にのみ影響する。
--git	プロンプトなしで git を初期化
--no-git	git の初期化をスキップ
--skill	プロンプトなしで組み込みの skillshare skill をインストール（AI CLI に /skillshare を追加）
--no-skill	組み込み skill のインストールをスキップ
--discover, -d	新しい AI CLI Target を検出して既存の config に追加
--select <list>	追加する Target のカンマ区切りリスト（--discover が必要）
--config local	各開発者が自分の Target を管理できるよう config.yaml を gitignore する（project mode のみ）。Centralized Skills Repo レシピを参照。
--visible	.skillshare/ の代わりに可視の skillshare/ project ディレクトリを作成（project mode のみ）。Project Skills を参照。
--git-root <scope>	commit/push/pull 操作用のディレクトリ（デフォルト skills、他に agents、extras、root）。root は skills + agents + extras をまとめて 1 つのリポジトリでバージョン管理し、config.yaml は自動的に無視される。セットアップ時にインタラクティブにも指定可能。後から skillshare init --git-root <scope> を再実行するとヘッドレスにスコープを切り替えられる — 新しいスコープでリポジトリを init し設定を保持するが、既存の履歴は移動しない。
--subdir <name>	source path としてサブディレクトリを使用（例: skills）
--dry-run, -n	変更を加えずにプレビュー

init は最初の mode ポリシーを設定します。後からいつでも Target ごとに細かく調整できます。

skillshare target cursor --mode copy
skillshare sync

Source サブディレクトリ

デフォルトでは、init --remote は git リポジトリのルート全体を Skill の source として扱います。リポジトリに Skill 以外のファイル（README、CI 設定、dotfile など）も含まれる場合は、代わりに Skill をサブディレクトリに格納できます。

# --subdir なし: リポジトリルート = source（すべてのファイルが Skill）
~/.config/skillshare/skills/          ← git リポジトリルート = source
  ├── my-skill/
  └── another-skill/

# --subdir skills の場合: source はサブディレクトリを指す
~/.config/skillshare/skills/          ← git リポジトリルート
  ├── README.md
  ├── .github/
  └── skills/                         ← source はここを指す
      ├── my-skill/
      └── another-skill/

典型的なユースケース: 専用の Skill 専用リポジトリではなく、既存の dotfiles やモノレポの中に Skill を組み込む場合です。

# インタラクティブ: init 中にプロンプトを表示
skillshare init --remote [email protected]:you/dotfiles.git

# 非インタラクティブ: 直接指定
skillshare init --remote [email protected]:you/dotfiles.git --subdir skills

よくあるシナリオ

リモートセットアップ（いずれかを選択）

インタラクティブ（ガイド付きプロンプトが欲しい初回セットアップに推奨）:

skillshare init --remote [email protected]:you/my-skills.git

非インタラクティブ（プロンプトなし、インストール済み Target を自動検出）:

skillshare init --remote [email protected]:you/my-skills.git --no-copy --all-targets --no-skill

非インタラクティブ（プロンプトなし、かつ既存の Claude skill を今すぐインポート）:

skillshare init --remote [email protected]:you/my-skills.git --copy-from claude --all-targets --no-skill

集約された Skill リポジトリ

# 作成者: ローカル config で共有リポジトリをセットアップ
skillshare init -p --config local --targets claude

# チームメンバー: クローンして共有リポジトリを自動検出
git clone <repo> && cd <repo>
skillshare init -p
skillshare target add myproject ~/DEV/myproject/.claude/skills -p

その他のシナリオ

# 標準セットアップ（すべて自動検出）
skillshare init

# 既存の Skill ディレクトリを使用
skillshare init --source ~/.config/skillshare/skills

# project レベルのセットアップ
skillshare init -p
skillshare init -p --targets claude,cursor

# 完全非インタラクティブセットアップ
skillshare init --no-copy --all-targets --git --skill

# 新たに追加される Target 向けに copy mode をデフォルトとして開始
skillshare init --mode copy

# 新しくインストールされた CLI を既存の config に追加
skillshare init --discover
skillshare init -p --discover

# 新しく発見された Target を追加し、その新しい Target のみ copy mode を強制
skillshare init --discover --select cursor --mode copy