개요
이 저장소는 Gemini API, BigQuery 기초, Cloud Run 등을 포함하는 재사용 가능한 Google 제품 및 클라우드 기술 Agent 스킬을 수록하고 있으며, 개발자가 에이전트에 기능을 빠르게 추가할 수 있도록 도와줍니다.
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 스킬을 설치할 때 발생하는 "Nested mappings are not allowed in compact mappings" YAML 파싱 오류를 해결하는 방법
이 오류는 skills/ads/google-ads-api-account-diagnostics/SKILL.md frontmatter의 compatibility 줄에 따옴표로 묶이지 않은 콜론(tools: search, ...)이 포함되어 있어 YAML이 이를 중첩 매핑으로 해석하기 때문에 발생합니다. 이 버그는 커밋 300d74bfee에서 도입되었으며 커밋 6f82b205c0acbe185ce513ce0390bc4b57caa877에서 수정되었습니다. google/skills 리포지토리의 최신 버전으로 업데이트한 다음 다시 실행하세요: npx skills add google/skills --skill google-ads-api-account-diagnostics -g -y. 자체 SKILL.md를 유지 관리하면서 이 오류가 발생하는 경우 콜론이 포함된 frontmatter 값을 따옴표로 묶으세요. 예: 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영향을 받는 각 파일에 수정 사항을 적용하세요. 예를 들면 다음과 같습니다:
<!-- Before -->
[iOS Guide](references/ima-sdk-ios-guide.md)
<!-- After -->
[iOS Guide](ima-sdk-ios-guide.md)일괄 치환은 다음 명령으로 실행할 수 있습니다:
find skills -path '*/references/*.md' -exec perl -pi -e 's/\]\(references\//](/g' {} +대상 파일은 이동할 필요가 없으며, 링크 접두사만 잘못된 것입니다. 이 이슈는 커밋 a54d506fb1ae95870e10cbf5cf1660f3af0bdc8b에서 수정되었습니다.