Files
skillshare/website/docs/reference/commands/status.md
T
Willie caa525b8aa 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 22:27:23 +08:00

114 lines
3.0 KiB
Markdown

---
sidebar_position: 7
---
# status
Show the current state of skillshare: source, tracked repositories, targets, and versions.
```bash
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](/img/status-demo.png)
## 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:
```bash
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](/docs/reference/commands/sync) — Sync skills to targets
- [diff](/docs/reference/commands/diff) — Show detailed differences
- [doctor](/docs/reference/commands/doctor) — Diagnose issues
- [Project Skills](/docs/understand/project-skills) — Project mode concepts