メインコンテンツまでスキップ

collect

ターゲットからソースへ、ローカルの Skill や agent を収集します。

skillshare collect claude           # 特定のターゲットから
skillshare collect --all # すべてのターゲットから
skillshare collect claude --dry-run # プレビュー
skillshare collect agents claude # Skill の代わりに agent を収集

こんなときに使う​

ターゲットディレクトリ内で直接リソースを作成・編集し、それをソース(信頼できる情報源)に取り込みたいときに collect を使います。

  1. 共有のためにソースへ追加する
  2. 他の AI CLI へ sync する
  3. git でバックアップする

例:

  • Skill: ~/.claude/skills/my-skill/
  • Agent: ~/.claude/agents/tutor.md

何が起きるか​

ヒント

.git/ ディレクトリは収集時に自動的に除外されます。Skill リポジトリをターゲットディレクトリに直接 git clone していた場合、Skill のコンテンツのみがコピーされ、リポジトリのメタデータは残されません。

注記

web ダッシュボードの Collect ページは現在 Skill のみに対応しています。collect agents には CLI を使用してください。

オプション​

フラグ説明
--all, -aすべてのターゲットから収集
--force, -fソース内の既存アイテムを上書きし、確認をスキップ
--dry-run, -n変更を加えずにプレビュー
--jsonJSON を出力して確認をスキップ。ソース内の既存アイテムを上書きするには引き続き --force が必要

JSON 出力​

skillshare collect claude --json
{
"pulled": ["new-skill", "another-skill"],
"skipped": [],
"failed": {},
"dry_run": false,
"duration": "0.123s"
}

--dry-run と組み合わせて、変更せずにプレビューできます。

skillshare collect claude --json --dry-run
skillshare collect -p --json
skillshare collect -p agents --json

出力例​

$ skillshare collect claude
Local skills in targets
another-skill claude · ~/.claude/skills/another-skill
new-skill claude · ~/.claude/skills/new-skill
? Collect these skills to source? [y/N] y

✓ another-skill copied to source
✓ new-skill copied to source

✓ Collected 2 skills · 0.1s

Next
skillshare sync link them into every target
skillshare commit save them in git

競合の処理​

アイテムがすでにソースに存在する場合、収集はデフォルトでスキップされます。

$ skillshare collect claude
Local skills in targets
my-skill claude · ~/.claude/skills/my-skill
? Collect these skills to source? [y/N] y

! my-skill already exists in source · use --force to overwrite

! Collected 0 skills, 1 skipped · 0.0s

# To overwrite:
$ skillshare collect claude --force

$ skillshare collect agents claude
Local agents in targets
tutor.md claude · ~/.claude/agents/tutor.md
? Collect these agents to source? [y/N] y

! tutor.md already exists in source · use --force to overwrite

! Collected 0 agents, 1 skipped · 0.0s

ワークフロー​

ターゲット内で Skill を作成した後の典型的なワークフロー:

# 1. Create skill in Claude
# (edit ~/.claude/skills/my-new-skill/SKILL.md)

# 2. Collect to source
skillshare collect claude

# 3. Sync to all other targets
skillshare sync

# 4. Commit to git (optional)
skillshare push -m "Add my-new-skill"

agent の場合は、agent 専用の collect/sync ペアを使用します。

skillshare collect agents claude
skillshare sync agents

関連項目​

  • sync — ソースからターゲットへ sync
  • diff — ローカルのみの Skill を確認
  • push — git remote へ push