GoogleがGoogle Agent Skillsの品質ゲートを紹介、6つの自動ゲートで検証を実現

Google Agent Skillsの変更の検証

Google Agent Skillsの教訓の一つは、スキルを一度きりの文書でなく更新を続ける製品と捉え、すべてのスキル更新を製品のリリースのように出すことです。文書は人に概念を説明しますが、スキルはAIエージェントの推論の流れやツールの選択、実行の経路を方向付けます。^[1]

変更ごとに求める3つの要件

スキル内の不適切な言い回しは、無効なコマンドフラグの呼び出しや無限ループ、トークンの浪費を招くことがあります。このため指示の編集はすべて動作の変更であり、Google Agent Skillsは製品の更新と同じくスキルもテストせずに出すべきではないとしています。

図1　変更ごとに求める3つの要件

評価レポートの比較相手は、既存のスキルなら前の版、新しいスキルならスキルを持たないエージェントです。リンターとバリデータの確認は、人やAIのレビュー担当者が変更を見る前に行われます。

GitHub公開前に通るゲート

作成者が社内のスキルリポジトリに変更を出すと、CI/CD（継続的インテグレーションと継続的デリバリー）のパイプラインがすぐに動きます。GitHubへ出す前に通る6つの自動ゲートは、以下の通りです。

スキルは6つの自動ゲートに加えて、分野の専門家である人のレビュー担当者による最終承認を受ける必要があります。6つの自動ゲートには、スキルの品質と設計基準を確かめるAIレビューエージェントも含まれます。

SKILL.mdでのスキルの版番号の規則

各スキルは、SKILL.mdのフロントマターにあるメタデータで、セマンティックバージョンの版番号を宣言します。新しいスキルは1.0.0から始め、既存スキルの指示やスクリプト、参照の変更には版番号の更新が必要です。^[1]

図2　版番号の更新ルール

版番号は引用符で囲んだ文字列で書く必要があり、自動チェックがその形式を確かめます。YAMLは2.0のような引用符の無い値を数値として読み、文字列を期待するツールで予期しない解析エラーを起こすためです。

版番号を宣言するフロントマターの例は、以下の通りです。

---
name: spanner-basics
metadata:
  version: "1.1.1"
  category: Databases
description: ...
---

公式資料からの抜粋：Behind the scenes, two months later: How we ship Google Agent Skills like products（Automated conformance gates: The pull request pipeline / Semantic versioning）。対象版・範囲：原記事の記載時点。

上記のコードでは、spanner-basicsという名前のスキルが、metadataのversionに"1.1.1"を引用符付きで指定しています。同じmetadataの下には、categoryとしてDatabasesも指定されています。

Google Agent Skillsの自動検証の主な項目

自動検証はプルリクエストごとに構造と構文の正しさを確かめ、バリデータは評価スイートの規則を確かめます。リンク検証は、統合前に相対リンクを確かめ、毎週月曜には公開リポジトリの外部リンクも調べます。^[1]

構造と構文の自動検証の規則

Google Agent Skillsの自動検証は、プルリクエストごとに構造と構文の正しさを確かめます。規則の一部は、以下の通りです。

index.jsonは、機械が読み取れる形式で管理される登録簿を指します。メインのREADME.mdとindex.jsonが最新の状態かどうかも、自動検証の確認対象です。

評価スイートの検証項目

Google Agent Skillsの継続的な評価は、各スキルを使った場合と使わない場合で、エージェントの性能を比べます。評価スイートに壊れたファイル参照や複合的な期待値があると、テスト結果はぶれて信頼できなくなります。

バリデータが評価スイートとプルリクエストの説明文を解析して確かめる条件は、以下の通りです。

複合的な期待値は、作成者が分割するまでバリデータが受け付けません。作成者はレビューの指摘を受けて、プルリクエストを繰り返し手直しするのが一般的です。

リンク検証の2つの段階

Google Agent Skillsの170を超えるスキルは、変化の速いGoogle製品のドキュメントへリンクしています。リンク先のページは審査を通った後にも移動することがあり、利用者からの報告を待たずに2つの段階で検証する仕組みです。

図3　リンク検証を行う2つの時点

毎週月曜には、GitHub Actionsのワークフローがlycheeで公開リポジトリの外部リンクを調べます。壊れたリンクは、修正のためにスキルの所有者へ報告されます。

Google Agent Skillsの版管理と更新

Google Agent Skillsのスキルは裏で自動更新されないため、エージェントがスキルを呼び出すたびのネットワーク確認や遅れはありません。版番号は実行時のモデルではなく、開発者とパッケージツールに向けたものです。^[1]

図4　公開リポジトリとバージョン管理の概要

公開リポジトリの場所は、github.com/google/skillsです。開発者は、ローカルに入れたスキルの版番号を上流のカタログと比べ、npx skills updateなどで取り込む時期を決められます。^[1][2]

版番号は、欠かせないスキルを既知の正常な版に固定し、プロジェクトをまたいでエージェントの動作を再現したいチームの運用も支えるものです。2026年8月4日時点の公開ルールでは、GitHubへの公開時に内部資産や所有者情報、評価スイートが取り除かれます。

Google Agent Skillsの検査を自前リポジトリへ

自前のスキルリポジトリに同様のゲートを取り入れる場合は、人やAIの審査より前に、決まった規則で判定できる検査を置く順序が一つの選択肢です。Google Agent Skillsでは、人やAIの審査前にリンターやバリデータが変更案を確かめ、GitHubへ出す前のスキルは人の最終承認を受ける必要があります。^[1]

図5　自動の検査を先に置く順序の例

SKILL.mdを書いて手で試す進め方は、1人の開発者や小さなプロジェクトには分かりやすい方法です。Google Agent Skillsの規模では手作業が効かず、確認されていない編集が細かな不具合を持ち込む可能性があり、問題を利用者に届く前に見つけにくくなります。

Google Agent Skillsの公開スキルをローカルに入れて使う場合は、取り込む前にローカルと上流のカタログの版番号を比べる手順が考えられます。公開スキルを自前で評価したい場合は、2026年8月4日時点のルールで評価スイートが公開時に除かれる点を前提に、評価の方法を確かめる順序が選択肢です。