Skip to main content

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 sync run
  • Verify tracked repos are up to date
  • Check for CLI or skill updates

status demo

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, or symlink
  • Path: Target directory location
  • Status: merged, linked, unlinked, or needs sync
  • Shared/local counts: In merge and copy modes, counts use that target's expected set (after include/exclude filters). Copy mode shows "managed" instead of "shared".

If a target is in symlink mode, include/exclude is ignored.

StatusMeaning
mergedSkills are symlinked individually
copiedSkills are copied as real files (with manifest)
linkedEntire directory is symlinked
unlinkedNot yet synced
needs syncMode changed, run sync to apply
not syncedSome 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​