/init

sidebar_position: 1

init

初回セットアップ。インストール済みの AI CLI を検出し、すでにある Skill を取り込んで同期します。

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

使うタイミング

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

実行される処理

`init` は先に質問し、書き込みは最後に行います。サマリーを確認するまで何も作成されません。どの質問でも <kbd>Esc</kbd> を押すと、何も書き込まずにキャンセルします。

flowchart TD
    TITLE["skillshare init"]
    START{"How do you want to start?"}
    NEW["New setup: tools → import → git → remote (optional)"]
    CONNECT["Connect my existing repo: URL → keep local skills → tools"]
    SUMMARY["Summary: Yes / Change settings / Cancel"]
    APPLY["Write config, copy skills, install built-in skill, commit"]
    SYNC["Sync now?"]
    TITLE --> START
    START --> NEW --> SUMMARY
    START --> CONNECT --> SUMMARY
    SUMMARY --> APPLY --> SYNC

各質問にはデフォルトがあり、すべて <kbd>Enter</kbd> で進めるだけで使えるセットアップになります：

| 質問 | デフォルト | |------|------------| | Targets | 検出されたすべての AI CLI | | Import | それらのツールにある既存の Skill すべて | | Git | オン。Skill のみをバージョン管理。remote を設定した場合は skills、agents、extras。Plugins、MCP servers、hooks は各マシンの `config.yaml` に残ります | | 組み込み Skill | インストール | | Sync | はい |

サマリーの **Change settings** で、source パス、sync mode、git でバージョン管理する範囲を変更できます。

**Connect my existing repo** は 2 台目のマシン向けです。何も書き込まずに先にリポジトリを確認し、構成を判断します。`--git-root root` で push したリポジトリは skillshare フォルダ全体になり、Skill が `skills/` フォルダにあるリポジトリはそのフォルダを source にします。このマシンとリポジトリの両方にある同名の Skill はリポジトリ版を使います。このマシンにしかない Skill は残すかどうかを尋ね、次の `skillshare push` でリポジトリに追加されます。

初回の sync では、source とバイト単位で同一のツール側 Skill フォルダはリンクに置き換えられます。内容が異なるフォルダは残して一覧表示します。`skillshare sync --force` で置き換えられます。

ターミナルがない場合

stdin または stdout がターミナルでない場合（CI、スクリプト、AI エージェント）、`init` は何も尋ねず上記のデフォルトを使います。決定ごとに 1 行ずつ、変更に使う flag と一緒に表示します：

✓ Source   ~/.config/skillshare/skills (--source, --subdir)
✓ Targets  claude, cursor, universal (--targets, --no-targets)
✓ Import   all 2 (--copy-from, --no-copy)
✓ Git      skills only (--no-git, --git-root)
✓ Remote   none (--remote <url>)
✓ Skill    install skillshare (--skill, --no-skill)
✓ Sync     merge (--mode)

`--remote` を指定すると、Skill があるリポジトリは pull され、同名の Skill はリポジトリ版を使い、その名前を表示します。ターミナルがないときの出力には色やエスケープコードが含まれません。

`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 のデフォルトは `<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/ ディレクトリを使用

実行される処理

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 を検出して追加します。

グローバル

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

config にまだない新しくインストールされた AI CLI をスキャンし、追加するものを尋ねます（すべて選択済み）。ターミナルがない場合は新しいツールをすべて追加します。CLI が検出されると、`universal` Target（`~/.agents/skills`）が自動的に推奨されます。

プロジェクト

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

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

オプション

| フラグ | 説明 | |------|-------------| | `--source, -s <path>` | カスタム source ディレクトリ（サマリーの **Change settings** でも変更可能） | | `--remote <url>` | git remote を設定（`--git` を暗黙指定）。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` を gitigno