mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
--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.
148 lines
3.3 KiB
Markdown
148 lines
3.3 KiB
Markdown
---
|
||
sidebar_position: 1
|
||
---
|
||
|
||
# collect
|
||
|
||
Collect local skills or agents from targets back to source.
|
||
|
||
```bash
|
||
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
|
||
|
||
```mermaid
|
||
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
|
||
|
||
```bash
|
||
skillshare collect claude --json
|
||
```
|
||
|
||
```json
|
||
{
|
||
"pulled": ["new-skill", "another-skill"],
|
||
"skipped": [],
|
||
"failed": {},
|
||
"dry_run": false,
|
||
"duration": "0.123s"
|
||
}
|
||
```
|
||
|
||
Combine with `--dry-run` to preview without changes:
|
||
|
||
```bash
|
||
skillshare collect claude --json --dry-run
|
||
skillshare collect -p --json
|
||
skillshare collect -p agents --json
|
||
```
|
||
|
||
## Example Output
|
||
|
||
```bash
|
||
$ 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:
|
||
|
||
```bash
|
||
$ 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:
|
||
|
||
```bash
|
||
# 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:
|
||
|
||
```bash
|
||
skillshare collect agents claude
|
||
skillshare sync agents
|
||
```
|
||
|
||
## See Also
|
||
|
||
- [sync](/docs/reference/commands/sync) — Sync from source to targets
|
||
- [diff](/docs/reference/commands/diff) — See local-only skills
|
||
- [push](/docs/reference/commands/push) — Push to git remote
|