mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
- Add (project) labels to status, sync, collect, target, and uninstall headers for clear mode distinction (matching list/target list pattern) - Add ui.WithModeLabel() helper for shared functions that run in both modes - Update uninstall confirmation prompt: "from the project?" in project mode - Add "Privacy-first" to README Why section and website homepage - Replace "Unified Source" card with "Privacy-First" card on website - Unify Quick Actions card heights with h-full in DashboardPage - Add frontend rebuild note to Docker sandbox docs
3.7 KiB
3.7 KiB
sidebar_position
| sidebar_position |
|---|
| 3 |
check
Check for available updates to tracked repositories and installed skills without applying changes.
skillshare check # Check all repos and skills
skillshare check --json # Machine-readable output
What It Does
check inspects your source directory and reports update status for:
- Tracked repositories — Fetches from origin, shows how many commits you're behind
- Installed skills (with metadata) — Compares installed version against the remote HEAD
- Local skills — Marks as "local source" (no remote to compare)
Unlike update, check never modifies any files.
Example Output
skillshare check
Tracked Repos
─────────────────────────────────────────
✓ _team-skills up to date
⬇ _shared-rules 3 commits behind
! _design-system has uncommitted changes
Installed Skills (remote)
─────────────────────────────────────────
✓ pdf up to date anthropics/skills
⬇ commit update available anthropics/skills
• local-skill local source
Summary: 1 repo + 1 skill have updates available
Run 'skillshare update <name>' or 'skillshare update --all'
Options
| Flag | Description |
|---|---|
--project, -p |
Check project-level skills (.skillshare/) |
--global, -g |
Check global skills (~/.config/skillshare) |
--json |
Output as JSON (for scripting/CI) |
--help, -h |
Show help |
:::tip Auto-detection
If neither --project nor --global is specified, skillshare auto-detects: if .skillshare/config.yaml exists in the current directory, it defaults to project mode; otherwise global mode.
:::
JSON Output
skillshare check --json
{
"tracked_repos": [
{"name": "_team-skills", "status": "up_to_date", "behind": 0},
{"name": "_shared-rules", "status": "behind", "behind": 3}
],
"skills": [
{"name": "pdf", "source": "anthropics/skills", "version": "a1b2c3d",
"status": "up_to_date", "installed_at": "2024-06-01T10:00:00Z"},
{"name": "commit", "source": "anthropics/skills", "version": "x9y8z7w",
"status": "update_available", "installed_at": "2024-05-15T08:30:00Z"},
{"name": "local-skill", "source": "", "version": "",
"status": "local", "installed_at": "2024-04-20T12:00:00Z"}
]
}
How It Checks
Tracked Repos
- Run
git fetchto get latest refs from origin - Compare local HEAD with
origin/<branch>usinggit rev-list --count - Report number of commits behind
Regular Skills (with metadata)
- Read
.skillshare-meta.jsonfor stored version and repo URL - Run
git ls-remote <repo_url> HEADto get remote HEAD hash - Compare with stored version hash
Local Skills
Skills without metadata or with a local source are shown as "local source" — no remote check is possible.
Project Mode
skillshare check -p # Check project skills
skillshare check -p --json # JSON output for project
Use Cases
Before Updating
Preview what would change before running update:
skillshare check # See what has updates
skillshare update --all # Apply updates
skillshare sync # Distribute changes
CI/CD Pipeline
Check for stale skills in CI:
result=$(skillshare check --json)
# Parse JSON to detect outdated skills