Files
skillshare/website/i18n/ja/docusaurus-plugin-content-docs/current/getting-started/first-sync.md
T
Willie 49a52498e9 docs: add current screenshots and diagrams to the guides
The dashboard screenshots predated the Projects page and showed codex at
its old path, and the guides for dashboard-only features (AGENTS.md
sharing, MCP, plugins, backups, hubs) had no pictures at all.

- Re-shoot the dashboard screenshots (docs and README copies) and add
  ones for targets, extras, shared AGENTS.md, MCP, project MCP, plugins,
  backups, hubs and project mode.
- Add diagrams for sharing AGENTS.md, MCP sync and migrating with
  collect; fix codex's path in the getting-started diagram.
- Replace terminal screenshots with real output as text, and remove
  images nothing referenced.
- Fix text that no longer matched the dashboard (project mode, hub
  navigation, backup list output).
2026-09-28 21:02:12 +08:00

8.7 KiB
Raw Blame History

sidebar_position
sidebar_position
2

初回の Sync

初回セットアップの全手順を順番に説明します。インストールから Sync が動くまでおよそ 5 分です。別マシンでの復元と、ヘッドレス環境での無人実行という 2 つのバリエーションは、このページの最後にまとめています。

前提条件

  • macOS、Linux、または Windows
  • AI CLI が 1 つ以上インストールされていること(Claude Code、Cursor、Codex など)

1. CLI をインストールする

Homebrew(macOS / Linux):

brew install skillshare

:::note Homebrew のリリースは数日遅れることがあります。最新版が必要な場合はインストールスクリプトを使ってください。 :::

インストールスクリプト(macOS / Linux):

curl -fsSL https://raw.githubusercontent.com/runkids/skillshare/main/install.sh | sh

Windows(PowerShell):

irm https://raw.githubusercontent.com/runkids/skillshare/main/install.ps1 | iex

:::tip あとから更新する skillshare upgrade はインストール方法(Homebrew、スクリプト、手動)を判別し、その場で CLI を更新します。 :::

2. 初期化する

skillshare init

Interactive init flow

init では 4 つの選択を順に行います:

  1. Source ディレクトリ — 既定値は ~/.config/skillshare/skills/ です。Enter を押せばそのまま使えます。
  2. Git リモート — 個人の Skill リポジトリの URL を貼り付けます(例: git@github.com:you/skills.git)。まだ無い場合は、先に GitHub で空のリポジトリを作ってください。スキップして後からリモートを追加することもできます。
  3. Target — skillshare がインストール済みの AI CLI を検出して一覧表示します。確認するか、不要なものの選択を外してください。
  4. Built-in skill — 任意です。/skillshare コマンドを追加し、AI CLI から skillshare を直接呼び出せるようになります。

Sync モードを選ぶ

init は --mode <merge|copy|symlink> を受け付け、新しく追加される Target の既定モードを設定します:

  • merge(既定)— Skill ごとの symlink。Target 側に元からあるローカルの Skill は保持されます
  • symlink — Target ディレクトリ全体が 1 つの symlink になります(最速ですが、ディレクトリを置き換えます)
  • copy — 実ファイル。変更は次回の sync で反映されます

Target ごとの上書き設定は、後から skillshare target <name> --mode <mode> で行えます。

3. Skill をインストールする

skillshare install anthropics/skills/skills/pdf

インストールのたびにセキュリティ監査が実行されます。Critical の検出があるとインストールはブロックされます。内容を確認しリスクを受け入れる場合にのみ --force を指定してください。

4. Sync する

skillshare sync

これで設定済みのすべての Target が Source を指すようになりました。

5. 確認する

skillshare status
$ skillshare status

Source
─────────────────────────────────────────
✓ ~/.config/skillshare/skills (43 skills, 2026-09-28 12:39)
✓ ~/.config/skillshare/agents (2 agents, 2026-09-28 12:39)

Targets
─────────────────────────────────────────
claude
  skills   merged       [merge] ~/.claude/skills (43 shared, 0 local)
  agents   merged       [merge] 2/2 linked
cursor
  skills   merged       [merge] ~/.cursor/skills (43 shared, 0 local)
  agents   merged       [merge] 2/2 linked
gemini
  skills   merged       [merge] ~/.gemini/skills (43 shared, 0 local)
…

出力には Source のパスとすべての Target が並びます。merge モードで同期済みの Target は merged と表示され、shared の数にはいまインストールした Skill も含まれます。

ダッシュボード(skillshare ui)でも同じ状態をひと目で確認できます。

初回同期後の Dashboard:1 つの Source がすべての Target につながり、すべて同期済み


いま何が起きたのか

  1. init が ~/.config/skillshare/config.yaml と ~/.config/skillshare/skills/ を作成し、AI CLI を自動検出し、リモートを指定していた場合はそこにあった既存の Skill をクローンしました。
  2. install が Skill を Source ディレクトリにクローンし、セキュリティ監査を実行しました。.metadata.json に upstream の URL とコミットが記録され、skillshare update で今後の変更を取得できます。
  3. sync が各 Target に設定されたモードを適用しました。たとえば merge モードでは:
    ~/.claude/skills/pdf → ~/.config/skillshare/skills/pdf  (symlink)
    

merge と symlink モードでは、Source への編集がすべての Target に即座に現れます。copy モードでは次回の sync で反映されます。Target 側に元からあるローカルの Skill は merge と copy では保持されます。skillshare backup は破壊的な操作の前にスナップショットを取り、skillshare restore <target> で元に戻せます。

特定の Target だけ別のモードにしたい場合は、Target ごとに上書きします:

skillshare target <name> --mode copy
skillshare sync

判断の早見表は Sync Modes を参照してください。


バリエーション: 別マシンでの復元

すでに他の環境で skillshare を使っていて、GitHub に個人の Skill リポジトリがある場合です。新しいノート PC、devcontainer、VM では 4 つのコマンドですべてが復元できます。プロンプトも選択もなく、再実行しても冪等です:

# 1. CLI をインストール(Homebrew または curl|sh — 上のステップ 1 と同じ)
brew install skillshare

# 2. Skill リポジトリをクローンし、検出された Target を追加
skillshare init \
  --remote git@github.com:<you>/skills.git \
  --all-targets \
  --no-skill

# 3. tracked な依存を再インストール
#    (_ 始まりのディレクトリは gitignore されているため、クローンには含まれません)
skillshare install https://github.com/<your-company>/skills --track --force

# 4. Sync
skillshare sync

--no-skill は Built-in skill のプロンプトをスキップします。このマシンでも使いたくなったら、あとから skillshare upgrade --skill で追加できます。


バリエーション: ヘッドレスセットアップ(TTY なし)

CI ジョブ、devcontainer の post-create フック、クラウド VM のプロビジョナー向けに、すべてのプロンプトには非対話用のフラグが用意されています:

skillshare init \
  --source ~/.config/skillshare/skills \
  --remote https://github.com/<you>/skills \
  --targets codex \
  --mode merge \
  --no-copy \
  --no-skill

skillshare install https://github.com/<your-company>/skills --track --force
skillshare sync
フラグ 効果
--source <path> Source パスのプロンプトをスキップ
--remote <url> リモートのプロンプトをスキップ。リモートに内容があればクローン
--targets <name> 指定した Target のみ追加(検出されたすべてを追加するには --all-targets)
--mode merge 新しい Target の既定 Sync モード
--no-copy 「既存の Target の Skill をコピーしますか?」のプロンプトをスキップし、空の状態で開始
--no-skill Built-in skill のプロンプトをスキップ

--targets、--all-targets、--no-targets は排他的です。いずれか 1 つを選んでください。


次のステップ