Files
skillshare/website/docs/reference/commands/status.md
T
Willie c5c9289781 fix(discovery): surface skipped source link warnings
Keep one follow policy per list and status operation and report its skipped links without hiding healthy inventory. Send JSON diagnostics to stderr and expose sourceLinkWarnings in the dashboard resources response, reusing the sync warning formatter.
2026-10-05 18:26:12 +08:00

7.3 KiB

sidebar_position
sidebar_position
7

status

Show the current state of skillshare: source, tracked repositories, targets, and versions.

skillshare status

With follow_source_links: true, unavailable first-level source links produce a warning naming the link while healthy skills remain listed. With --json, these warnings go to stderr and stdout remains valid JSON.

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
  skills    ~/.config/skillshare/skills  43 skills
  agents    ~/.config/skillshare/agents  2 agents

Tracked repositories
✓ _superpowers  15 skills

Targets                        skills                 agents
  claude     ~/.claude/skills  ✓ 43 linked            ✓ 2
  cursor     ~/.cursor/skills  ✓ 43 linked · 1 local  ✓ 2
  gemini     ~/.gemini/skills  ✓ 43 linked            —
  universal  ~/.agents/skills  ✓ 43 linked            —
  all use merge

Extras
  rules     ~/.claude/rules     2 files · merge
  rules     ~/.cursor/rules     2 files · merge
  commands  ~/.claude/commands  1 file · merge
  team      ~/.codex            1 file · symlink
  team      ~/.claude           1 file · import

Audit    default · blocks critical
Version  CLI 0.24.0 · skill 0.21.12
! Skill 0.21.13 is available — run skillshare upgrade --skill && skillshare sync

Sections

Source

Shows the skills folder and how many skills it holds. When an agents folder exists, it is shown on a second line with its agent count. An active .skillignore adds a line with its pattern and ignored-skill counts.

Tracked Repositories

Lists git repositories installed with --track, each with its skill count. ✓ means the repository is clean; ! adds uncommitted changes, or the git error when its status cannot be read.

Targets

Each target is one row: its name, its skills folder, and how its skills and agents stand. A line under the table names the sync modes in use.

Targets                     skills                agents
  claude  ~/.claude/skills  ✓ 8 linked · 2 local  ✓ 8
  cursor  ~/.cursor/skills  ! 6/8 copied          ! 7/8
  copy: cursor · merge: claude
! 2 skills not synced — run skillshare sync

skills column:

Shows Meaning
✓ 8 linked / ✓ 8 copied Every expected skill is in place. Merge and copy targets count the skills left after include/exclude
· 2 local Skills of your own in that folder, which sync leaves alone
! 6/8 linked Some skills are not synced yet; status ends with how many and the sync command
✓ symlinked Symlink mode: the whole folder links to the source
! needs sync The mode changed; run sync to apply it
! has files / ! not synced yet The target has never been synced
✗ links to … / ✗ broken link The folder is a link to somewhere else, or to nothing
skills off Skills are turned off for this target

agents column: ✓ 8 is the number of linked agents (up-to-date copies count as linked). ! 7/8 means some are missing; run skillshare sync agents. Only the agents this target syncs count: those left after .agentignore, the target's agents include/exclude and each agent's targets frontmatter. In copy fallback, identical local files that skillshare does not own are kept and counted as · 1 local. — means the target has no agents folder. The column is left out when there is no agents source.

Extras

When extras are configured, each extra target gets a row:

Extras
  rules     .cursor/rules     4 files · merge
  commands  .claude/commands  3 files · merge

Each row shows the extra, its target folder, the file count, and the mode files are synced with: on Windows without Developer Mode, a target that links files shows copy.

Audit

One line with the active audit policy (from CLI flags, project config, or global config): the profile (default, strict or permissive) and the lowest severity that blocks an install (critical by default). The dedupe mode and the analyzers are named only when they differ from the defaults (global and all analyzers).

Version

Shows the CLI and skill versions. When a newer skill is released, a line says how to update it. (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

skillshare status --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 .skillignore 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 the project's source, targets and extras, with paths relative to the project root:

skillshare status        # Auto-detected if .skillshare/ exists
skillshare status -p     # Explicit project mode

Example Output

Source
  skills    .skillshare/skills  3 skills
  agents    .skillshare/agents  4 agents
  .skillignore: 3 patterns, 0 skills ignored

Targets                   skills      agents
  claude  .claude/skills  ✓ 3 linked  ✓ 4
  cursor  .cursor/skills  ✓ 3 linked  ✓ 4
  all use merge

Extras
  rules     .cursor/rules     4 files · merge
  commands  .claude/commands  3 files · merge

Audit    default · blocks critical

Project status does not show Tracked Repositories or Version sections (these are global-only features).

See Also