Files
skillshare/website/docs/reference/commands/status.md
T
Willie 2c3003e04f feat(website): complete website revamp — Diátaxis IA, blog, recipes, quickstarts
Restructure the entire documentation site following the Diátaxis framework
(Learn / How-to / Understand / Reference) with new content across 110 files.

## Information Architecture (M1)
- Move all docs to Diátaxis directory structure (learn/, how-to/, understand/, reference/)
- Add client-redirects plugin for old URL compatibility
- Rewrite sidebar, navbar, and footer to match new IA
- Update all internal cross-references

## Homepage + Quickstarts (M2)
- Add scenario entry cards to homepage with hand-drawn design
- 5 quickstart pages: Claude Code, GitHub Copilot (with copy mode recommendation),
  Codex, Multiple Tools, Dev Containers, Playground

## Blog + Changelog (M3)
- Enable Docusaurus blog plugin with authors.yml
- 5 blog posts: 5-min tutorial, managing 50+ skills, skillshare vs vercel/skills
  comparison, team sharing patterns, write your first skill
- Static /changelog page from CHANGELOG.md

## Recipes + Philosophy (M4)
- 5 recipe pages: CI/CD validation, enterprise skills, project setup,
  cross-machine sync, team onboarding
- 3 philosophy pages: why-local-first, security-first, sync-modes-explained

## Content Polish
- Cross-validate all content against CLI source (19 inaccuracies fixed)
- Lowercase "skillshare" throughout (avoid brand conflict with Skillshare Inc.)
- Add registry.yaml to file structure and Key Paths docs
- Highlight multi-platform git support (GitHub, GitLab, Bitbucket, Gitea,
  Azure DevOps, AtomGit, Codeberg)
- Standardize brew install command
- Add AsciinemaPlayer component (cast recordings pending)
2026-02-26 04:52:29 +08:00

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 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.

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