Sets up Docusaurus i18n for Traditional Chinese, Simplified Chinese,
Japanese, and Korean: locale config, navbar/footer/sidebar UI chrome,
and translated content for intro, getting-started, understand, and
reference/commands. Untranslated pages fall back to English.
Pins explicit heading anchors ({#id}) on English source pages that are
linked to by fragment, so translated headings don't change the anchor
id and break cross-page links. Converts a handful of relative .md
links that crossed from an untranslated page into a now-translated
one, since Docusaurus resolves those per-locale and they'd otherwise
404 outside English.
11 KiB
sidebar_position
| sidebar_position |
|---|
| 1 |
init
初回セットアップ。インストール済みの AI CLI を自動検出し、Target を設定します。
skillshare init # インタラクティブセットアップ
skillshare init --dry-run # 変更を加えずにプレビュー
使うタイミング
- マシンで初めて skillshare をセットアップするとき
- 新しいコンピュータへの移行時(既存リポジトリに接続する
--remote付き) - project に skillshare を追加するとき(
--project付き) - 新しくインストールされた AI CLI を発見するとき(
--discover付き)
実行される処理
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 を参照してください。
:::info universal Target
いずれかの AI CLI が検出されると、init は自動的に universal Target(~/.agents/skills)を推奨します。これは、互換性のあるすべての agent に一括で Skill を提供するために 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 を参照してください。
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
:::tip
すでに初期化済みのセットアップに対して --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 git@github.com:you/dotfiles.git
# 非インタラクティブ: 直接指定
skillshare init --remote git@github.com:you/dotfiles.git --subdir skills
よくあるシナリオ
リモートセットアップ(いずれかを選択)
インタラクティブ(ガイド付きプロンプトが欲しい初回セットアップに推奨):
skillshare init --remote git@github.com:you/my-skills.git
非インタラクティブ(プロンプトなし、インストール済み Target を自動検出):
skillshare init --remote git@github.com:you/my-skills.git --no-copy --all-targets --no-skill
非インタラクティブ(プロンプトなし、かつ既存の Claude skill を今すぐインポート):
skillshare init --remote git@github.com: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