mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 12:23:22 +00:00
Add a third sync mode (`copy`) that copies skills as real files instead of symlinks, with a `.skillshare-manifest.json` tracking managed skills and SHA256 checksums for incremental updates. - Manifest-based tracking: skip unchanged, update modified, --force all - Pruning: remove managed copies no longer in source - Mode conversion: bidirectional merge↔copy and symlink↔copy - Full command support: sync, status, doctor, diff, target, collect - Server API + Web UI: targets list, drift detection, filter editing - include/exclude filters work in both merge and copy modes - 12 integration tests covering all acceptance criteria - Documentation updated across 13 pages Closes #31
3.0 KiB
3.0 KiB
sidebar_position
| sidebar_position |
|---|
| 7 |
status
Show the current state of skillshare: source, tracked repositories, targets, and versions.
skillshare status
When to Use
- Check if all targets are in sync after making changes
- See which targets need a
syncrun - Verify tracked repos are up to date
- Check for CLI or skill updates
Example Output
Source
✓ ~/.config/skillshare/skills (12 skills, 2026-01-20 15:30)
Tracked Repositories
✓ _team-skills 5 skills, up-to-date
! _personal-repo 3 skills, has uncommitted changes
Targets
✓ claude [merge] ~/.claude/skills (8 shared, 2 local)
✓ cursor [merge] ~/.cursor/skills (3 shared, 0 local)
✓ codex [merge] ~/.codex/skills (3 shared, 0 local)
✓ copilot [copy] ~/.copilot/skills (3 managed, 0 local)
! windsurf [merge->needs sync] ~/.windsurf/skills
⚠ 2 skill(s) not synced — run 'skillshare sync'
Version
✓ CLI: 1.2.0
✓ Skill: 1.1.0 (up to date)
Sections
Source
Shows the source directory location, skill count, and last modified time.
Tracked Repositories
Lists git repositories installed with --track. Shows:
- Skill count per repository
- Git status (up-to-date or has changes)
Targets
Shows each configured target with:
- Sync mode:
merge,copy, orsymlink - Path: Target directory location
- Status:
merged,linked,unlinked, orneeds sync - Shared/local counts: In merge and copy modes, counts use that target's expected set (after
include/excludefilters). Copy mode shows "managed" instead of "shared".
If a target is in symlink mode, include/exclude is ignored.
| Status | Meaning |
|---|---|
merged |
Skills are symlinked individually |
copied |
Skills are copied as real files (with manifest) |
linked |
Entire directory is symlinked |
unlinked |
Not yet synced |
needs sync |
Mode changed, run sync to apply |
not synced |
Some expected skills (after filters) are missing — run sync |
Version
Compares your CLI and skill versions against the latest releases.
Project Mode
In a project directory, status shows project-specific information:
skillshare status # Auto-detected if .skillshare/ exists
skillshare status -p # Explicit project mode
Example Output
Project Skills (.skillshare/)
Source
✓ .skillshare/skills (3 skills)
Targets
✓ claude [merge] .claude/skills (3 synced)
✓ cursor [merge] .cursor/skills (3 synced)
Remote Skills
✓ pdf anthropic/skills/pdf
✓ review github.com/team/tools
Project status does not show Tracked Repositories or Version sections (these are global-only features).
See Also
- sync — Sync skills to targets
- diff — Show detailed differences
- doctor — Diagnose issues
- Project Skills — Project mode concepts
