Molayo

© 2026 Molayo

Qiita헤드라인2026. 06. 09. 08:47

Google가 공개한 공식 Skills (google/skills)로 무엇을 할 수 있는가

요약

Google이 에이전트 개발자를 위해 공개한 공식 Agent Skills 리포지토리를 소개합니다. Gemini CLI, Claude Code 등 AI 코딩 도구에서 사용할 수 있는 Markdown 기반의 지시 사항 패키지로, Google Cloud 서비스 조작 및 Gemini API 활용법을 에이전트에게 학습시킵니다.

핵심 포인트

  • Markdown 기반의 SKILL.md 파일을 통해 에이전트에게 기술 조작법 학습
  • Gemini CLI, Claude Code, Cursor 등 주요 AI 코딩 도구와 호환
  • BigQuery, Cloud Run, GKE 등 Google Cloud 서비스 관리 스킬 제공
  • Gemini API의 올바른 SDK 및 인증 설정 가이드 포함

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의 주요 서비스를 에이전트가 정확하게 조작할 수 있도록 하는 스킬입니다.

스킬명개요
bigquery-basics데이터셋, 테이블, 작업(job) 관리, BigQuery ML · Gemini 통합을 통한 고도화된 분석, 시계열 예측 (TimesFM) · 이상 탐지까지 대응
cloud-run-basicsCloud Run으로의 컨테이너 배포 · 서비스 관리
cloud-sql-basicsCloud SQL의 데이터베이스 생성 · 접속 · 관리
alloydb-basicsAlloyDB의 조작 · 쿼리 · 관리
firebase-basicsFirebase 앱의 개발 · 설정 · 관리
gke-basicsGoogle Kubernetes Engine의 클러스터 조작 · 배포 관리
gcloudgcloud 명령어의 올바른 사용법 · 자주 사용하는 패턴

「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 선택 · 모델 선택 지침이 포함되어 있습니다.

스킬명개요
gemini-apiAgent Platform (GEAP)에서 Gemini API를 사용할 때의 설정. 사용해야 할 SDK · 인증 · 권장 모델을 지정
gemini-interactions-apiGemini Interactions API 사용법
gemini-agents-apiManaged Agents API 사용법
  • 사용하는 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) 상에서 에이전트를 구축하고 운영하기 위한 스킬입니다.

스킬명개요
agent-platform-deploy에이전트의 GEAP 배포 방법
agent-platform-eval-flywheel에이전트의 평가 및 개선 사이클 운영 방법
agent-platform-model-registry모델 레지스트리 (Model Registry) 관리
agent-platform-prompt-management프롬프트 (Prompt) 관리 방법
agent-platform-rag-engine-managementRAG 엔진 구축 및 관리
agent-platform-skill-registrySkill Registry API 사용법
agent-platform-tuning파인튜닝 (Fine-tuning) 실시 방법
agent-platform-tuning-management파인튜닝 작업 (Job) 관리

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

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

스킬명WAF 원칙개요
google-cloud-waf-security보안 (Security)IAM 설계 · VPC · 데이터 보호의 베스트 프랙티스
google-cloud-waf-reliability신뢰성 (Reliability)가용성 · 장애 대응 · SLO 설계 가이드라인
google-cloud-waf-cost-optimization비용 최적화 (Cost Optimization)리소스 낭비 방지법 · 비용 절감 기법
google-cloud-waf-operational-excellence운영 탁월성 (Operational Excellence)모니터링 · 자동화 · DevOps 실천
google-cloud-waf-performance-optimization성능 (Performance)스케일링 · 레이턴시 (Latency) 최적화
google-cloud-waf-sustainability지속 가능성 (Sustainability)탄소 발자국(Carbon Footprint) 저감 · 에너지 절약 설계

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

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

스킬명개요
google-cloud-recipe-onboardingGCP를 처음 사용할 때의 셋업 절차 · 초기 설정
google-cloud-recipe-authGoogle Cloud 인증 설계 패턴 모음 (IAM · Workload Identity · ADC 등)
google-cloud-networking-observability네트워크 모니터링 · 가시화 실전 방법

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

BigQuery 스킬이 있는 경우

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

Gemini API 스킬이 있는 경우

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

WAF-Security 스킬이 있는 경우

"이 GCP 구성을 보안 관점에서 리뷰해줘"
→ Google Cloud WAF의 보안 원칙에 기반한 리뷰를 실시
카테고리스킬 수적합한 용도
Google Cloud 제품 스킬7종BigQuery · Cloud Run · GKE 등의 일상적인 조작
...

설치는 npx skills add google/skills

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

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

・bigquery-basics

・waf-security

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

참고

AI 자동 생성 콘텐츠

본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0