mirror of
https://github.com/runkids/skillshare.git
synced 2026-11-19 02:17:09 +00:00
status and list discarded the error from the uncommitted-changes check, so a tracked repo whose git status could not be read was shown as up-to-date. They now show it as unknown with a warning naming the repo and error; status --json sets the existing status and message fields. The commands still succeed, since they only report.
250 lines
8.1 KiB
Markdown
250 lines
8.1 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
|
|
- Verify the active audit policy (profile, threshold, dedupe mode)
|
|
- Check for CLI or skill updates
|
|
|
|
## Example Output
|
|
|
|
```
|
|
Source
|
|
─────────────────────────────────────────
|
|
✓ ~/.config/skillshare/skills (43 skills, 2026-09-28 12:52)
|
|
✓ ~/.config/skillshare/agents (2 agents, 2026-09-28 12:39)
|
|
|
|
Tracked Repositories
|
|
─────────────────────────────────────────
|
|
_superpowers ✓ 15 skills, up-to-date
|
|
|
|
Targets
|
|
─────────────────────────────────────────
|
|
claude
|
|
skills merged [merge] ~/.claude/skills (43 shared, 0 local)
|
|
agents merged [merge] 2/2 linked
|
|
cursor
|
|
skills merged [merge] ~/.cursor/skills (43 shared, 1 local)
|
|
agents merged [merge] 2/2 linked
|
|
gemini
|
|
skills merged [merge] ~/.gemini/skills (43 shared, 0 local)
|
|
…
|
|
universal
|
|
skills merged [merge] ~/.agents/skills (43 shared, 0 local)
|
|
|
|
Extras
|
|
─────────────────────────────────────────
|
|
rules has files [merge] ~/.claude/rules (2 files)
|
|
rules has files [merge] ~/.cursor/rules (2 files)
|
|
commands has files [merge] ~/.claude/commands (1 files)
|
|
team has files [symlink] ~/.codex (1 files)
|
|
team has files [import] ~/.claude (1 files)
|
|
…
|
|
|
|
Audit
|
|
─────────────────────────────────────────
|
|
→ Profile: DEFAULT
|
|
→ Block: severity >= CRITICAL
|
|
→ Dedupe: GLOBAL
|
|
→ Analyzers: ALL
|
|
|
|
Version
|
|
─────────────────────────────────────────
|
|
! Skill: 0.21.12 (update available: 0.21.13)
|
|
→ Run: skillshare upgrade --skill && skillshare sync
|
|
```
|
|
|
|
## Sections
|
|
|
|
### Source
|
|
|
|
Shows the source directory location, skill count, and last modified time. When agents are configured, the agents source is shown on a separate line.
|
|
|
|
### Tracked Repositories
|
|
|
|
Lists git repositories installed with `--track`. Shows:
|
|
- Skill count per repository
|
|
- Git status (up-to-date, has changes, or unknown when git status cannot be read; a warning names the repo and error)
|
|
|
|
### Targets
|
|
|
|
Each target is shown as a header with sub-items for **skills** and **agents**:
|
|
|
|
```
|
|
claude
|
|
skills merged [merge] ~/.claude/skills (8 shared, 2 local)
|
|
agents merged [merge] 8/8 linked
|
|
```
|
|
|
|
**Skills sub-item** shows:
|
|
- **Sync mode**: `merge`, `copy`, or `symlink`
|
|
- **Path**: Target directory location
|
|
- **Status**: `merged`, `copied`, `linked`, `has files`, 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".
|
|
|
|
**Agents sub-item** shows:
|
|
- **Sync mode**: the mode agents actually sync with. On Windows without Developer Mode, `merge` shows as `[copy]` because agent files are copied instead of linked
|
|
- **Status**: `merged`, `copied`, `linked`, or `drift`
|
|
- **Linked count**: e.g. `8/8 linked` (up-to-date copies count as linked). In copy fallback, identical local files that skillshare does not own are kept and shown separately, e.g. `0/1 linked, 1 local preserved`
|
|
|
|
If agents source does not exist or the target has no agent path configured, the agents sub-item is omitted.
|
|
|
|
| Status | Meaning |
|
|
|--------|---------|
|
|
| `merged` | Skills/agents are symlinked individually |
|
|
| `copied` | Skills are copied as real files (with manifest) |
|
|
| `linked` | Entire directory is symlinked |
|
|
| `has files` | Not yet synced |
|
|
| `needs sync` | Mode changed, run `sync` to apply |
|
|
| `drift` | Some agents are missing — run `sync agents` |
|
|
|
|
### Extras
|
|
|
|
When extras are configured, shows each extra's sync status:
|
|
|
|
```
|
|
Extras
|
|
rules has files [merge] .cursor/rules (4 files)
|
|
commands has files [merge] .claude/commands (3 files)
|
|
```
|
|
|
|
Each entry shows the name, status, sync mode, target path, and file count. The sync mode is the one files are actually synced with: on Windows without Developer Mode, a target that links files shows `[copy]`.
|
|
|
|
### Audit
|
|
|
|
Shows the active audit policy configuration (resolved from CLI flags, project config, or global config):
|
|
|
|
- **Profile**: `DEFAULT`, `STRICT`, or `PERMISSIVE`
|
|
- **Block**: severity threshold for blocking (`CRITICAL` by default)
|
|
- **Dedupe**: deduplication mode (`GLOBAL` or `LEGACY`)
|
|
- **Analyzers**: enabled analyzers (`ALL` or a filtered list)
|
|
|
|
### Version
|
|
|
|
Compares your CLI and skill versions against the latest releases. (Global mode only.)
|
|
|
|
## Options
|
|
|
|
| Flag | Description |
|
|
|------|-------------|
|
|
| `--json` | Output as JSON (for scripting/CI) |
|
|
| `--project, -p` | Use project mode |
|
|
| `--global, -g` | Use global mode |
|
|
| `--help, -h` | Show help |
|
|
|
|
## JSON Output
|
|
|
|
```bash
|
|
skillshare status --json
|
|
```
|
|
|
|
```json
|
|
{
|
|
"source": {
|
|
"path": "~/.config/skillshare/skills",
|
|
"exists": true,
|
|
"skillignore": {
|
|
"active": true,
|
|
"files": [".skillignore", "_team-skills/.skillignore"],
|
|
"patterns": ["test-*", "vendor/"],
|
|
"ignored_count": 2,
|
|
"ignored_skills": ["test-draft", "vendor/lib"]
|
|
}
|
|
},
|
|
"skill_count": 12,
|
|
"tracked_repos": [
|
|
{"name": "_team-skills", "skill_count": 5, "dirty": false},
|
|
{"name": "_personal-repo", "skill_count": 3, "dirty": true}
|
|
],
|
|
"targets": [
|
|
{
|
|
"name": "claude",
|
|
"path": "~/.claude/skills",
|
|
"mode": "merge",
|
|
"status": "merged",
|
|
"synced_count": 8,
|
|
"include": [],
|
|
"exclude": []
|
|
}
|
|
],
|
|
"agents": {
|
|
"source": "~/.config/skillshare/agents",
|
|
"exists": true,
|
|
"count": 8,
|
|
"targets": [
|
|
{"name": "claude", "path": "~/.claude/agents", "expected": 8, "linked": 8, "drift": false}
|
|
]
|
|
},
|
|
"audit": {
|
|
"profile": "DEFAULT",
|
|
"threshold": "CRITICAL",
|
|
"dedupe": "GLOBAL",
|
|
"analyzers": []
|
|
},
|
|
"version": "0.17.0"
|
|
}
|
|
```
|
|
|
|
A tracked repo whose git status cannot be read has `"status": "unknown"` and `message` holding the error; `dirty` is then false and not meaningful.
|
|
|
|
The `source.skillignore` field is present only when at least one `.skillignore` or `.skillignore.local` file exists. When absent: `"skillignore": { "active": false }`. The `files` array includes `.skillignore.local` paths when present. In text mode, the source line shows `.local active` when any `.skillignore.local` is in effect.
|
|
|
|
JSON output is supported in both global and project mode.
|
|
|
|
## Project Mode
|
|
|
|
In a project directory, status shows project-specific information. The first section header shows `Source (project)` to indicate project mode:
|
|
|
|
```bash
|
|
skillshare status # Auto-detected if .skillshare/ exists
|
|
skillshare status -p # Explicit project mode
|
|
```
|
|
|
|
### Example Output
|
|
|
|
```
|
|
Source (project)
|
|
✓ .skillshare/skills/ (3 skills, 2026-04-08 12:43)
|
|
→ .skillignore: 3 patterns, 0 skills ignored
|
|
✓ .skillshare/agents/ (4 agents, 2026-04-08 12:43)
|
|
|
|
Targets
|
|
claude
|
|
skills merged [merge] .claude/skills (3 shared, 0 local)
|
|
agents merged [merge] 4/4 linked
|
|
cursor
|
|
skills merged [merge] .cursor/skills (3 shared, 0 local)
|
|
agents merged [merge] 4/4 linked
|
|
|
|
Extras
|
|
rules has files [merge] .cursor/rules (4 files)
|
|
commands has files [merge] .claude/commands (3 files)
|
|
|
|
Audit
|
|
→ Profile: DEFAULT
|
|
→ Block: severity >= CRITICAL
|
|
→ Dedupe: GLOBAL
|
|
→ Analyzers: ALL
|
|
```
|
|
|
|
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
|