/status

sidebar_position: 7

status

skillshare の現在の状態（source、tracked repositories、targets、バージョン）を表示します。

skillshare status

`follow_source_links: true` の場合、利用できない最上位のソースリンクはリンク名付きの警告を表示し、正常なスキルは引き続き一覧に含まれます。`--json` では警告を stderr に出力し、stdout は有効な JSON のままです。

使うタイミング

• 変更を加えた後、すべての targets が sync 済みか確認する
• どの targets に `sync` の実行が必要か確認する
• tracked repos が最新かどうか確認する
• 有効な audit ポリシー（profile、threshold、dedupe mode）を確認する
• CLI や skill の更新を確認する

出力例

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

セクション

Source

skills フォルダとその中の skill 数を表示します。agents フォルダがある場合は、2 行目にフォルダと agent 数を表示します。`.skillignore` が有効な場合は、パターン数と除外された skill 数の行が加わります。

Source と tracked repository の数は論理スキル数です。対応するエージェント別コピーは一つのスキルとして数えます。物理的な数が異なる場合は `2 skills, 4 variants` のように両方を表示します。Target の linked/copied 数は、その target に選択された物理エントリ数のままです。

Tracked Repositories

`--track` でインストールした git リポジトリと、それぞれの skill 数を一覧表示します。`✓` はリポジトリに未コミットの変更がないことを示します。`!` には `uncommitted changes`、または git status を読み取れない場合はそのエラーが付きます。

Targets

各 target を 1 行で表示します：名前、skills フォルダ、skills と agents の状態です。表の下の行には使用中の sync モードが表示されます。

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 列:**

| 表示 | 意味 | |------|------| | `✓ 8 linked` / `✓ 8 copied` | 想定されるすべての skill が配置済みです。merge と copy では `include`/`exclude` で絞り込んだ後の skill を数えます | | `· 2 local` | そのフォルダにある自分の skill です。sync はこれらに触れません | | `! 6/8 linked` | 一部の skill がまだ sync されていません。status の最後に数と `sync` コマンドが表示されます。`sync` が意図的にスキップする skill（`standard` / `prefixed` naming での無効な名前、または名前の衝突）は数えません。`sync` を再実行しても追加できないためで、`sync` がそれらを表示します | | `✓ symlinked` | symlink モード：フォルダ全体が source にリンクしています | | `! needs sync` | モードが変更されました。`sync` を実行して反映します | | `! has files` / `! not synced yet` | この target はまだ一度も sync されていません | | `✗ links to …` / `✗ broken link` | フォルダが別の場所、または存在しない場所へのリンクです | | `skills off` | この target の skills はオフです |

**agents 列:** `✓ 8` はリンク済みの agent 数です（最新のコピーもリンク済みとして数えます）。`! 7/8` は一部が欠けていることを示します。`skillshare sync agents` を実行してください。数えるのはこの target が sync する agent だけで、`.agentignore`、target の agents の include/exclude、各 agent の `targets` frontmatter で残ったものです。copy fallback では、skillshare が所有していない同一内容のローカルファイルは保持され、`· 1 local` として数えられます。`—` はその target に agents フォルダがないことを示します。agents source がない場合、この列は省略されます。

グローバル・プロジェクト両モードで、エージェント別バリアントが存在し、skills target が symlink mode を使う場合、`status` と `doctor` は警告します。ディレクトリ全体へのリンクはすべてのバリアントを公開するためです。エージェント別の自動ルーティングには merge または copy mode を使ってください。

Extras

extras を設定している場合、extra の target ごとに 1 行表示します：

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

各行には extra 名、target フォルダ、ファイル数、そしてファイルが実際に sync されるモードが表示されます：開発者モードが無効な Windows では、ファイルをリンクする target は `copy` と表示されます。

Audit

有効な audit ポリシー（CLI フラグ、project 設定、global 設定から解決）を 1 行で表示します：profile（`default`、`strict`、`permissive`）と、インストールをブロックする最低の重大度（デフォルトは `critical`）です。dedupe モードと analyzer は、デフォルト（`global` とすべての analyzer）と異なる場合のみ表示されます。

Version

CLI と skill のバージョンを表示します。新しい skill がリリースされている場合は、更新方法を示す行が加わります。（global mode のみ）

オプション

| フラグ | 説明 | |------|-------------| | `--json` | JSON として出力（スクリプト/CI 用） | | `--project, -p` | project mode を使用 | | `--global, -g` | global mode を使用 | | `--help, -h` | ヘルプを表示 |

JSON 出力

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,
  "variant_count": 17,
  "tracked_repos": [
    {"name": "_team-skills", "skill_count": 5, "variant_count": 10, "dirty": false},
    {"name": "_personal-repo", "skill_count": 3, "variant_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"
}

`skill_count` は論理スキル数、`variant_count` は物理ソースエントリ数です。トップレベルと各 tracked repository に両方のフィールドを含みます。Target の `synced_count` は物理的な数のままです。

Target の `warning` は、copy 以外の mode での `prefixed` naming などの設定エラーや、symlink mode のエージェントルーティング制限を示します。対処方法も表示します。

git status を読み取れない tracked repo は `"status": "unknown"` となり、`message` にエラーが入ります。この場合 `dirty` は false で、意味を持ちません。

`source.skillignore` フィールドは、少なくとも 1 つの `.skillignore` または `.skillignore.local` ファイルが存在する場合にのみ存在します。存在しない場合: `"skillignore": { "active": false }`。`files` 配列には、存在する場合 `.skillignore.local` の