Files
skillshare/website/i18n/ja/docusaurus-plugin-content-docs/current/reference/commands/check.md
T
Willie cf36965cea feat(website): add zh-Hant/zh-Hans/ja/ko locales with initial docs translation
Sets up Docusaurus i18n for Traditional Chinese, Simplified Chinese,
Japanese, and Korean: locale config, navbar/footer/sidebar UI chrome,
and translated content for intro, getting-started, understand, and
reference/commands. Untranslated pages fall back to English.

Pins explicit heading anchors ({#id}) on English source pages that are
linked to by fragment, so translated headings don't change the anchor
id and break cross-page links. Converts a handful of relative .md
links that crossed from an untranslated page into a now-translated
one, since Docusaurus resolves those per-locale and they'd otherwise
404 outside English.
2026-09-20 11:08:48 +08:00

7.6 KiB
Raw Blame History

sidebar_position
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               # 機械可読な出力

使うタイミング

更新前に

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

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

CI/CD パイプライン

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

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

実行内容

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

  1. トラッキング対象のリポジトリ — origin から fetch し、何コミット遅れているかを表示
  2. メタデータ付きのインストール済み Skill — インストール済みのバージョンをリモートの HEAD と比較
  3. Stale な Skill — アップストリームリポジトリからサブディレクトリが削除された Skill を検出
  4. ローカルの Skill — 「local source」としてマーク(比較対象のリモートがない)
  5. 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 ヘルプを表示

:::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": "local-skill", "source": "", "version": "",
     "status": "local", "installed_at": "2024-04-20T12:00:00Z"}
  ]
}

ステータス表示

アイコン 意味
✓ 最新
⬇ 更新あり(トラッキング対象のリポジトリ: 遅れているコミット数、Skill: 新しいバージョン)
⚠ Stale — アップストリームでサブディレクトリが削除またはリネームされた
! 未コミットの変更がある
• ローカルソース(比較対象のリモートがない)

:::info Stale な Skill Skill のサブディレクトリがアップストリームでリネームまたは削除された場合、check はそれを stale として報告します。stale な Skill を掃除するには update --prune を使用してください。 :::

:::tip モノレポでの挙動 サブディレクトリからインストールされた 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 を参照してください。

関連項目

  • update — 更新を適用
  • list — インストール済みの Skill を表示
  • status — sync 状態を表示
  • Agents — Agent の概念