deploy-skills-in-antigravity

Antigravity でのスキルのデプロイ

このスキルは、新しいエージェントスキルをダウンロード、インストール、および移行するための構造化されたワークフローを提供します。まず、スキルの検出、インストール、またはアップグレードを処理する find-skills スキルの利用可否を確認します。find-skills が利用できない場合は、直接 CLI インストールコマンドにフォールバックします。

インストールまたはアップグレード後、Antigravity 環境内（~/.gemini が存在する場合）で操作している場合、スキルを ~/.gemini/config/skills/ に移行して、すべての Antigravity ツールで利用可能にするかどうかをユーザーに確認します。

目次

• トリガー
• 前提条件
• インストールと移行のワークフロー
• OS 固有の移行コマンド
• 検証ループ

トリガー

このスキルは、以下の場合に必ずトリガーされます。

• ユーザーが新しいエージェントスキルのダウンロード、インストール、インポート、セットアップ、または更新を依頼した場合。
• ユーザーがリポジトリまたは特定のブランチ/コミットからスキルを追加することに言及した場合。
• ユーザーまたはエージェントが npx skills add、skills add、skills install、または npx skills などの CLI コマンドに言及した場合。
• ユーザーがリポジトリの URL（例: https://github.com/...）を提供し、そのスキルを「追加」または「統合」するよう依頼した場合。

前提条件

• Node.js: skills ツールを実行するために、システムに npx が利用可能である必要があります。
• アクセス権限: ~/.agents/skills/ に対するディレクトリの書き込み権限を確保してください。移行する場合は、~/.gemini/config/skills/ に対する権限も必要です。

インストールと移行のワークフロー

このチェックリストをコピーして、進捗を記録してください：

Skill Deployment Progress:
- [ ] Step 1: Check for `find-skills` availability
- [ ] Step 2: Install or upgrade skills
- [ ] Step 3: Check for Antigravity environment and prompt user for relocation
- [ ] Step 4: Relocate skills (if confirmed)
- [ ] Step 5: Verify that files are correctly positioned
- [ ] Step 6: Sync & Register with `skills.json`

ステップ 1：find-skills の利用可否を確認する

インストールまたはアップグレードを開始する前に：

• 現在のエージェントスキルのコンテキストで find-skills スキルが利用可能かどうかを確認します。
• find-skills が存在する場合は、ステップ 2 でのスキルの検出、インストール、またはアップグレードにそれを使用します。
• find-skills が存在しない場合は、このスキルで詳述されている直接的な CLI フォールバックコマンドを使用してステップ 2 に進みます。

ステップ 2：スキルをインストールまたはアップグレードする

find-skills の利用可否に応じて：

• find-skills が利用可能な場合：
  • スキルの検索、選択、インストール、または更新を find-skills に委任します。
  • 新しいスキルのインストール：npx skills add <package> -g -y を実行します（または特定のリポジトリ URL／ブランチのフラグ）。
  • スキルのアップグレード：npx skills update -g -y を実行します（または npx skills check）。
• find-skills が利用できない場合：
  • ユーザーのリクエストを解析して、対象のリポジトリ URL、スキル名、またはブランチを特定します。
  • run_command を使用して直接 CLI コマンドを実行します：
    • リポジトリのインストール：npx skills add https://github.com/username/repo-name -y -g
    • 特定のスキルのインストール：npx skills add https://github.com/username/repo-name -y -g --skill skill-name
    • スキルのアップグレード：npx skills update -g -y

ステップ 3：Antigravity 環境を確認し、ユーザーに移行を促す

重要

必須のユーザー確認ゲート 移行スクリプトを実行する前に、必ず停止し、ask_question または直接的なプロンプトを使用してユーザーに確認してください。ユーザーが明示的に確認するまで、移行コマンドを実行しないでください。

npx skills によるデフォルトのスキルインストールでは、ファイルは ~/.agents/skills/ に配置されます。 ファイルを移行する前に：

1. ~/.gemini が存在するか確認する：~/.gemini の存在を確認して、対象環境が Antigravity かどうかを検証します（例：Linux/macOS では [ -d "$HOME/.gemini" ]、Windows では Test-Path "$HOME\.gemini"）。
   • ~/.gemini が存在しない場合は、移行をスキップします。インストールされたスキルは ~/.agents/skills/ に残ります。
2. ユーザーに確認する：~/.gemini が存在する場合は、新しくインストール／更新されたスキルを ~/.gemini/config/skills/ に移行し、すべての Antigravity ツールで利用できるようにするかどうかをユーザーに明示的に尋ねます。
   • ユーザーが確認した場合：ステップ 4 に進み、移行を実行します。
   • ユーザーが拒否した場合：スキルは ~/.agents/skills/ に残します。

ステップ 4：スキルを移行する（確認された場合）

ユーザーが移行を確認し、~/.gemini が存在する場合：

• OS 固有の移行コマンドセクションで詳述されている OS 固有の移行コマンドを使用して、スキルを ~/.agents/skills/ から ~/.gemini/config/skills/ に移動します。

ステップ 5：ファイルが正しく配置されていることを検証する

検証ループで概説されているチェックを実行して、スキルが機能し、正しく配置されていることを確認します。

ステップ 6：skills.json と同期して登録する

Antigravity 環境（~/.gemini が存在する）で操作しており、スキルが ~/.gemini/config/skills/ に移行された場合：

1. ~/.gemini/config/skills.json が存在するかどうかを確認します。
2. skills.json を読み取り、新しくインストール／更新されたスキルが exclude 配列にリストされているかどうかを確認します。
3. skills.json に存在しない、新しく移行されたスキルについて：
   • ユーザーに確認するか、コンテキストを評価して、スキルをデフォルトで有効にする（"//skill-name"）か無効にする（"skill-name"）かを決定します。
   • スキルを exclude 配列に挿入します。
   • exclude 配列をアルファベット順に並べ替え、更新された skills.json をディスクに書き戻します。

OS 固有の移行コマンド

オペレーティングシステムに応じて、適切なシェルコマンドまたはスクリプトを実行します：

Linux および macOS（Bash/Zsh）

このクリーン置換スクリプトを実行します。新しくインストールされたバージョンを移動する前に、~/.gemini/config/skills/ 内の既存のバージョンを削除します：

mkdir -p "$HOME/.gemini/config/skills/" && [ -d "$HOME/.agents/skills" ] && for d in "$HOME/.agents/skills"/*/; do [ -d "$d" ] && rm -rf "$HOME/.gemini/config/skills/$(basename "$d")" && mv "$d" "$HOME/.gemini/config/skills/"; done

Windows (PowerShell)

Windows ホスト環境で操作する場合は、次の PowerShell コマンドを実行します：

$sourceDir = "$HOME\.agents\skills"
$destDir = "$HOME\.gemini\config\skills"
if (-not (Test-Path $destDir)) { New-Item -ItemType Directory -Path $destDir -Force }
Get-ChildItem -Path $sourceDir -Directory | ForEach-Object {
    $target = Join-Path $destDir $_.Name
    if (Test-Path $target) { Remove-Item -Path $target -Recurse -Force -ErrorAction SilentlyContinue }
    Move-Item -Path $_.FullName -Destination $destDir -Force
}

検証ループ

タスクを完了する前に、エージェントは次の検証シーケンスを必ず実行しなければなりません：

1. フォルダーの存在と移動の検証

スキルディレクトリのパス（移動済みの場合は ~/.gemini/config/skills/、そうでない場合は ~/.agents/skills/）を確認します：

• Linux/macOS: ls -la ~/.gemini/config/skills/（または ls -la ~/.agents/skills/）
• Windows: Get-ChildItem "$HOME\.gemini\config\skills"（または Get-ChildItem "$HOME\.agents\skills"）

2. Frontmatter と整合性のチェック

対象ディレクトリに SKILL.md ファイルが存在し、有効な YAML frontmatter ブロックを持っていることを確認します：

• コマンド: SKILL.md の最初の 10 行を読み、--- で始まり、有効な name キーと description キーを含んでいることを確認します。

3. サブディレクトリの検証

複雑なスキルの場合は、ネストされたフォルダー（references/、evals/、scripts/ など）が存在し、内容が格納されていることを確認します：

• コマンド: 重要なフォルダーが存在し、空でないことを確認します。

4. グローバルレジストリのチェック

Skills CLI がスキルを正常に登録し、一覧表示できることを確認します：

• コマンド: npx skills ls -g（または npx skills ls -g --json）
• 成功基準: 出力にスキル名とその絶対パスが並んで表示されている必要があります。

5. 権限と可読性のチェック

実行時のローダー障害を防ぐため、スキルファイルがアクティブなシェルプロセスから読み取り可能であることを確認します。