check
変更を適用せずに、トラッキング対象のリポジトリとインストール済み Skill の更新有無を確認します。
skillshare check # すべてのリポジトリと Skill を確認
skillshare check my-skill # 単一の Skill を確認
skillshare check a b c # 複数の Skill を確認
skillshare check --group frontend # frontend/ 配下のすべての Skill を確認
skillshare check x -G backend # 名前とグループを混在させる
skillshare check --json # 機械可読な出力
使うタイミング
更新前に
update を実行する前に、何が変わるかをプレビューする。
skillshare check # 更新があるものを確認
skillshare update --all # 更新を適用
skillshare sync # 変更を配布
CI/CD パイプライン
CI 内で古くなった Skill を確認する。
result=$(skillshare check --json)
# JSON をパースして古い Skill を検出する
実行内容
check は Source ディレクトリを調べ、以下について更新状況を報告します。
- トラッキング対象のリポジトリ — origin から fetch し、何コミット遅れているかを表示
- メタデータ付きのインストール済み Skill — インストール済みのバージョンをリモートの HEAD と比較
- Stale な Skill — アップストリームリポジトリからサブディレクトリが削除された Skill を検出
- ローカルの Skill — 「local source」としてマーク（比較対象のリモートがない）
- Skill レベルの
targets検証 — SKILL.md のtargetsフロントマターフィールドにある未知の Target 名について警告
update とは異なり、check はファイルを一切変更しません。
出力例
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
⚠ old-helper stale (deleted upstream)
• local-skill local source
⚠ 1 skill(s) stale (deleted upstream) — run 'skillshare update --all --prune' to remove
Summary: 1 repo + 1 skill have updates available
Run 'skillshare update <name>' or 'skillshare update --all'
特定の Skill を確認する
すべてをスキャンする代わりに、名前を指定して 1 つ以上の Skill を確認できます。
skillshare check my-skill # 単一の Skill
skillshare check skill-a skill-b # 複数の Skill
グループディレクトリ内の更新可能な Skill をすべて確認するには --group / -G を使います。
skillshare check --group frontend # frontend/ 配下のすべての Skill
skillshare check -G frontend -G backend # 複数のグループ
skillshare check my-skill -G frontend # 名前とグループを混在させる
位置引数がリポジトリや Skill そのものではなくグループディレクトリに一致する場合、自動的に展開されます。
skillshare check frontend # グループとして自動検出
メタデータのない Skill（ローカルのみ）は、グループ展開時にスキップされます。
オプション
| フラグ | 説明 |
|---|---|
--group, -G <name> | グループ内の更新可能な Skill をすべて確認（繰り返し指定可） |
--project, -p | Project レベルの Skill（.skillshare/）を確認 |
--global, -g | グローバルの Skill（~/.config/skillshare）を確認 |
--json | JSON として出力（スクリプト/CI 向け） |
--help, -h | ヘルプを表示 |
--project も --global も指定しない場合、skillshare は自動検出します。カレントディレクトリに .skillshare/config.yaml が存在すれば Project mode、それ以外はグローバルモードになります。
JSON 出力
skillshare check --json
{
"tracked_repos": [
{"name": "_team-skills", "status": "up_to_date", "behind": 0, "branch": "main"},
{"name": "_shared-rules", "status": "behind", "behind": 3, "branch": "develop"}
],
"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": "old-helper", "source": "anthropics/skills", "version": "d4e5f6g",
"status": "stale", "installed_at": "2024-03-10T09:00:00Z"},
{"name": "local-skill", "source": "", "version": "",
"status": "local", "installed_at": "2024-04-20T12:00:00Z"}
]
}
ステータス表示
| アイコン | 意味 |
|---|---|
✓ | 最新 |
⬇ | 更新あり（トラッキング対象のリポジトリ: 遅れているコミット数、Skill: 新しいバージョン） |
⚠ | Stale — アップストリームでサブディレクトリが削除またはリネームされた |
! | 未コミットの変更がある |
• | ローカルソース（比較対象のリモートがない） |
Skill のサブディレクトリがアップストリームでリネームまたは削除された場合、check はそれを stale として報告します。stale な Skill を掃除するには update --prune を使用してください。
サブディレクトリからインストールされた Skill については、check はそのディレクトリ自体が変更された場合にのみ「update available」を報告します。リポジトリの無関係な部分に新しいコミットがあっても報告されません。
Project mode
skillshare check -p # すべての Project の Skill を確認
skillshare check -p my-skill # 特定の Project の Skill を確認
skillshare check -p --group frontend # Project のグループを確認
skillshare check -p --json # Project 向けの JSON 出力
Agent 対応
skillshare check agents は確認対象を Agent のみに絞り、Agents source ディレクトリ内の .md ファイルについて drift と更新状況を報告します。
skillshare check agents # すべての Agent を確認
skillshare check agents --json # Agent 向けの JSON 出力
skillshare check agents -p # Project の Agent を確認
agents 引数を指定しない場合、check は Skill のみを対象にします（デフォルトの挙動）。背景については Agents を参照してください。