Google Cloud Next 2026(2026년 4월)에서, Google이 공식 Agent Skills 리포지토리(repository)를 공개했습니다.

Gemini나 ADK를 사용해 에이전트(Agent) 개발을 하고 있는 사람, 혹은 Gemini CLI나 Claude Code와 같은 AI 코딩 도구를 사용하는 사람을 위해 Google이 준비한 「에이전트용 Google Cloud 전용 문서 모음」입니다.

이 기사에서는 「무엇이 설치되는가」, 「설치하면 무엇을 할 수 있게 되는가」를 모든 스킬(Skill) 단위로 정리합니다.

참고: 이 기사는 github.com/google/skills의 공식 README, 각 SKILL.md 파일, Google Cloud 공식 블로그를 바탕으로 작성되었습니다. 2026년 6월 시점에서 스킬 수는 27종입니다 (Next 2026 발표 당시에는 13종이었으며 이후 확충되었습니다).

Agent Skills는 AI 에이전트에게 「특정 서비스와 기술을 어떻게 사용하는지」를 가르치는 Markdown 기반의 문서 패키지입니다. SKILL.md라는 파일에 지시 사항, 코드 스니펫(code snippet), 참고 리소스가 정리되어 있으며, 에이전트는 이를 읽고 정확한 조작 방법을 학습합니다.

Gemini CLI, Claude Code, Antigravity, GitHub Copilot, Cursor 등 주요 AI 코딩 도구에서 사용할 수 있습니다.

npx skills add google/skills

실행하면 27개의 스킬 중에서 사용하고 싶은 것을 선택하여 설치할 수 있습니다.

스킬은 4개의 카테고리로 나뉘어 있습니다.

Google Cloud의 주요 서비스를 에이전트가 정확하게 조작할 수 있도록 하는 스킬입니다.

「Manages datasets, tables, and jobs in BigQuery, and integrates with BigQuery ML and Gemini for advanced data analytics」

참조 리소스로 다음 8가지 토픽이 포함되어 있습니다: 핵심 개념, CLI 조작, 클라이언트 라이브러리 (Python/Java 등), Terraform, IAM/보안, AI 예측 · 이상 탐지 · 텍스트 생성 기능

Gemini API를 올바르게 사용하기 위한 설정 · SDK 선택 · 모델 선택 지침이 포함되어 있습니다.

• 사용하는 SDK:
  반드시 google-genai (Python) 또는 @google/genai (JS/TS)를 사용해야 하며, google-cloud-aiplatform 등의 레거시(legacy) SDK는 금지됩니다.
• 인증 설정:
  GOOGLE_CLOUD_PROJECT, GOOGLE_CLOUD_LOCATION, GOOGLE_GENAI_USE_ENTERPRISE=true를 환경 변수로 설정
• 권장 모델: 복잡한 추론 → gemini-3.1-pro-preview, 범용 → gemini-3.5-flash, 경량 작업 → gemini-3.1-flash-lite, 이미지 생성 → gemini-3-pro-image. gemini-2.0, gemini-1.5 등의 레거시 모델은 권장되지 않습니다.

Gemini API를 사용한 코드를 작성할 때, 에이전트가 이 스킬을 보유하고 있다면 오래된 SDK나 권장되지 않는 모델을 제안받는 일 없이, 최신의 올바른 방식으로 코드를 생성해 줍니다.

GEAP(Gemini Enterprise Agent Platform) 상에서 에이전트를 구축하고 운영하기 위한 스킬입니다.

실제 운영 환경의 에이전트를 GEAP 상에서 운용하는 개발자를 위한 내용입니다.

Google Cloud의 Well-Architected Framework (WAF) 6대 원칙에 대응하는 베스트 프랙티스(Best Practices) 모음입니다.

"이 Cloud Run 아키텍처를 WAF의 비용 최적화 관점에서 어떻게 개선할 수 있을까?"와 같은 질문에 에이전트가 적절히 답변할 수 있게 됩니다.

특정 시나리오를 위한 실전 레시피 모음입니다.

스킬을 설치한 에이전트(예: Gemini CLI)에 대해 다음과 같은 질문이나 요청을 높은 정확도로 수행할 수 있게 됩니다.

BigQuery 스킬이 있는 경우

"매출 데이터를 BigQuery에 임포트하고, 월별 집계 쿼리를 작성해줘"
→ 올바른 bq 커맨드 · 스키마 정의 · SQL을 생성

Gemini API 스킬이 있는 경우

"Gemini API를 사용한 챗봇 코드를 작성해줘"
→ 최신 google-genai SDK를 사용하여, 올바른 인증 · 모델 지정 코드를 생성
(오래된 vertexai 패키지나 폐기된 모델은 사용하지 않음)

WAF-Security 스킬이 있는 경우

"이 GCP 구성을 보안 관점에서 리뷰해줘"
→ Google Cloud WAF의 보안 원칙에 기반한 리뷰를 실시

설치는 npx skills add google/skills

한 줄의 명령어로 사용하고 싶은 스킬만 선택하여 설치할 수 있습니다. Gemini CLI는 물론, Claude Code · GitHub Copilot · Cursor에서도 사용할 수 있습니다.

Google Cloud를 다룰 기회가 많은 개발자라면, gemini-api

・bigquery-basics

・waf-security

이 3가지만이라도 설치해 둘 가치가 있습니다.

참고