概要
このリポジトリには、再利用可能な Google 製品およびクラウドテクノロジーの Agent スキルが収録されており、Gemini API、BigQuery の基礎、Cloud Run などをカバーし、開発者がエージェントに素早く機能を追加できるよう支援します。
README プレビュー
# Agent Skills\n\n[](https://skills.sh/google/skills)\n\nThis repository contains [Agent Skills](https://agentskills.io/home) for Google\nproducts and technologies, including [Google Cloud](https://cloud.google.com).\n\n> [!NOTE]\n> This repository is under active development.\n\n## Installation\n\n```bash\nnpx skills add google/skills\n```\n\nFrom the `npx install` command, you can select the specific skills from this\nrepo to install.\n\n## Available Skills\n\n- [**Gemini API on Agent Platform**](./skills/cloud/gemini-api)\n- [**Gemini Interactions API on Agent Platform**](./skills/cloud/gemini-api)\n- [**Managed Agents API on Agent Platform**](./skills/cloud/gemini-agents-api)\n- [**Skill Registry API on Agent Platform**](./skills/cloud/agent-platform-skill-registry)\n- [**AlloyDB Basics**](./skills/cloud/alloydb-basics)\n- [**BigQuery Basics**](./skills/cloud/bigquery-basics)\n- [**Cloud Run Basics**](./skills/cloud/cloud-run-basics)\n- [**Cloud SQL Basics**](./skills/cloud/cloud-sql-basics)\n- [**Firebase Basics**](./skills/cloud/firebase-basics)\n- [**Kubernetes Engine (GKE) Basics**](./skills/cloud/gke-basics)\n- [**Recipe: Onboarding to Google Cloud**](./skills/cloud/google-cloud-recipe-onboarding)\n- [**Recipe: Authenticating to Google Cloud**](./skills/cloud/google-cloud-recipe-auth)\n- [**Recipe: Google Cloud Network Observability**](./skills/cloud/google-cloud-networking-observability)\n- **Google Cloud Well-Architected Framework**:\n - [Security](./skills/cloud/google-cloud-waf-security)\n - [Reliability](./skills/cloud/google-cloud-waf-reliability)\n - [Cost optimization](./skills/cloud/google-cloud-waf-cost-optimization)\n - [Operational excellence](./skills/cloud/google-cloud-waf-operational-excellence)\n - [Performance optimization](./skills/cloud/google-cloud-waf-performance-optimization)\n - [Sustainability](./skills/cloud/google-cloud-waf-sustainability)\n\n## Support\n\nIf you need help or encounter
FAQ (3)
トラブル対応google-ads-api-account-diagnostics スキルのインストール時に発生する YAML パースエラー「Nested mappings are not allowed in compact mappings」の修正方法
このエラーは、skills/ads/google-ads-api-account-diagnostics/SKILL.md のフロントマター内の compatibility 行にクォートされていないコロン（tools: search, ...）が含まれており、YAML がそれをネストされたマッピングとして解釈するために発生します。このバグはコミット 300d74bfee で導入され、コミット 6f82b205c0acbe185ce513ce0390bc4b57caa877 で修正されました。google/skills リポジトリを最新バージョンに更新してから、次を再実行してください: npx skills add google/skills --skill google-ads-api-account-diagnostics -g -y。独自の SKILL.md を管理していてこのエラーに遭遇した場合は、コロンを含むフロントマターの値をクォートしてください。例: compatibility: "Google Ads MCP Server (tools: search, list_accessible_customers, get_resource_metadata); ..."
トラブル対応Claude Codeでgoogle-cloud-developer Developer Knowledge MCPサーバーが「Failed to connect」と表示されたり、認証資格情報が不足したりする問題を修正するにはどうすればよいですか？
Claude Code プラグインの mcp.json は、API キーヘッダーや OAuth 設定なしで https://developerknowledge.googleapis.com/mcp を登録しますが、ツール呼び出しには Google 認証が必要です。
回避策: developerknowledge.googleapis.com に制限された API キーを使って、MCP サーバーを自分で登録します:
claude mcp add --transport http --scope user google-dev-knowledge \
https://developerknowledge.googleapis.com/mcp \
--header "X-Goog-Api-Key: YOUR_API_KEY"--header オプションは、サーバー名と URL の後に指定する必要があります。Claude Code を再起動し、次のコマンドで確認します:
claude mcp listプラグインに同梱されている developer-knowledge エントリーは引き続き "Failed to connect" と表示される場合がありますが、無害です。プラグインのスキルは、別途登録した google-dev-knowledge サーバーを使用できます。
テスト目的に限り、エンドポイントは短期間有効な gcloud トークンも受け付けます:
curl -X POST https://developerknowledge.googleapis.com/mcp \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'プラグインの恒久的な修正としては、mcp.json に環境変数で展開される X-Goog-Api-Key ヘッダーを追加する、OAuth ディスカバリーをサポートする、あるいは認証なしのサーバーエントリーを削除して curl によるフォールバックを使用する、といった方法が考えられます。
トラブル対応references/ ディレクトリ内の相対 Markdown リンクが GitHub 上で references/references/ として 404 になるのはなぜですか？
リンク元のファイルはすでに references/ の中にあるため、[Guide](references/ima-sdk-ios-guide.md) のようなリンクは references/references/ima-sdk-ios-guide.md に解決されてしまいます。references/ プレフィックスを削除し、同階層のファイルに直接リンクしてください: [Guide](ima-sdk-ios-guide.md)。壊れたリンクは次のコマンドで見つけられます:
grep -rnE '\]\(references/' skills/*/*/references/*.md影響を受ける各ファイルに修正を適用してください。例:
<!-- 修正前 -->
[iOS Guide](references/ima-sdk-ios-guide.md)
<!-- 修正後 -->
[iOS Guide](ima-sdk-ios-guide.md)一括置換は次のコマンドで実行できます:
find skills -path '*/references/*.md' -exec perl -pi -e 's/\]\(references\//](/g' {} +対象ファイルを移動する必要はありません。誤っているのはリンクのプレフィックスのみです。この問題はコミット a54d506fb1ae95870e10cbf5cf1660f3af0bdc8b で修正されました。