update

1 つ以上の skill または tracked repositories を最新バージョンに更新します。

skillshare update my-skill           # 単一の skill を更新
skillshare update a b c              # 複数を一度に更新
skillshare update --group frontend   # グループ内のすべての skill を更新
skillshare update team-skills        # tracked repo を更新
skillshare update --all              # すべてを更新
skillshare update agents --all       # すべての tracked/updatable agent を更新

使うタイミング

• tracked repository に新しいコミットがある（check で発見）
• インストール済みの skill に新しいバージョンが利用可能
• 元の source から skill を再ダウンロードしたい

$ skillshare update pdf
✓ Update    pdf · from github.com/anthropics/skills/skills/pdf · 1.9s
✓ Audit     no findings

Next
  skillshare sync  link the changes into your targets

実行内容

トラック対象リポジトリの場合

通常の Skill の場合

リモートソースからインストールした Skill は、そのソースから再インストールされます。ローカルパスからインストールした Skill（skillshare install /path/to/skill）はそのパスから再コピーされるため、update でそこでの変更を取り込めます。パスが変更されたことは check で確認できます。

オプション

フラグ	説明
--all, -a	すべての tracked repos/skills を更新、または update agents --all として使う場合はすべての agents を更新。たどられた source リンクの背後にある tracked repo は、あなた自身のチェックアウトであるため警告付きでスキップされます。名前を指定して更新してください
--group, -G <name>	グループ内の更新可能なすべての skill、または agent サブディレクトリ内のすべての agent を更新
--force, -f	ローカルの変更を破棄し、audit の検出結果があっても続行
--dry-run, -n	変更を加えずにプレビュー
--skip-audit	更新後の security audit gate をスキップ
--audit-threshold <t>, --threshold <t>, -T <t>	update の audit ブロックしきい値を上書き（`critical
--diff	skill/repo 更新後にファイルレベルの変更サマリーを表示
--audit-verbose	batch mode で skill ごとの詳細な audit 検出結果を表示
--prune	古い skill（upstream で削除済み）を警告ではなく削除
--project, -p	カレントディレクトリの project レベルの config を使用
--global, -g	global config を使用（~/.config/skillshare）
--json	JSON として出力
--help, -h	ヘルプを表示

update agents は以下をサポートします: --all、--group、--force、--dry-run、--skip-audit、--audit-threshold / --threshold / -T、--json、加えて --project / --global。--diff、--audit-verbose、--prune はサポートされません。

JSON 出力

skillshare update --all --json

{
  "updated": 3,
  "skipped": 1,
  "security_failed": 0,
  "pruned": 0,
  "dry_run": false,
  "duration": "4.567s",
  "items": [
    {"name": "_team-skills", "type": "repo", "status": "updated"},
    {"name": "my-skill", "type": "skill", "status": "updated"},
    {"name": "another-skill", "type": "skill", "status": "updated"},
    {"name": "local-only", "type": "skill", "status": "skipped"}
  ]
}

取りうる status の値: updated、skipped、failed、security_blocked。項目が失敗した場合、error フィールドが含まれます。

tracked repos が metadata に宣言されているがディスク上に存在しない場合、それぞれがスキップされた repo 項目として簡潔な error（clone directory absent）と共に報告され、集計された missing_tracked_repos サマリーに名前と再水和（rehydration）のヒントがまとめて含まれます。

{
  "updated": 0,
  "skipped": 1,
  "items": [
    {"name": "_team-skills", "type": "repo", "status": "skipped", "error": "clone directory absent"}
  ],
  "missing_tracked_repos": {
    "names": ["_team-skills"],
    "hint": "Run 'skillshare install' to rehydrate tracked repositories"
  }
}

missing_tracked_repos フィールドは、欠落している tracked repos がない場合は省略されます。

Agent の JSON 出力

skillshare update agents --all --json

{
  "agents": [
    {"name": "reviewer", "status": "updated", "source": "github.com/user/agents/reviewer.md"},
    {"name": "team/tutor", "status": "up_to_date", "source": "github.com/user/agents/team/tutor.md"}
  ],
  "dry_run": false,
  "duration": "1.234s"
}

取りうる agent の status の値には updated、failed、skipped、up_to_date、update_available、dirty、drifted、local が含まれます。

Agents の更新

スタンドアロンの .md agents のみを更新したい場合は agents kind セレクターを使います。

skillshare update agents reviewer
skillshare update agents --group team
skillshare update agents --all -T high
skillshare update agents --all --json

Agent の更新は skills と同じ audit gate に従います:

• tracked agent repos は git pull を実行し、その後更新されたリポジトリを audit する
• metadata で紐づけられた単一ファイルの agents は source から再インストールし、staged された .md を audit し、成功した場合のみローカルファイルを置き換える

複数更新

複数の skill を一度に更新します。

skillshare update skill-a skill-b skill-c

更新可能な skill（tracked repos または metadata を持つ skill）のみが処理されます。見つからない skill は警告されますが失敗にはなりません。ただし、いずれかの skill が security audit gate によってブロックされた場合、バッチコマンドは非ゼロのコードで終了します。

Glob パターン

skill 名は、バッチ操作のために glob パターン（*、?、[...]）をサポートします。

skillshare update "core-*"              # core-* に一致するすべての skill を更新
skillshare update "_team-?"             # 1 文字ワイルドカード
skillshare update "core-*" "util-*"     # 複数のパターン

Glob パターンは、各 skill または tracked repo のbasename（パスの最後の要素）に対してマッチします。例えば、"react-*" は basename が react-hooks であるため frontend/react-hooks にマッチします。

Glob マッチングは大文字・小文字を区別しません: "Core-*" は core-auth、CORE-DB などに一致します。

シェルの Glob 保護

シェルがカレントディレクトリのファイル名に * を展開してしまうのを防ぐため、glob パターンは常に引用符で囲んでください（"core-*"）。

グループの更新

グループディレクトリ内の更新可能なすべての skill を更新します。

skillshare update --group frontend        # frontend/ 内のすべてを更新
skillshare update -G frontend -G backend  # 複数のグループ
skillshare update x -G backend            # 名前とグループを混在

グループ内の（metadata や .git を持たない）ローカル skill は黙ってスキップされます。

グループディレクトリに一致する位置引数（repo でも skill でもない）は自動的に展開されます。

skillshare update frontend   # --group frontend と同じ
#   'frontend' is a group — expanding to 3 updatable skills

注記

--all は skill 名や --group と組み合わせることはできません。

すべて更新

すべてを一度に更新します。

skillshare update --all

これにより以下が更新されます:

1. すべての tracked repositories（git pull）
2. source metadata を持つすべての skill（再インストール）

出力例

$ skillshare update --all

✓ Audit     3 skills, no findings

✓ Updated 4, 1 skipped · 6.2s

Next
  skillshare sync  link the changes into your targets

欠落しているトラック対象リポジトリ

.metadata.json が tracked repo（tracked: true）を宣言しているが、そのクローンディレクトリがディスク上に存在しない場合 — クローンディレクトリは管理された .gitignore ブロック内にあるため、新しいマシンでよく発生します — update --all はもはや黙ってスキップしません。欠落している各リポジトリを報告し、再水和（rehydrate）の方法を案内します。

! 1 tracked repo declared in metadata but missing on disk
! _team-skills  clone directory absent
  Run 'skillshare install' to rehydrate tracked repositories

これは global mode と project mode（-p）の両方に適用されます。metadata からクローンを再作成するには、引数なしの install を実行してください（Rehydrating After a Fresh Clone を参照）。

古い Skill のクリーンアップ（--prune）

upstream リポジトリが skill をリネームまたは削除すると、update はそれを**stale（古い）**として検知し、警告します。

Deleted upstream
! frontend/old-skill  stale — no longer in the upstream repository
  Run with --prune to remove them

--prune を追加すると、stale な skill を自動的に削除します（完全に削除されるのではなく trash に移動されます）。

skillshare update --all --prune

check も stale な skill を報告します。

skillshare check --all
# ! old-skill  stale — no longer in the upstream repository

注記

tracked repositories（_repo）は --prune の影響を受けません。tracked repo が内部で skill を削除した場合、sync は PruneOrphanLinks を通じて orphan なシンボリックリンクを自動的にクリーンアップします。

セキュリティ Audit ゲート

skill を更新した後、update は自動的に security audit を実行します。

• Tracked repos（git pull） は有効なしきい値（audit.block_threshold、デフォルト CRITICAL）での post-pull gate を使用します
• 通常の skill（再インストールパス） は同じしきい値ポリシーを使用します
• どの更新タイプでも、確認用に risk のラベル/スコアが表示されます

→ risk: LOW (12/100)

対話モード（TTY、tracked repos）

有効なしきい値以上の検出結果がある場合、決定を求められます。

  [HIGH] Source repository link detected — may be used for supply-chain redirects (SKILL.md:5)

  Security findings at or above active threshold detected.
? Apply anyway?   Yes   No

• Yes — 検出結果があっても更新を受け入れる
• No（デフォルト） — pull 前の状態にロールバックする

非対話モード（CI/CD）

非対話環境では、更新は自動的にロールバックされ、コマンドは非ゼロのコードで終了します。これにより CI パイプラインでの fail-closed な挙動が保証されます。

# source を信頼している場合は audit gate をバイパスする
skillshare update --all --skip-audit

注意

--skip-audit は更新後の security scan を完全に無効化します。source を信頼している場合、または外部の audit プロセスがある場合にのみ使用してください。

承認済みの検出結果

--force（またはプロンプトで y と回答）で gate を上書きすると、受け入れた検出結果は .metadata.json の audit_accepted に記録されます。同じ skill の以降の更新では、それらの正確な検出結果ではブロックされなくなるため、update --all のたびに --force を繰り返す必要はありません。

  1 previously accepted finding skipped

検出結果は行番号ではなく、rule・ファイル・一致したテキストによって照合されます。そのため、無関係な内容が変わっても受け入れ状態が維持されます。新しい検出結果、または同じ rule が異なるテキストに一致した場合は、再びブロックされます。これは、攻撃文字列を例として正当に引用する skill（security scanner や red-team のドキュメントなど）に適しており、それでいて後のバージョンで新しいペイロードを検知できます。

コマンドごとにしきい値を --audit-threshold、--threshold、または -T で上書きできます。

skillshare update _team-skills --threshold high
skillshare update --all -T h

ファイル変更サマリー（--diff）

--diff を使うと、各更新後にファイルレベルの変更サマリーを確認できます。

skillshare update team-skills --diff
skillshare update --all --diff

tracked repositories の場合、diff は git diff を使用し、行レベルの統計情報を含みます。

Files changed
  ~ SKILL.md (+12 -3)
  + scripts/deploy.sh (+45 -0)
  - old-helper.sh (+0 -22)
  ~ utils/format.md (+5 -2)

通常の skill（リモート source からインストールされたもの）の場合、diff は再インストールの前後でファイルハッシュを比較します。

Files changed
  ~ SKILL.md
  + new-helper.sh

マーカー: + 追加、- 削除、~ 変更。最大 20 ファイルまで表示され、それ以上は "... and N more file(s)" とまとめられます。

コンフリクトの処理

tracked repo に未コミットの変更がある場合:

# オプション 1: まず変更をコミットする
cd ~/.config/skillshare/skills/_team-skills
git add . && git commit -m "My changes"
skillshare update _team-skills

# オプション 2: 破棄して強制更新する
skillshare update _team-skills --force

skillshare がリポジトリの git status を読み取れない場合、そのリポジトリの更新は failed to check git status で失敗します。--force を使うとこのチェックをスキップします。

更新後

skillshare sync を実行して、すべての targets に変更を反映します。

skillshare update --all --diff   # ファイルレベルの変更サマリー付きで更新
skillshare sync

Project Mode

project 内の skill と tracked repos を更新します。

skillshare update pdf -p              # 単一の skill を更新（再インストール）
skillshare update a b c -p            # 複数の skill を更新
skillshare update --group frontend -p # グループ内のすべてを更新
skillshare update team-skills -p      # tracked repo を更新（git pull）
skillshare update --all -p            # すべてを更新
skillshare update --all -p --dry-run  # プレビュー
skillshare update --all -p --diff     # ファイル変更サマリー付きで更新
skillshare update --all -p --skip-audit  # security audit gate をスキップ

仕組み

タイプ	方法	検出方法
Tracked repo（_repo）	git pull	.git/ ディレクトリを持つ
Remote skill（metadata 付き）	source から再インストール	.metadata.json に記載されている
ローカルパスからのインストール	記録されたパスから再コピー	.metadata.json に type: local で記載されている
Local skill	スキップ	.metadata.json に記載されていない

_ prefix は省略可能です — skillshare update team-skills -p は自動的に _team-skills を検出します。

ロックファイル

固定されたコミットを先へ進めるのが update -p です。新しいコミットに移動した skill や tracked repo は、.skillshare/skills.lock.json 内のエントリが書き換えられます。変更のなかった skill は固定をそのまま保持します。ロックファイルをコミットしておけば、チームメンバーは次回の skillshare install -p で同じコミットを取得できます。ロックファイルを参照してください。

コンフリクトの処理

未コミットの変更がある tracked repos はデフォルトでブロックされます。

# オプション 1: まず変更をコミットする
cd .skillshare/skills/_team-skills
git add . && git commit -m "My changes"
skillshare update team-skills -p

# オプション 2: 破棄して強制更新する
skillshare update team-skills -p --force

skillshare がリポジトリの git status を読み取れない場合、そのリポジトリの更新は failed to check git status で失敗します。--force を使うとこのチェックをスキップします。

典型的なワークフロー

skillshare update --all -p
skillshare sync
git add .skillshare/ && git commit -m "Update remote skills"

関連項目

• install — Skill をインストール
• upgrade — CLI と built-in skill をアップグレード
• sync — targets に sync
• Project Skills — Project mode の概念