mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-20 20:34:19 +00:00
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)
114 lines
3.0 KiB
Markdown
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
|
|
|
|

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