Agent Skills の更新・ロールバック・削除

簡単な記録を残す

半年後、誰かが .claude/skills/launch-page/ を見つけて、触っても大丈夫だろうかと迷うことになります。リポジトリの README に 4 行書いておけば、その疑問に答えられます：

## Agent Skills in this repo
- launch-page: from skillry.dev/skills/bs-meridian-marketing-landing
  version 1.2.0, project scope (.claude/skills), Claude Code
  local change: brand colors in references/palette.md

Skill を更新する方法

Skill は --force を付けて再インストールすることで更新します。CLI は最新バージョンをダウンロードしてフォルダ全体を置き換えるので、事前に内容を読み、事後にテストしましょう：

1. 1

   Skill のページで変更点を確認します。特にスクリプト、依存関係、外部コストに注目してください。

2. 2

   前回と同じエージェントまたはターゲットを指定し、--force を付けて再インストールします。フラグがないと、CLI は “already exists. Re-run with --force to replace it safely.” と表示して停止します。

   npx --yes skillry-cli@latest install <slug> --force

   表示されるはずのもの： Installed <slug> <version> to … と Previous version preserved at …

3. 3

   いつものテストを行います。名前で 1 回、普通の言葉で 1 回。

問題のある更新をロールバックする

強制インストールのたびに、古いコピーが Skills フォルダの隣に残ります。例：~/.agents/skills/.best-ai-skills/backups/<slug>-<date>-<id>/。エージェントはこのフォルダを読み込みません。元に戻すには、現在の <slug>/ フォルダを削除し、バックアップをその場所に移動して名前を <slug> に変更します。

Skill を削除する

Skill を削除するには、そのフォルダを削除します。そのうえで、個人用とプロジェクト用のフォルダに同じ名前の別のコピーがないかを探してください。Claude Code では個人用のコピーがプロジェクト用より優先されるため、残ったコピーがあると、後の更新が無視されたように見えることがあります。すべてのフォルダは Skill の保存場所に載っています。

チームで 1 つのコピーを共有する

レビュー済みのコピーを 1 つリポジトリの Skills フォルダにコミットし、依存関係をメモしておけば、全員が同じバージョンを使えます。Skillry の Skill をそこにインストールするには --target を使います：

npx --yes skillry-cli@latest install <slug> --target .claude/skills

よくある質問