スキルガイド · 2026年8月19日確認

Antigravity スキルの使い方・追加・作成方法

繰り返し使う指示を再利用可能なエージェント機能にまとめながら、重要な前提や権限を隠さないための実践ガイドです。SKILL.md、プロジェクトとユーザーのスコープ、段階的な読み込み、skills・rules・plugins・MCP の違いを整理します。

このページは独立した解説です。現在の仕様は Google 公式ドキュメントで確認し、コミュニティ製スキルは信頼できる作業環境で実行する前に必ず内容を確認してください。

Antigravity スキルとは?

Antigravity スキルは、繰り返し使うエージェント手順をひとつの名前付きパッケージにする仕組みです。毎回同じ準備文をプロンプトへ貼る代わりに、対象となる作業、読むべき情報、手順、完了条件をスキルにまとめます。良いスキルは巨大な規則集ではなく、適用範囲が明確で、テストでき、結果を説明できる小さなワークフローです。

重要なのは、能力と権限を分けて考えることです。スキルは sitemap の監査、移行レビュー、テスト計画の作成などを教えられます。しかし shell、ネットワーク、秘密情報、ファイル削除、パッケージ導入、MCP ツールの利用には別の確認が必要です。何を自動化せず、どこで停止するかを本文に書いてください。

検索では GitHub のスキル集、追加方法、rules との比較も一緒に現れますが、これらは同じ意図ではありません。このページは空のフォルダーから確認済みのスキルを作る流れを中心にし、plugins、CLI、MCP、権限の詳しい話は関連ガイドへ分けます。

再利用可能な指示毎回書き直さずに呼び出せる、名前付きの作業手順です。
狭い対象範囲組織全体ではなく、認識しやすい一種類の作業を解決します。
段階的な読み込み短い説明を先に見せ、詳細な参考資料は必要なときだけ読みます。
安全機構の代わりではない承認、最小権限、レビュー、バージョン管理を置き換えません。

Antigravity スキルはどこに置く?

場所は、ひとつのプロジェクトで使うか、ユーザー全体で使うかによって変わります。利用している製品画面の最新公式ドキュメントを確認し、デバッグの前に現在のワークスペースとアカウントを確定してください。有効な SKILL.md を作ったのに、現在のセッションがそのフォルダーを検索していないという失敗は珍しくありません。

リポジトリ固有のスクリプト、規約、デプロイ手順に依存するならプロジェクトスコープから始めます。複数のリポジトリで使える一般的な手順はユーザースコープに置きます。ユーザー全体のスキルへ秘密情報や個別のパスを入れず、コミュニティ製スキルは参照ファイルやスクリプトまで読んでから導入してください。

スコープ通常の場所向いている用途最初の確認
プロジェクト.agents/skills/<skill-name>/リポジトリ固有の手順、スクリプト、規約スキルを持つ同じワークスペースを開き、現在のブランチを確認する。
ユーザー設定されたユーザースキルフォルダー個人の複数プロジェクトで共有する手順現在のリリースが案内するプロファイルとユーザーパスを確認する。
参考資料スキル配下の references/・scripts/・assets/長いチェックリスト、補助スクリプト、例、資料補助ファイルを実行する前にメインの指示を読む。
外部コレクション確認済みの Git リポジトリまたは公式カタログ組み込み機能と誤認せずにコミュニティ手順を探す作者、ライセンス、履歴、依存関係、要求権限を確認する。
スキルのフォルダーとソースを確認する Antigravity IDE のプロジェクト画面
Antigravity IDE の実際のプロジェクト画面を、スキルの探索範囲を確認する場面に合わせて切り取っています。

SKILL.md で Antigravity スキルを作る方法

最初は最小限のスキルを作ります。公開前の sitemap 確認、移行レビュー、テスト計画など、ひとつの作業だけを選びます。フォルダー名は安定した小文字にし、何をするスキルか、いつ使うかが分かる短い説明を書きます。説明が曖昧だと発見されず、広すぎると対応できない作業に選ばれる可能性があります。

メインファイルは読みやすく保ちます。SKILL.md にはワークフロー、制約、収集する証拠、停止条件を書き、長い例や限定的な資料は子ファイルへ移します。コマンドを実行する場合は、コマンド名、期待する出力、違う結果になったときの対応を明記してください。

  1. 作業を一つ選ぶチームの全ツールではなく、そのスキルが助ける判断や成果物を定義する。
  2. フォルダーを作る安定した名前を付け、試したいプロジェクトまたはユーザースコープに置く。
  3. frontmatter を書く発見時に作業と一致する名前と説明を入れる。
  4. 手順を書く入力、手順、参考資料、安全境界、完了条件を並べる。
  5. 小さくテストする読み取り専用や dry-run から始め、出力を見てから書き込みを許可する。
---
name: sitemap-release-check
description: リリース前に静的サイトマップを確認し、欠落したURL、不正なcanonical、古いlastmod値を報告します。
---

# サイトマップのリリース確認

1. プロジェクトの指示を読み、元のサイトマップを特定します。
2. ファイルを変更する前にルートと生成済みHTMLを調べます。
3. UTF-8出力でプロジェクトの検証コマンドを実行します。
4. 証拠を報告し、破壊的なクリーンアップの前で停止します。

リポジトリが拡張監査ルールを使うときだけ references/checklist.md を読みます。

これは構造例です。すべてのリリースが同じフォルダー名やコマンドを使うとは限りません。公開前に Google の現行ドキュメントとリポジトリの規約を合わせてください。

エージェントはスキルをどう使う?

発見は通常、スキルの名前と説明から始まります。作業が一致しそうなら、エージェントはメイン指示を読み、必要な参考資料だけを追加で読みます。この段階的な読み込みで初期コンテキストを小さく保ち、回答に影響した情報を確認しやすくします。信頼する前に SKILL.md を読む、というレビュー地点も自然に作れます。

良いスキルは自分の限界を説明します。読み取り専用か、対象フォルダー、許可できるコマンド、確認が必要な操作、保存すべき証拠を明記してください。リポジトリを変更するなら最終 diff と status の確認を求めます。外部サービスに触れるなら公式のソースや endpoint を指定し、未確認のミラーへ置き換えないようにします。

最初の実行は退屈であるほど安全です。ファイル一覧、計画説明、無害な fixture の確認を頼みます。説明のないネットワーク通信、予想外のコマンド、token の要求は権限を広げる合図ではなく、停止して調べる合図です。

1

一致

作業の言葉とスキルの説明が同じワークフローを指している。

2

読む

メイン指示と現在の作業に必要な参考資料だけを読み込む。

3

計画する

前提、書き込み範囲、コマンド、停止条件を先に見せる。

4

確認する

ファイル、URL、テスト出力など具体的な証拠を残す。

5

レビューする

日常化する前に diff、権限、外部への影響を自分で確認する。

スキルファイルからエージェントの作業と確認済み結果へ流れる説明図
公式 UI のスクリーンショットではない説明用イラストです。小さなスキルファイルが確認済みの結果へつながる流れを示しています。

Skills・rules・plugins・MCP の違い

Antigravity のカスタマイズという言葉には複数の面があります。新しいページや設定を作るときは境界を明確にします。スキルは繰り返し手順、rule は継続的な指示、plugin や extension は製品の統合機能、MCP はツールやデータ接続です。連携はできますが、同じものとして説明しないでください。

antigravity rules は将来別ページを検討できる検索意図で、antigravity plugins はサイトの Extensions ガイドに対応します。このページでは比較を短く保ち、スキルに入れるべき手順を決めたら、MCP や CLI の詳細は関連ページへ分けます。

対象主な役割使う場面
Skill入力、手順、参考資料、検証を持つ作業フローを教える開始、終了、証拠が認識できる作業。
Rule多くの作業に影響する継続的な好みや制約を保つ常に適用したい指示。
Plugin / extension製品統合、コマンド、言語機能、UI 能力を追加する文章の手順ではなく host 統合が必要なとき。
MCP serverローカルまたはリモートサービスのツールやリソースを公開する外部データや操作の管理された境界が必要なとき。

コミュニティ製スキルを安全に導入・確認する

GitHub のコレクションは便利ですが、検索結果だけで安全とは言えません。コピーする前に、リポジトリの履歴、ライセンス、参照スクリプト、パッケージ、ネットワーク通信、必要な credential を調べます。SKILL.md とリンクされた参考ファイルやスクリプトをすべて読みます。短いスキルでも、詳細を読まなければ破壊的なコマンドを要求することがあります。

導入後は、意図した作業を再現できる最小のワークスペースで発見を確認します。読み取り専用の依頼を行い、どのスキルをなぜ選んだか説明させます。期待したファイルと実際の diff を比較してください。CLI、plugin、MCP に依存する場合は、それぞれを単独でテストし、依存関係の失敗とスキル発見の失敗を混同しないようにします。

  1. ソースを読む作者、ライセンス、履歴、参考資料、スクリプト、依存関係、外部 endpoint を確認する。
  2. テスト範囲へコピーするユーザー全体へ広げる前に、使い捨てリポジトリやプロジェクトフォルダーで試す。
  3. 読み取り専用で実行する編集や shell 操作の前に、一覧、説明、dry-run レポートを求める。
  4. 証拠を確認する選択されたスキル、読まれたファイル、提案コマンド、結果が意図と一致するか見る。
  5. 慎重に共有する挙動が予測でき、権限が文書化できてから利用範囲を広げる。
  • API key、ブラウザーセッション、production credential をスキルファイルに置かない。
  • 削除、deploy、決済、メッセージ、アカウント管理は手動確認にする。
  • スクリプト、パッケージマネージャー、外部サービスを呼ぶ依存関係をレビューする。
  • バージョン管理で生成された変更を確認し、必要なら戻せるようにする。
  • 未知のネットワーク要求は停止して調査する理由にする。
スキルを信頼する前に小さなエージェント作業を確認する Antigravity IDE のパネル
サイトの既存メディアにある Antigravity IDE パネルを、権限を広げる前に小さな作業を確認する場面として再構成しています。

バージョンと公式ソースの確認

このプロジェクトはソフトウェアのダウンロードサイトなので、公開前にバージョン確認を行いました。2026年8月19日に公式ドキュメントとダウンロードフローを確認し、サイトが記録する desktop 系列は Antigravity 2.0 v2.8.1、Antigravity IDE v2.5.5、CLI は v1.1.14 に同期しました。スキルの挙動は installer の版と別に変わる可能性があるため、最終的には公式 Skills ドキュメントを参照してください。

ダウンロード CTA は公式ページへの fallback です。恒久的な binary URL、サイズ、checksum、安全スキャン結果は推測していません。v1.13.3 と v2.2.1 のページは履歴アーカイブとして残し、現行版とは表現していません。

Desktop 系列Antigravity 2.0 v2.8.1
IDE 系列Antigravity IDE v2.5.5
CLI 系列Antigravity CLI v1.1.14
確認日2026年8月19日

Antigravity スキル よくある質問

Antigravity スキルとは何ですか?

SKILL.md を中心に整理した再利用可能な指示セットで、エージェントが専門的な手順を一貫して実行できるようにします。手順を教えるもので、すべてのコマンドを許可するものではありません。

Antigravity にスキルを追加するには?

現在のリリースが案内する project または user のスコープに、名前付きのスキルフォルダーを作成またはコピーします。SKILL.md が読めることを確認し、小さなワークスペースで読み取り専用の依頼からテストします。

SKILL.md はどう作りますか?

狭い作業を一つ選び、安定したフォルダーを作り、name と description の frontmatter、入力、手順、参考資料、安全境界、完了条件を書きます。長い資料は references や scripts に移し、読む条件を明記します。

Claude Skills は Antigravity で使えますか?

他製品向けの skill がそのまま互換だとは考えないでください。フォルダー構造、frontmatter、コマンド、パス、権限を確認し、Antigravity 向けに調整してからテストします。

Skills と Rules の違いは?

Skill は認識できる作業の手順、Rule は多くの作業に継続して影響する指示や制約です。繰り返しのチェックリストなら Skill、常時適用する好みなら現行 Rules 仕様を確認します。

Antigravity スキルは安全ですか?

スキルファイルだから安全、公式とは限りません。ソースと参照スクリプトを読み、低リスクの project で試し、秘密情報を置かず、破壊・ネットワーク・credential・deploy・account 操作を手動確認にします。

Antigravity スキルは GitHub のどこで探せますか?

作者、ライセンス、履歴、ファイル、依存関係、要求権限を確認できる repository や collection を探します。GitHub は発見の場所であり、保守や安全性の証明ではありません。

スキルは plugin、CLI、MCP server の代わりになりますか?

なりません。Skill は手順、plugin と extension は host 統合、CLI は terminal 操作、MCP は tool や resource を提供します。必要な場合だけ役割を組み合わせてください。

公式ソース