Files
skillshare/website/docs/reference/commands/collect.md
T
Willie e818a29cad fix(collect): preserve overwrite guard in JSON mode
--json implied --force, silently overwriting existing skills/agents
in source when collecting. Decouple confirmation-skip from the
overwrite guard, same fix as PR #243 for uninstall.
2026-07-15 09:42:47 +08:00

3.3 KiB
Raw Blame History

sidebar_position
sidebar_position
1

collect

Collect local skills or agents from targets back to source.

skillshare collect claude           # From specific target
skillshare collect --all            # From all targets
skillshare collect claude --dry-run # Preview
skillshare collect agents claude    # Collect agents instead of skills

When to Use

Use collect when you've created or edited resources directly in a target directory and want to pull them back into the source of truth:

  1. Add them to your source for sharing
  2. Sync them to other AI CLIs
  3. Back them up with git

Examples:

  • Skills: ~/.claude/skills/my-skill/
  • Agents: ~/.claude/agents/tutor.md

What Happens

flowchart TD
    CMD["skillshare collect claude"]
    FIND["1. Find local items in target"]
    CONFIRM["2. Confirm collection"]
    COPY["3. Copy to source"]
    CMD --> FIND --> CONFIRM --> COPY

:::tip .git/ directories are automatically excluded during collection. If you've git-cloned a skill repo directly into a target directory, only the skill content is copied — repository metadata stays behind. :::

:::note The web dashboard's Collect page is currently skills-only. Use the CLI for collect agents. :::

Options

Flag Description
--all, -a Collect from all targets
--force, -f Overwrite existing items in source and skip confirmation
--dry-run, -n Preview without making changes
--json Output JSON and skip confirmation; existing items in source still require --force to overwrite

JSON Output

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

Combine with --dry-run to preview without changes:

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

Example Output

$ 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

Handling Conflicts

If an item already exists in source, collection skips it by default:

$ 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)

Workflow

Typical workflow after creating a skill in a target:

# 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"

For agents, use the agent-specific collect/sync pair:

skillshare collect agents claude
skillshare sync agents

See Also

  • sync — Sync from source to targets
  • diff — See local-only skills
  • push — Push to git remote