mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 12:23:22 +00:00
Add documentation for new features (UI theme system, init --subdir), bug fixes (collect .git skip, actionable git errors), and release notes. Update CHANGELOG.md, website changelog, and 6 doc pages.
2.7 KiB
2.7 KiB
sidebar_position
| sidebar_position |
|---|
| 1 |
collect
Collect local skills from targets back to source.
skillshare collect claude # From specific target
skillshare collect --all # From all targets
skillshare collect claude --dry-run # Preview
When to Use
Use collect when you've created or edited skills directly in a target directory (e.g., ~/.claude/skills/) and want to:
- Add them to your source for sharing
- Sync them to other AI CLIs
- Back them up with git
What Happens
flowchart TD
CMD["skillshare collect claude"]
FIND["1. Find local skills in target"]
CONFIRM["2. Confirm collection"]
COPY["3. Copy to source"]
SYMLINK["4. Replace with symlink"]
CMD --> FIND --> CONFIRM --> COPY --> SYMLINK
:::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.
:::
Options
| Flag | Description |
|---|---|
--all, -a |
Collect from all targets |
--force, -f |
Overwrite existing skills in source |
--dry-run, -n |
Preview without making changes |
--json |
Output as JSON (implies --force, skips confirmation) |
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
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 a skill already exists in source:
$ skillshare collect claude
Collecting skills
⚠ my-skill: skipped (already exists in source, use --force to overwrite)
# To overwrite:
$ skillshare collect claude --force
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"