title: "Google Antigravity の『スキル』とは？初心者向け完全ガイド" description: "Antigravityの中核機能『スキル』の概念から実装方法まで解説。AIエージェントに『能力パック』を持たせる仕組みを理解し、開発効率を劇的に向上させるガイド。" date: 2026-01-14 categories: - AI開発・自動化 tags: - Antigravity - Google - AIエージェント - スキル開発 - 開発ガイド

Google Antigravity の『スキル』とは？初心者向け完全ガイド¶

この記事の対象者

Antigravityをこれから始める初心者
AIエージェントの「スキル」機能を理解したい方
繰り返し作業を自動化したいエンジニア

1. Antigravityとスキルの基本関係¶

まず前提として理解すべき点：Antigravity＝AIエージェントが自動で開発を進めるツールです。

Google Antigravity徹底レビューでは、このツールの全体像を解説していますが、本記事は「スキル」という仕組みに特化したガイドです。

従来のツールとの違い¶

従来のAIツール	Antigravity（スキルなし）	Antigravity（スキルあり）
「コードを書いて」と頼む	「このコードをレビューして。バグチェック、スタイルチェック、パフォーマンス確認...」と毎回指示	「このコード、レビューして」で完了
毎回同じ説明が必要	指示内容の一貫性が不安定	AIが同じやり方で処理
複雑な指示が困難	複雑な処理ほど説明が長い	スキルで複雑処理を自動化

2. スキルとは何か——シンプルな定義¶

Core Concept¶

スキル＝ AIエージェントが自分で選んで使える『能力パック』

人間の職人を例に説明します：

料理人が持つ「包丁さばきの技術」
医者が持つ「診断方法」
営業マンが持つ「プレゼンテーション能力」
↓
これと同じように、AIエージェントに
「特定の作業をこなす能力」を持たせるのが『スキル』

具体的には何か¶

スキルはフォルダとファイルで構成されます。

my-skill/
  ├── SKILL.md          # 必須：スキルの説明書
  ├── scripts/          # オプション：自動実行スクリプト（Python・Bash等）
  └── resources/        # オプション：テンプレートやドキュメント

基本はSKILL.mdだけで動きます。scripts/ や resources/ は、より高度な自動化が必要になったときに追加すれば十分です。

3. スキルが何をするのか¶

スキルなし：毎回同じ説明¶

あなた: 「このコードをレビューして。
        バグがないか、スタイルは適切か、
        パフォーマンスの問題はないか確認してね」

AI: 「わかりました」

毎回これを説明する必要があります。

スキルあり：一度の指示で全て¶

あなた: 「このコードをレビューして」

AI: 「あ、『コードレビュースキル』が使えるな。
    バグチェック → スタイルチェック →
    パフォーマンス確認 → 自動実行」

AIが自分で判断して、必要なステップを全部やってくれます。

4. ワークフロー vs スキル—ぬいぐるみ工場の例え¶

記事「Antigravityの概要」で比較します。

ワークフロー＝工場の製造ライン¶

布を切る → 縫う → 綿を詰める → ボタンをつける → 完成

特徴： - 固定された手順 - クマを作るラインでは、クマしか作れない - ウサギを作りたければ、ライン全体を組み替える必要がある

スキル＝職人の技術¶

「今日はウサギお願い」
  ↓
職人が道具を使い分けて作る
  ↓
「明日はネコで」
  ↓
同じ職人が別のものを作る

特徴： - 柔軟に対応できる - わざわざライン（手順）を作り直さなくていい - 職人（AI）が状況に合わせて判断する

5. スキルの内部構造¶

SKILL.md の役割¶

スキルの中核は SKILL.md（Markdownファイル）です。

my-skill/
  ├── SKILL.md          # 必須：名札＋使い方の説明
  ├── scripts/          # オプション：LLMが実行するスクリプト
  └── resources/        # オプション：テンプレート・参照ドキュメント

scripts/ にPythonやBashスクリプトを置くと、LLMが直接行うことが困難な処理（API呼び出し、データ変換など）を委任できます。まずはSKILL.mdだけで始めて、必要に応じて拡張する進め方が効率的です。

SKILL.mdファイルには2つの部分があります：

【パート1】名札（フロントマター）¶

---
name: code-review-skill
description: コードレビュースキルです。
              バグチェック、スタイル確認、
              パフォーマンス検査を自動実行します。
---

【パート2】使い方の説明（本文）¶

# コードレビュースキル

このスキルは、提出されたコードに対して以下を自動実行します：

## 実行内容
1. バグ・セキュリティ脆弱性の検出
2. コーディング規約の確認
3. パフォーマンス解析
4. 改善提案の作成

## 入力形式
ユーザーからコードのテキストを受け取る

## 出力形式
レビューレポート（Markdown形式）

6. なぜ「名札（description）」が重要なのか¶

AIエージェントの選択プロセス¶

あなたが何か頼むたびに、AIエージェントはこの順番で動きます：

1️⃣ 「名札だけ」を全スキル高速スキャン
   ↓
2️⃣ 「これが使えそう！」と判断
   ↓
3️⃣ その時だけ中身（SKILL.md 本文）を詳しく読む
   ↓
4️⃣ 実行

問題：悪い名札ではAIが見逃す¶

❌ 悪い例

description: PDFを扱います

→ 何ができるのか曖昧。AIは別のスキルを選ぶかもしれない

✅ 良い例

description: PDFファイルからテキストデータのみを抽出し、
              メタデータ・レイアウト情報は除外します。
              文字起こしやテキスト分析の事前処理に最適。

→ 具体的で、いつ使うかが明確。AIが確実に選ぶ

7. スキルはどう実行されるのか¶

実際のフロー¶

【あなた】
「画像を生成して」と指示

  ↓

【AIエージェント】
① 全スキルの「名札」をスキャン
② 「image-generate-skill」が使えそう
③ その SKILL.md の本文を読む
④ 書いてある手順通りに実行開始
   - 画像サイズ確認
   - スタイル指定
   - 生成実行
⑤ 完成した画像をあなたに届ける

全部自動です。

8. スキルを作る—驚くほどシンプル¶

魔法の言葉¶

Antigravityのチャットで、これだけ言ってください：

「○○をするエージェントスキルを作って」

実例¶

「画像を生成するエージェントスキルを作って」

「PDFからテキストを抽出するエージェントスキルを作ってください」

「コードレビュー用のエージェントスキルを作成して」

これだけで、AIが勝手にフォルダもファイルも作ってくれます。プログラミング知識一切不要。

自分の作業から提案を得る¶

何を作ればいいかわからないなら：

「僕の開発プロセスを見て、
 どんなエージェントスキルがあれば便利だと思いますか？」

AIがあなたの普段の作業パターンを分析して、提案します。

9. スキルの保存場所—2つのオプション¶

オプション1：プロジェクト専用¶

my-project/
  └── .agent/
      └── skills/
          └── my-skill/
              └── SKILL.md

特徴 - このプロジェクトでだけ使える - チーム全員が同じスキルを使える - バージョン管理（Git）できる

オプション2：全体共有¶

ホームディレクトリ/
  └── .gemini/
      └── antigravity/
          └── skills/
              └── my-skill/
                  └── SKILL.md

特徴 - 全てのプロジェクトで使える - 自分専用の便利ツール - どのプロジェクトからでもアクセス

10. スキルのメリット整理¶

✅ 同じ説明を何度もしなくていい¶

❌ 従来: 「ここを確認して、このチェックして、
        あの方法でテストして...」
        × 毎回これを説明

✅ スキル: 「テストして」
         × 一度の言葉で完了

✅ 作業が一貫する¶

AIが毎回同じやり方で作業するので、品質が安定します。

1日目のコードレビュー ≈ 2日目のコードレビュー
（バラつきが少ない）

✅ チームで共有できる¶

プロジェクトのフォルダに入れれば、全員が同じスキルを使用。

「あのスキル知ってる？」で統一できる

✅ 学習コストが低い¶

コードを書く必要なし。AIに「作って」と頼むだけ。

11. 実際の使用例¶

ケース1：コードレビュー¶

スキルなし¶

「このコードをレビューして。
 - バグがないか
 - スタイルは適切か
 - パフォーマンスの問題はないか
 この3点を確認して」

毎回これを説明する手間

スキルあり¶

「このコード、レビューして」

自動で「コードレビュースキル」が起動

スキルの内部

「コードレビュースキル」の SKILL.md には、あらかじめこの3点が定義されている：

1. バグ・セキュリティチェック
2. スタイル確認（PEP8など）
3. パフォーマンス解析

ケース2：画像生成¶

スキルなし¶

「1024x768のPNG画像を生成して。
 背景は白で、
 中央に商品を配置...」

毎回細かく指定する

スキルあり¶

「商品画像を作って」

AIが「画像生成スキル」の定義からあなた好みのサイズ・形式を自動選択

12. スキルのカスタマイズ¶

基本：SKILL.md を編集¶

---
name: my-skill
description: 新しい説明文
---

# スキル名

改善内容をここに書く

AIに改善を頼む¶

うまくいかなければ、Antigravityで：

「このスキルをもっとこうしてください」

AIが SKILL.md を自動更新します。

13. 間違いやすい点¶

Q1: プログラミング知識は必須？¶

A. 不要です。AIが全て作ります。

Q2: スキルはいくつまで作れる？¶

A. 技術的な上限はありません。ただし、インストール済みスキル全てのメタデータがセッション開始時に読み込まれるため、スキルが多いほどトークン消費量が増えます。無関係なスキルが自動発動するリスクも高まるため、必要なスキルだけを厳選してインストールすることを推奨します。

Q3: 他の人のスキルを使える？¶

A. はい。公開されているスキルをダウンロードして使用可能です。GitHubでは800以上のスキルを収録したコレクションや、厳選されたコミュニティライブラリも公開されています。セクション17「次のステップ」にリンクを掲載しています。

Q4: 日本語でもいい？¶

A. もちろん。日本語で SKILL.md を書いてOK。

Q5: スキルとワークフロー、どちらを使うべき？¶

A. Antigravityでは「ワークフロー」は .agent/workflows/ に配置する定型手順ファイル（Markdownで手順を記述）を指します。

スキル：AIが状況判断して自動選択・柔軟に実行（例：コードレビュー）
ワークフロー：決まった手順を順番通りに実行（例：デプロイ手順、リリースフロー）

繰り返す作業でもAIの判断が必要ならスキル、毎回同じステップを確実に踏みたいならワークフローが適しています。

Q6: セキュリティは大丈夫？¶

A. スクリプトを含むスキルはターミナルコマンドの実行やファイルの変更が可能です。信頼できないソースからのスキル導入時は、SKILL.mdとscripts/の内容を必ず確認してください。 特にターミナル操作やインフラ変更を含むスキルには注意が必要です。

セキュリティのベストプラクティス

ターミナルやインフラの変更を提案するスキルには、SKILL.md内に「Safety」セクションを追加し、実行前の確認事項を明記することが推奨されています。

14. スキルの実装フロー（完全版）¶

ステップ1：スキルの構想¶

「僕は毎日こういう作業をしてる：
  - PDFを読む
  - テキスト抽出
  - 形式整形
  - DBに保存
これをスキル化したい」

ステップ2：スキル作成依頼¶

Antigravityで：

「PDFテキスト抽出スキルを作ってください」

ステップ3：自動生成¶

my-project/
  └── .agent/
      └── skills/
          └── pdf-extract-skill/
              └── SKILL.md

AI が SKILL.md を自動作成

ステップ4：使用開始¶

「このPDFからテキスト抽出して」

AIが「pdf-extract-skill」を自動選択→実行

ステップ5：微調整（必要に応じて）¶

「もっと日本語に最適化して」

SKILL.md が自動更新

15. スキルを支える仕組み¶

AIエージェントが確実にスキルを選ぶための工夫¶

1. 名札の具体性¶

# 🔴 曖昧
description: "テキストを処理します"

# 🟢 具体的
description: "日本語テキストから固有表現を抽出し、
              人名・地名・組織名で分類します。
              NER（固有表現認識）が必要なタスクに最適。"

2. 役割の明確化（「使うとき」と「使わないとき」）¶

SKILL.md の本文に「いつ使うか」と「いつ使わないか」の両方を明記するのがベストプラクティスです。「Do not use」セクションがないと、関連性の低いリクエストでもスキルが自動発動してしまう問題が起きます。

# PDF抽出スキル

## このスキルを使うべき状況
- 大量のPDFからテキストを抽出したい
- テーブル構造を保持したい
- 日本語ドキュメントを扱っている

## このスキルを使うべきでない状況
- 画像化されたPDF（OCR不要）
- 複雑なレイアウト保持が必須
- 単純なテキストファイルの処理（PDFではない場合）

過剰発動を防ぐコツ

descriptionにも「Use when you need to ...」「Do not use for ...」のように具体的な条件を書くと、AIの判断精度が大幅に向上します。

16. まとめ：スキルが変える未来¶

従来の働き方¶

あなた：「○○して」と毎回指示
AI：毎回一から指示を理解

結果：面倒で、一貫性も低い

これからの働き方（スキル活用）¶

あなた：「○○して」と簡潔に指示
AI：「あ、××スキルだ」と自動判断
  →スキルの定義通りに実行
  →一貫性も高い

結果：簡潔で、品質も安定

スキルの価値¶

側面	メリット
効率	同じ説明を何度もしない
品質	AIの動作が一貫する
学習コスト	プログラミング知識不要
共有	チーム全体で使える
柔軟性	新しいスキルをすぐ作れる
互換性	オープンスタンダードとして他のAIツールでも利用可能

SKILL.mdはオープンスタンダード

Agent Skillsは主要なAIエージェントプラットフォームが採用しているオープンフォーマットです。SKILL.mdで定義したスキルは、Antigravityだけでなく、同フォーマットをサポートする他のAIコーディングアシスタントでもそのまま利用できます。

17. 次のステップ¶

すぐやること¶

Google Antigravity 公式サイトをチェック
最初のスキルを作成: 「簡単なスキルを作ってください」と依頼
実際に使ってみる：「○○してください」と指示

コミュニティスキルを活用する¶

ゼロから作らなくても、コミュニティが公開しているスキルを導入するだけですぐに使えます。

GitHubのスキルコレクション：800以上のスキルが公開されており、用途別に検索可能
厳選ライブラリ：コミュニティが「バッテリー同梱」の体験を提供する50以上のスキルセット
他ツールからの移植：Claude Code等のスキルをAntigravity形式にポートしたリポジトリも存在

GitHubで「agent skills」「antigravity skills」等で検索すると最新のコレクションが見つかります。

詳しく学ぶ¶

Google Antigravity徹底レビューで全体像を理解
公式ドキュメント（https://antigravity.google/docs/skills）で詳細確認
コミュニティ（X・Hacker News）で最新情報をキャッチ

スキル活用のコツ

最初は「1つのスキル」から始める「いつ使うのか」を明確に SKILL.md に書く失敗を恐れず、AIに改善を頼むチームで使えるスキルを共有する

あなたの開発プロセスも、スキルで革新してみませんか？

Google Antigravity の『スキル』とは？ 初心者向け完全ガイド¶

1. Antigravityとスキルの基本関係¶

従来のツールとの違い¶

2. スキルとは何か——シンプルな定義¶

Core Concept¶

具体的には何か¶

3. スキルが何をするのか¶

スキルなし：毎回同じ説明¶

スキルあり：一度の指示で全て¶

4. ワークフロー vs スキル—ぬいぐるみ工場の例え¶

ワークフロー＝ 工場の製造ライン¶

スキル＝ 職人の技術¶

5. スキルの内部構造¶

SKILL.md の役割¶

【パート1】名札（フロントマター）¶

【パート2】使い方の説明（本文）¶

6. なぜ「名札（description）」が重要なのか¶

AIエージェントの選択プロセス¶

問題：悪い名札ではAIが見逃す¶

7. スキルはどう実行されるのか¶

実際のフロー¶

8. スキルを作る—驚くほどシンプル¶

魔法の言葉¶

実例¶

自分の作業から提案を得る¶

9. スキルの保存場所—2つのオプション¶

オプション1：プロジェクト専用¶

オプション2：全体共有¶

10. スキルのメリット整理¶

✅ 同じ説明を何度もしなくていい¶

✅ 作業が一貫する¶

✅ チームで共有できる¶

✅ 学習コストが低い¶

11. 実際の使用例¶

ケース1：コードレビュー¶

スキルなし¶

スキルあり¶

ケース2：画像生成¶

スキルなし¶

スキルあり¶

12. スキルのカスタマイズ¶

基本：SKILL.md を編集¶

AIに改善を頼む¶

13. 間違いやすい点¶

Q1: プログラミング知識は必須？¶

Q2: スキルはいくつまで作れる？¶

Q3: 他の人のスキルを使える？¶

Q4: 日本語でもいい？¶

Q5: スキルとワークフロー、どちらを使うべき？¶

Q6: セキュリティは大丈夫？¶

14. スキルの実装フロー（完全版）¶

ステップ1：スキルの構想¶

ステップ2：スキル作成依頼¶

ステップ3：自動生成¶

ステップ4：使用開始¶

ステップ5：微調整（必要に応じて）¶

15. スキルを支える仕組み¶

AIエージェントが確実にスキルを選ぶための工夫¶

1. 名札の具体性¶

2. 役割の明確化（「使うとき」と「使わないとき」）¶

16. まとめ：スキルが変える未来¶

従来の働き方¶

これからの働き方（スキル活用）¶

スキルの価値¶

17. 次のステップ¶

すぐやること¶

コミュニティスキルを活用する¶

詳しく学ぶ¶

Google Antigravity の『スキル』とは？初心者向け完全ガイド¶

ワークフロー＝工場の製造ライン¶

スキル＝職人の技術¶