/update

sidebar_position: 2

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

実行内容

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

flowchart TD
    TITLE["skillshare update _team-skills"]
    S1["1. Check for uncommitted changes"]
    S2["2. Pull into isolated candidate"]
    S3["3. Security audit gate"]
    S4["4. Publish audited commit"]
    TITLE --> S1 -- clean --> S2 --> S3
    S3 -- pass --> S4
    S3 -- "At/above threshold" --> RB["Reject; checkout unchanged"]

    style RB fill:#ef4444,color:#fff

通常の Skill の場合

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

flowchart TD
    TITLE["skillshare update my-skill"]
    S1["1. Read metadata"]
    S2["2. Re-install from source"]
    S3["3. Security audit gate"]
    TITLE --> S1 --> S2 --> S3

オプション

| フラグ | 説明 | |------|-------------| | `--all, -a` | すべての tracked repos/skills を更新、または `update agents --all` として使う場合はすべての agents を更新。[たどられた source リンク](../targets/configuration.md#follow_source_links)の背後にある tracked repo は、あなた自身のチェックアウトであるため警告付きでスキップされます。名前を指定して更新してください | | `--group, -G <name>` | グループ内の更新可能なすべての skill、または agent サブディレクトリ内のすべての agent を更新 | | `--force, -f` | ローカルの変更を破棄し、audit の検出結果があっても続行し、すでに upstream の commit にあるリモート skill も再インストール | | `--dry-run, -n` | 変更を加えずにプレビュー | | `--skip-audit` | security audit gate をスキップ | | `--audit-threshold <t>`, `--threshold <t>`, `-T <t>` | update の audit ブロックしきい値を上書き（`critical|high|medium|low|info`；省略形: `c|h|m|l|i`、加えて `crit`、`med`） | | `--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` フィールドが含まれます。リモート skill がローカルの変更のためスキップされた場合は、`"error": "local changes since install"` を持つ `skipped` 項目になります。

バッチ更新でリモート skill がすでに upstream の commit にある場合、その skill はそのままにして `up_to_date` フィールドに数えます。件数が 0 のときはこのフィールドを省略します。

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 -g' to rehydrate tracked repositories, or 'skillshare uninstall <name> -g' to remove an unwanted declaration"
  }
}

`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`、`error` が含まれます。`error` の Agent は、リモートに到達できない、metadata を読めないなどの理由で確認できなかったものです。この場合、コマンドは Agent を最新と報告せず、0 以外の終了コードで終了します。

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 マッチングは大文字・小文字を区別しません: `"Cor