--- sidebar_position: 1 --- # init 初回セットアップ。インストール済みの AI CLI を自動検出し、Target を設定します。 ```bash skillshare init # インタラクティブセットアップ skillshare init --dry-run # 変更を加えずにプレビュー ``` ## 使うタイミング - マシンで初めて skillshare をセットアップするとき - 新しいコンピュータへの移行時(既存リポジトリに接続する `--remote` 付き) - project に skillshare を追加するとき(`--project` 付き) - 新しくインストールされた AI CLI を発見するとき(`--discover` 付き) ## 実行される処理 ```mermaid flowchart TD TITLE["skillshare init"] S0["0. Source path prompt"] S1["1. Create source + agents directories"] S2["2. Auto-detect AI CLIs"] S3["3. Initialize git"] S4["4. Set up remote"] S4b["5. Subdirectory prompt"] S5["6. Create config.yaml"] S6["7. Built-in skill"] TITLE --> S0 --> S1 --> S2 --> S3 --> S4 --> S4b --> S5 --> S6 ``` `init` は Skill の source ディレクトリと、それに並ぶ `agents/` ディレクトリを一度に作成するため、両方のリソース種別がすぐに使える状態になります。agents ディレクトリはサイレントに作成されます — 追加のプロンプトやフラグはありません。agent ファイルの形式については [Agents](/docs/understand/agents) を参照してください。 :::info universal Target いずれかの AI CLI が検出されると、`init` は自動的に **universal** Target(`~/.agents/skills`)を推奨します。これは、互換性のあるすべての agent に一括で Skill を提供するために [vercel-labs/skills](https://github.com/vercel-labs/skills)(`npx skills list`)が使用する共有ディレクトリです。 ::: :::tip agents source path agents source のデフォルトは `/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 を初期化します。 ```bash skillshare init -p # インタラクティブ skillshare init -p --targets claude,cursor # 非インタラクティブ skillshare init -p --visible # 可視の skillshare/ ディレクトリを使用 ``` ### 実行される処理 ```mermaid flowchart TD TITLE["skillshare init -p"] S1["1. Create .skillshare/skills + .skillshare/agents"] S2["2. Detect AI CLI directories"] S3["3. Create target skill directories"] S4["4. Write config.yaml"] TITLE --> S1 --> S2 --> S3 --> S4 ``` init 後は、project ディレクトリ(`skills/` と `agents/` の両方)を git にコミットしてください。`--visible` を使うと `.skillshare/` の代わりに `skillshare/` を作成します。完全なガイドは [Project Setup](/docs/how-to/sharing/project-setup) を参照してください。 ## Discover モード 既存のセットアップに対して init を再実行し、新しい AI CLI Target を検出して追加します。 ### グローバル ```bash skillshare init --discover # インタラクティブ選択 skillshare init --discover --select codex,opencode # 非インタラクティブ ``` まだ config にない、新しくインストールされた AI CLI をスキャンし、追加するようプロンプトを表示します。`universal` Target(`~/.agents/skills`)は、いずれかの CLI が検出されると自動的に推奨されます。 ### プロジェクト ```bash skillshare init -p --discover # インタラクティブ選択 skillshare init -p --discover --select antigravity # 非インタラクティブ ``` project ディレクトリをスキャンして新しい AI CLI ディレクトリ(例: `.agents/`)を検出し、Target として追加します。 ### Discover + Mode の動作 `--discover` と `--mode` を組み合わせると、mode はこの discover 実行で追加された Target にのみ適用されます。 config 内の既存 Target は変更されません。 ```bash # cursor を mode=copy で追加、既存の Target は変更しない skillshare init --discover --select cursor --mode copy # project mode の場合(同じルール) skillshare init -p --discover --select cursor --mode copy ``` :::tip すでに初期化済みのセットアップに対して `--discover` なしで `skillshare init` を実行すると、エラーメッセージがそれを使うようヒントを表示します。 ::: ## オプション | フラグ | 説明 | |------|-------------| | `--source, -s ` | カスタム source ディレクトリ(インタラクティブモードでは未設定時にプロンプトを表示) | | `--remote ` | git remote を設定(`--git` を暗黙指定。remote に Skill があれば自動 pull し、組み込み Skill のプロンプトをスキップ) | | `--project, -p` | 現在のディレクトリに project レベルの Skill を初期化 | | `--copy-from, -c ` | 特定の CLI またはパスから Skill をコピー | | `--no-copy` | 空の source から開始(コピーのプロンプトをスキップ) | | `--targets, -t ` | カンマ区切りの Target 名 | | `--all-targets` | 検出されたすべての Target を追加 | | `--no-targets` | Target 選択をスキップ | | `--mode, -m ` | 新たに設定される 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 ` | 追加する Target のカンマ区切りリスト(`--discover` が必要) | | `--config local` | 各開発者が自分の Target を管理できるよう `config.yaml` を gitignore する(project mode のみ)。[Centralized Skills Repo](/docs/how-to/recipes/centralized-skills-repo) レシピを参照。 | | `--visible` | `.skillshare/` の代わりに可視の `skillshare/` project ディレクトリを作成(project mode のみ)。[Project Skills](/docs/understand/project-skills#visible-project-directory) を参照。 | | `--git-root ` | `commit`/`push`/`pull` 操作用のディレクトリ(デフォルト `skills`、他に `agents`、`extras`、`root`)。`root` は skills + agents + extras をまとめて 1 つのリポジトリでバージョン管理し、`config.yaml` は自動的に無視される。セットアップ時にインタラクティブにも指定可能。後から `skillshare init --git-root ` を再実行するとヘッドレスにスコープを切り替えられる — 新しいスコープでリポジトリを init し設定を保持するが、既存の履歴は移動しない。 | | `--subdir ` | source path としてサブディレクトリを使用(例: `skills`) | | `--dry-run, -n` | 変更を加えずにプレビュー | `init` は最初の mode ポリシーを設定します。後からいつでも Target ごとに細かく調整できます。 ```bash 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 を組み込む場合です。 ```bash # インタラクティブ: init 中にプロンプトを表示 skillshare init --remote git@github.com:you/dotfiles.git # 非インタラクティブ: 直接指定 skillshare init --remote git@github.com:you/dotfiles.git --subdir skills ``` ## よくあるシナリオ ### リモートセットアップ(いずれかを選択) インタラクティブ(ガイド付きプロンプトが欲しい初回セットアップに推奨): ```bash skillshare init --remote git@github.com:you/my-skills.git ``` 非インタラクティブ(プロンプトなし、インストール済み Target を自動検出): ```bash skillshare init --remote git@github.com:you/my-skills.git --no-copy --all-targets --no-skill ``` 非インタラクティブ(プロンプトなし、かつ既存の Claude skill を今すぐインポート): ```bash skillshare init --remote git@github.com:you/my-skills.git --copy-from claude --all-targets --no-skill ``` ### 集約された Skill リポジトリ ```bash # 作成者: ローカル config で共有リポジトリをセットアップ skillshare init -p --config local --targets claude # チームメンバー: クローンして共有リポジトリを自動検出 git clone && cd skillshare init -p skillshare target add myproject ~/DEV/myproject/.claude/skills -p ``` ### その他のシナリオ ```bash # 標準セットアップ(すべて自動検出) 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 ```