/check

sidebar_position: 3

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               # 機械可読な出力
skillshare check my-skill --diff      # インストール後に Skill へ加えた変更を表示

使うタイミング

更新前に

`update` を実行する前に、何が変わるかをプレビューする。

skillshare check         # 更新があるものを確認
skillshare update --all  # 更新を適用
skillshare sync          # 変更を配布

CI/CD パイプライン

CI 内で古くなった Skill を確認する。

result=$(skillshare check --json)
# JSON をパースして古い Skill を検出する

終了ステータス

確認した項目のいずれかが `error` の場合（リモートに接続できない、ローカルのソースが存在しないなど）、`check` はコード `1` で終了します。更新あり、Stale、ローカルの変更だけでは失敗になりません。`--json` 使用時も stdout にすべての結果を出力します。各項目の `status` と `message` を確認してください。指定した名前やグループに確認対象がひとつもない場合、`check` はコード `1` で終了し、`--json` では結果の代わりに `{"error": "..."}` を出力します。`--json` 使用時、一部の名前だけがスキップされた場合、その名前は結果の `warnings` 配列に含まれます。`--json` 使用時のその他の失敗（無効なフラグの組み合わせや設定ファイルがない場合など）も、同じ `error` オブジェクトで報告されます。

`--exit-code` を指定すると、すべての項目を確認できた場合でも、最新でないものがあれば終了コード `1` で終了します。対象は、利用可能な更新、stale またはローカルで変更された Skill、遅れている・未コミットの変更がある・存在しない追跡リポジトリです。除外されるのは状態が `local`（比較対象なし）の項目だけです。ローカルパスからインストールした Skill のソースが変更された場合は利用可能な更新として数えます。`check agents` と `check --all` でも同様で、インストール後にファイルが変更された agent も対象です。`--json` と併用でき、`--diff` とは併用できません。

実行内容

`check` は Source ディレクトリを調べ、以下について更新状況を報告します。

1. **トラッキング対象のリポジトリ** — origin から fetch し、何コミット遅れているかを表示 2. **メタデータ付きのインストール済み Skill** — インストール済みのバージョンをリモートの HEAD と比較 3. **Stale な Skill** — アップストリームリポジトリからサブディレクトリが削除された Skill を検出 4. **ローカルで変更された Skill** — リポジトリからインストールした Skill のファイルを、インストール時に記録したファイルと比較し、ファイルを編集・追加・削除していた場合は `"status": "modified"` を報告 5. **ローカルパスからのインストール** — インストール元のパスにあるファイルを、インストール時に記録したファイルと比較（[ローカルパスからのインストール](#local-path-installs)を参照） 6. **ローカルの Skill** — インストールメタデータのない Skill を「local source」としてマーク（比較対象がない） 7. **Skill レベルの `targets` 検証** — SKILL.md の `targets` フロントマターフィールドにある未知の Target 名について警告

`update` とは異なり、`check` はファイルを一切変更しません。

ローカルパスからのインストール {#local-path-installs}

ディスク上のディレクトリからインストールした Skill（`skillshare install /path/to/skill`）は、そのパスとコピーした各ファイルのハッシュを記録します。`check` はそのパスのファイルを再度ハッシュ化し、次のように報告します。

• **up to date** — ファイルがインストール時と一致している
• **update available** — インストール元のパスでファイルが変更、追加、または削除された
• **error** — インストール元のパスが存在しない（`local source not found: <path>`）

これは、App バンドル内の Skill のように、別のアプリケーションが配布・更新する Skill に便利です。

skillshare install /Applications/Surge.app/Contents/Resources/Skills/surge

# App の更新後:
skillshare check surge     # → Update available
skillshare update surge    # パスから再コピーし、セキュリティ監査を実行
skillshare sync

ファイルハッシュが記録される前にインストールされた Skill は、update または再インストールするまで「local source」のままです。 Project mode では、相対パス（`./vendor/my-skill` など）は project root を基準に解決されます。

ダッシュボードで、子 Skill を含むディレクトリのルートをインストールすると、そのルートの `SKILL.md` だけがコピーされます。その場合 `check` は `SKILL.md` だけを比較し、`update` も `SKILL.md` だけを再コピーします。

出力例

$ skillshare check
! _shared-rules   3 commits behind
! _design-system  uncommitted changes
! commit          update available · github.com/anthropics/skills
! old-helper      stale — no longer in the upstream repository

! Updates available for 1 repo, 1 skill, 2 up to date, 1 local skipped, 1 stale · 3.4s

Next
  skillshare update --all          pull the updates
  skillshare update --all --prune  remove stale skills

特定の Skill を確認する

すべてをスキャンする代わりに、名前を指定して 1 つ以上の Skill を確認できます。

skillshare check my-skill                # 単一の Skill
skillshare check skill-a skill-b         # 複数の Skill

`follow_source_links: true` の場合、たどられた Git チェックアウトもリンク名で確認できます。例: `skillshare check _dev-skills`。

グループディレクトリ内の更新可能な 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（ローカルのみ）は、グループ展開時にスキップされます。

オプション

| フラグ | 説明 | |------|-------------| | `--all` | Skill に加えて Agent も確認。名前や `--group` とは併用不可 | | `--group`, `-G` `<name>` | グループ内の更新可能な Skill をすべて確認（繰り返し指定可） | | `--project`, `-p` | Project レベルの Skill（`.skillshare/`）を確認 | | `--global`, `-g` | グローバルの Skill（`~/.config/skillshare`）を確認 | | `--json` | JSON として出力（スクリプト/CI 向け） | | `--diff` | 指定した Skill について、インストール後に変更された各ファイルを、インストール済みバージョンとの行 diff で表示します。名前または `--group` が必要で、`--json` とは併用できません | | `--exit-code` | 最新でない項目が 1 つでもあれば終了コード `1` で終了します（CI 向け）。`--diff` とは併用できません | | `--help`, `-h` | ヘルプを表示 |

:::tip 自動検出 `--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": "my-review", "source": "anthropics/skills", "version": "a1b2c3d",
     "status": "modified", "installed_at": "2024-06-01T10:00:00Z",
     "message": "local changes since install"},
    {"name": "local-skill", "source": "", "version": "",
     "status": "local", "installed_at": "2024-04-20T12:00:00Z"}
  ]
}

`"