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

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 found
ℹ new-skill [claude] ~/.claude/skills/new-skill
ℹ another-skill [claude] ~/.claude/skills/another-skill

Collect these skills to source? [y/N]: y

Collecting skills
✓ new-skill: copied to source
✓ another-skill: copied to source

Run 'skillshare sync' to distribute to all targets

競合の処理

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

$ skillshare collect claude

Collecting skills
⚠ my-skill: skipped (already exists in source, use --force to overwrite)

# To overwrite:
$ skillshare collect claude --force

$ skillshare collect agents claude

Collecting agents
⚠ tutor.md: skipped (already exists in source, use --force to overwrite)

ワークフロー

ターゲット内で 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