mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +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)
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
