AIエージェントを自分専用にカスタマイズ！Antigravity「エージェント・スキル」完全解説ガイド：初心者でも迷わない自動化の仕組みと実践法

AI
この記事は約16分で読めます。
  1. AIエージェントを自分専用にカスタマイズ！Antigravity「エージェント・スキル」完全解説ガイド：初心者でも迷わない自動化の仕組みと実践法のPodcast
  2. はじめに：AIエージェントの新たな地平とAntigravityの登場
  3. 第1章：エージェント・スキルとは何か — その本質と重要性
    1. 従来のプロンプトエンジニアリングとの違い
    2. エージェント・スキルが提供する3つの要素
  4. 第2章：Antigravityにおけるスキルの構造と種類
    1. スキルの基本的な構成
    2. スコープによる分類：ワークスペースとグローバル
    3. 他の機能（ルール・ワークフロー）との使い分け
  5. 第3章：実践！初めてのエージェント・スキル作成
    1. ステップ1：フォルダの準備
    2. ステップ2：SKILL.mdの作成と記述
    3. ステップ3：スキルの認識とテスト
  6. 第4章：高度なスキル開発 — スクリプトとの連携
    1. スクリプト実行の仕組み
    2. 引数の渡し方とエラーハンドリング
    3. スクリプト連携のメリット
  7. 第5章：質の高いスキルを作るためのベストプラクティス
    1. 1. セマンティック・トリガー（説明文）を磨く
    2. 2. 「原子性（Atomic）」を保つ
    3. 3. 具体的な例示（Few-Shot）を活用する
    4. 4. 制約事項（Constraints）を明記する
  8. 第6章：スキルの共有とエコシステムの活用
    1. オープンなスキル・リポジトリ
  9. 第7章：セキュリティと運用の注意点
    1. サンドボックスと権限管理
  10. 2026年の展望：マルチエージェント・コラボレーション
  11. 結論：AIをあなたの「最高のパートナー」にするために
  12. 参考資料

AIエージェントを自分専用にカスタマイズ！Antigravity「エージェント・スキル」完全解説ガイド：初心者でも迷わない自動化の仕組みと実践法のPodcast

下記のPodcastは、Geminiで作成しました。

はじめに：AIエージェントの新たな地平とAntigravityの登場

人工知能（AI）の進化は、単なる対話型のチャットボットから、自律的にタスクを完遂する「AIエージェント」の時代へと急速にシフトしています。その最前線に位置するのが、2025年11月に登場したGoogleのAIエージェント作業環境「Antigravity（アンチグラビティ）」です [1]。

Antigravityは従来のAIツールとは一線を画し、AIが自ら計画を立て、ファイルを生成し、プログラムを実行する「自律型エンジニア」としての能力を備えています [1]。この革新的なプラットフォームにおいて、エージェントの能力を最大限に引き出し、特定の業務に特化させるための仕組みが「Agent Skills（エージェント・スキル）」です。

エージェント・スキルは、AIに特定の専門知識やワークフローを「教え込む」ためのオープンな標準規格であり、これを活用することで、誰でも自分専用の高度なAIアシスタントを構築することが可能になります [1]。

本レポートでは、AIの初心者の方でも安心して取り組めるよう、エージェント・スキルの基本概念から具体的な作成手順、さらには高度な自動化を実現するためのスクリプト連携まで、丁寧に解説していきます。この記事を読み終える頃には、Antigravityを自由自在に操り、面倒な定型業務をAIに丸投げするための確かな知識が身についているはずです。

第1章：エージェント・スキルとは何か — その本質と重要性

エージェント・スキルは、AIエージェントの機能を拡張し、特定のタスクに対する習熟度を高めるための軽量なパッケージです [1]。これは元々Anthropic社によって提唱された規格であり、現在ではGoogleのAntigravityにおいても標準的な機能拡張の手段として採用されています [1]。

従来のプロンプトエンジニアリングとの違い

これまでのAI利用では、システムプロンプトと呼ばれる長い指示文を最初からすべてAIに読み込ませる手法が一般的でした。しかし、この方法ではAIの記憶容量（コンテキストウィンドウ）を圧迫し、処理速度の低下や、指示の「忘却」といった問題が発生しやすくなります。これを「コンテキストの飽和」や「ツール肥大化」と呼び、大規模なプロジェクトになればなるほど、AIの推論精度を著しく下げる要因となっていました [1]。

エージェント・スキルは、「段階的開示（Progressive Disclosure）」という手法を用いることで、この問題を根本から解決します [1]。エージェントは、利用可能なスキルの「名前」と「短い説明」だけを最初に把握し、ユーザーの依頼内容に応じて、そのスキルが必要だと判断した瞬間にだけ、詳細な指示内容を読み込みます [1]。このオンデマンドな仕組みにより、AIは常に最小限かつ最適な情報だけで思考することができ、高速かつ正確なレスポンスを実現できるのです [1]。

エージェント・スキルが提供する3つの要素

一つのエージェント・スキルは、主に以下の3つの要素で構成されています [1]。

指示書（Instructions）: 特定のタスクを遂行するための具体的な手順や思考プロセスを記述したMarkdownファイル（SKILL.md）です。

ベストプラクティス（Best Practices）: 従うべき慣習や、避けるべき行動などのガイドラインを定義します。

リソース（Resources）: 必要に応じて実行されるプログラム（スクリプト）や、参考となるテンプレート、データファイルなどを含めることができます。

このように、エージェント・スキルは単なる指示の羅列ではなく、AIが「道具」を使いこなし、「専門家」として振る舞うためのパッケージ一式、いわばAIにとっての「秘伝のレシピカード」であると言えます [1]。

第2章：Antigravityにおけるスキルの構造と種類

Antigravityでスキルを構築する前に、そのフォルダ構造と、用途に応じた「スコープ（適用範囲）」の違いを理解しておきましょう。

スキルの基本的な構成

エージェント・スキルは、特定のルールに従ったフォルダとして管理されます。最もシンプルな構成では、フォルダの中に SKILL.md という名前のファイルが一つあれば、それだけでスキルとして成立します [1]。

ファイル/フォルダ名役割必須 / 任意
SKILL.mdメタデータと詳細な指示を記述するスキルの「脳」必須
scripts/PythonやBashなど、AIが実行するプログラムを格納任意
examples/正解例や参考実装を格納し、AIの理解を助ける任意
resources/テンプレートやドキュメントなど、AIが参照する素材任意

スコープによる分類：ワークスペースとグローバル

スキルには、保存する場所によって、そのスキルが有効になる範囲が異なります [1]。

ワークスペース・スキル（Workspace Skills）

特定のプロジェクトフォルダ内の .agent/skills/（または最新版で推奨される .agents/skills/）に保存します [1]。そのプロジェクト固有のコーディング規約やデプロイ手順など、チーム内で共有したいルールを定義するのに最適です [1]。

グローバル・スキル（Global Skills）

ユーザー個人のホームディレクトリ以下（~/.gemini/antigravity/skills/）に保存します [1]。コミットメッセージの整形や、JSONデータの検証など、あらゆるプロジェクトで共通して使いたい自分専用の道具をここに置きます [1]。

他の機能（ルール・ワークフロー）との使い分け

Antigravityには、スキルの他にもエージェントを制御する仕組みがあります。これらを正しく組み合わせることで、より強固な自動化システムが構築できます [1]。

機能名トリガー（起動のきっかけ）性質主な用途
ルール (Rules)自動（常時適用）受動的な制約「常に日本語で回答する」などの全体方針
ワークフロー (Workflows)ユーザーの明示的なコマンド (/)能動的なマクロ「テスト実行」などの特定の繰り返し操作
スキル (Skills)エージェントの自律的な判断オンデマンドな能力「データベース移行」などの専門的な課題解決

ルールが「ガードレール（やってはいけないこと）」であるのに対し、スキルは「トレーニングモジュール（やり方を知っていること）」であると考えると分かりやすいでしょう [1]。

第3章：実践！初めてのエージェント・スキル作成

ここでは、実際にAntigravity上で動作する簡単なスキルを作成する手順を詳しく解説します。例として、ユーザーがゲームに誘った際にチェスを提案する「game-of-chess」というスキルを作ってみましょう [1]。

ステップ1：フォルダの準備

まず、あなたのプロジェクトフォルダの中に、スキルを格納するための場所を作ります。ターミナルを使うか、エディタの操作で .agent/skills/ というフォルダを作成してください [1]。次に、その中に今回のスキル専用のフォルダ game-of-chess を作成します [1]。

ステップ2：SKILL.mdの作成と記述

作成したフォルダの中に SKILL.md というファイルを作成します。このとき、ファイル名はすべて大文字にする必要がある点に注意してください [1]。ファイルの内容は、以下の構成で記述します。

YAMLフロントマター: ファイルの冒頭に、ハイフン3つ --- で囲まれた設定情報を書きます。ここでスキルの「名前」と「説明」を定義します。この「説明」が、エージェントがスキルを使うかどうかを判断するトリガーになります [1]。

Markdownボディ: その下に、具体的な指示内容をMarkdown形式で記述します [1]。

yaml

name: game-of-chess
description: ユーザーが何かゲームをしたいと言った時に、チェスを提案するためのスキルです。

チェスの提案スキル
ユーザーが「ポーカー」や「ブラックジャック」などのゲームをしたいと申し出てきた場合、必ず以下のように答えてください。
「よろしければ、素晴らしいチェスの対戦はいかがでしょうか？」

ステップ3：スキルの認識とテスト

ファイルを保存すると、Antigravityのエージェントは自動的にこのスキルを検知します。実際にチャット欄で「何かゲームをしよう」と話しかけてみてください [1]。エージェントが「素晴らしいチェスの対戦はいかがでしょうか？」と答えたら、スキルが正しく動作している証拠です [1]。

もしエージェントがスキルを認識していないようであれば、「あなたが今使えるスキルを教えて」と聞いてみてください。エージェントはワークスペースをスキャンし、利用可能なスキルの一覧を回答してくれます [1]。

第4章：高度なスキル開発 — スクリプトとの連携

エージェント・スキルの真の威力は、テキストによる指示だけでなく、実際のプログラム（スクリプト）を実行できる点にあります [1]。これにより、AIは単なる「語り手」から、実際に手を動かす「実行者」へと進化します [1]。

スクリプト実行の仕組み

スキルフォルダ内に scripts/ フォルダを作成し、その中に Python、Bash、Node.js、Go などの言語で書かれた実行ファイルを配置します [1]。エージェントは SKILL.md の指示に従い、必要に応じてこれらのスクリプトを呼び出します。

例えば、以下のような指示を SKILL.md に含めることができます。

「Gitのコミットメッセージを生成するために、scripts/analyze_diff.py を実行してください。」

「データベースのスキーマを確認するために、scripts/db_inspector.sh を使用してください。」

引数の渡し方とエラーハンドリング

エージェントに対して、スクリプトにどのような引数（オプション）を渡すべきかも指示できます。例えば、「ユーザーが指定した環境名を --env フラグとして渡してください」といった具合です [1]。また、スクリプトが失敗した場合の対応も重要です。「もしスクリプトがエラーを返したら、ログを解析して修正案を提示してください」と記述しておくことで、エージェントは自律的にトラブルシューティングを行うようになります [1]。

スクリプト連携のメリット

スクリプトをスキルに組み込むことで、LLM（大規模言語モデル）単体では苦手なタスクを補完できます。

正確な計算: 複雑な数学的計算やデータの集計をスクリプトに任せることができます [1]。

外部システム操作: APIの呼び出しやデータベースの操作など、安全な「手」として機能させることができます [1]。

定型処理の高速化: ファイルの大量変換や、決まった形式のレポート生成などを瞬時に完了させられます [1]。

第5章：質の高いスキルを作るためのベストプラクティス

初心者からプロフェッショナルまで、効果的なスキルを作成するために守るべき「黄金律」があります [1]。

1. セマンティック・トリガー（説明文）を磨く

メタデータの description は、エージェントが「そのスキルを使うかどうか」を判断する唯一の手がかりです [1]。曖昧な表現を避け、「〜を生成する」「〜を検証する」といった具体的な動詞を使い、三人称で記述することが推奨されます [1]。

良くない例良い例
コードをチェックします。Pythonコードのセキュリティ脆弱性をスキャンし、修正案を提示します。
コミットの手伝い。Gitの変更履歴からConventional Commits形式のメッセージを生成します。

2. 「原子性（Atomic）」を保つ

一つのスキルに、あまりにも多くの役割を持たせてはいけません [1]。

「テスト作成」と「デプロイ」を一つのスキルにするのではなく、それぞれ独立したスキルとして作成することで、エージェントの混乱を防ぎ、再利用性を高めることができます [1]。

3. 具体的な例示（Few-Shot）を活用する

指示だけでは意図が伝わりにくい場合、examples/ フォルダに「入力と出力のペア」をいくつか含めてください [1]。

「このように頼まれたら、こう動く」という具体例をAIに見せることで、スキルの精度は飛躍的に向上します [1]。

4. 制約事項（Constraints）を明記する

「絶対にやってはいけないこと」を指示に含めることも、安全性の観点から非常に重要です [1]。

例えば、「データベースのレコードを削除する前には必ずユーザーの許可を得ること」や、「パスワードなどの機密情報をログに出力しないこと」などのガードレールをスキル内に定義しておきます [1]。

第6章：スキルの共有とエコシステムの活用

エージェント・スキルはオープンな標準規格であるため、世界中の開発者が作成したスキルを自分の環境に取り込むことができます [1]。

オープンなスキル・リポジトリ

ゼロからすべてを作る必要はありません。以下のようなコミュニティ主導のリポジトリから、便利なスキルを探してダウンロードすることが可能です。

Anthropic公式スキル: PDF、Excel、PowerPointなどのドキュメント処理に特化した高品質なスキルが公開されています [1]。

Awesome Agent Skills: コミュニティによって厳選された、便利なスキルのリンク集です [1]。

Skills Hub: 複数のAIツールでスキルを管理するためのデスクトップアプリも登場しています [1]。

これらのリソースを活用することで、自分の環境を一気に強力なAIラボへと変えることができます。ダウンロードしたフォルダを、自分の .agent/skills/ にコピーするだけで、すぐに新しい能力をエージェントに授けられます [1]。

第7章：セキュリティと運用の注意点

AIにスクリプト実行やファイル操作を許可することには、当然ながらリスクも伴います。Antigravityを安全に運用するためのポイントを整理します。

サンドボックスと権限管理

エージェントは基本的に、ログインしているユーザーと同じ権限で動作します [1]。悪意のある、あるいはバグのあるスキルを導入してしまうと、重要なファイルを削除されたり、環境変数が漏洩したりする危険性があります [1]。

第三者のスキルは必ず監査する: ネットから拾ってきたスキルを導入する際は、必ず SKILL.md や scripts/ の中身を自分の目で確認してください [1]。

実行確認モード（Manual Mode）: Antigravityの設定で、コマンド実行前にユーザーの承認を必須にする「マニュアルモード」を使用することを強くお勧めします [1]。

環境の分離: 重要な本番環境で直接エージェントを動かすのではなく、まずは影響のない開発環境（サンドボックス）でスキルの動作をテストしてください [1]。

2026年の展望：マルチエージェント・コラボレーション

エージェント・スキルの進化は止まりません。2026年には、一つのユーザーの依頼に対して、複数の異なるスキルを持ったエージェントが連携して解決に当たる「マルチエージェント・オーケストレーション」が一般化すると予測されています [1]。

例えば、「アプリを作って」という依頼に対し、

「要件定義スキル」を持つエージェントが仕様を固め

「アーキテクチャ設計スキル」を持つエージェントが構成図を作り

「実装スキル」を持つエージェントがコードを書く

といった連携が、裏側で自動的に行われるようになります [1]。エージェント・スキルは、この巨大な連携システムにおける最小単位の「知能」として、ますますその重要性を増していくでしょう [1]。

結論：AIをあなたの「最高のパートナー」にするために

Antigravityのエージェント・スキルは、単なる機能拡張の手段ではなく、私たちがAIとどのように協力して働くかという「新しい働き方の設計図」です [1]。自分でスキルを書き、それをエージェントが忠実に実行する過程を体験すると、AIが信頼できる「有能な部下」や「パートナー」のように感じられるはずです。

自分の業務知識や、チームのこだわりを一つ一つのスキルとして形にしていくことで、AIはあなたに最適化され、世界に一つだけの強力なツールへと進化します。まずは、よく使う挨拶や、簡単なファイルの整理など、小さなタスクからスキル化してみてください。その小さな一歩が、AIと共に歩む未来の大きな自動化への道へと繋がっています。

参考資料

1. Antigravity Agent Skills 公式ドキュメント, https://forest.watch.impress.co.jp/docs/serial/yaaiwatch/2078823.html

2. Antigravity AI Agent Skills 開発者ガイド, https://www.youtube.com/watch?v=1Szcgmsdp-E

3. Agent Skills, https://antigravity.google/docs/skills

4. Tutorial: Getting Started with Antigravity Skills, https://medium.com/google-cloud/tutorial-getting-started-with-antigravity-skills-864041811e0d

5. Mastering Google Antigravity Skills: The Ultimate Guide to Extending Agentic AI in 2026, https://vertu.com/lifestyle/mastering-google-antigravity-skills-the-ultimate-guide-to-extending-agentic-ai-in-2026/

6. Confused about where to put your agent skills?, https://medium.com/google-cloud/confused-about-where-to-put-your-agent-skills-ea778f3c64f3

7. Agent Skills in Antigravity: How to Extend Your AI Capabilities, https://www.stephenwthomas.com/azure-integration-thoughts/agent-skills-antigravity-tutorial/

8. Stop starting from scratch every time you open a new project!, https://www.youtube.com/watch?v=EIFrH0JDXnA

9. Getting Started with Google Antigravity, https://codelabs.developers.google.com/getting-started-google-antigravity?hl=ja

10. Antigravityのスキルとは, https://qiita.com/ho-rai/items/cb76efb490898c778a45

11. AIに明確に提示する4つのルール, https://note.com/dialogs_develop/n/n49e2611bebd1

12. Google Antigravity adds Agent Skills standard, https://www.vktr.com/ai-news/google-antigravity-adds-agent-skills-standard/

13. Google Antigravity AI Agent Skills: The Update, https://www.reddit.com/r/AISEOInsider/comments/1qqlmtl/google_antigravity_ai_agent_skills_the_update/

14. Awesome Agent Skills (Heilcheng), https://github.com/heilcheng/awesome-agent-skills

15. Open Agent Skills Hub GitHub, https://github.com/agentskills

16. Claude + Antigravity: 3 levels of skills, https://www.youtube.com/watch?v=cFThM_D3nl8

17. Mastering Google Antigravity Skills: A Comprehensive Guide, https://vertu.com/lifestyle/mastering-google-antigravity-skills-a-comprehensive-guide-to-agentic-extensions-in-2026/

18. rominirani/antigravity-skills Repository, https://github.com/rominirani/antigravity-skills

19. Open Agent Skills Hub GitHub (qufei1993), https://github.com/qufei1993/skills-hub

20. Awesome Agent Skills (JackyST0), https://github.com/JackyST0/awesome-agent-skills

コメント

タイトルとURLをコピーしました