Community생산성 & 협업github.com

google/adk-scaffold

ADK 에이전트 프로젝트를 생성하거나 개선하기 전에 반드시 읽어야 할 스킬입니다. 사용자가 새로운 에이전트(예: "검색 에이전트를 만들어 줘")를 구축하거나 기존 프로젝트를 개선(예: "내 프로젝트에 CI/CD를 추가해 줘", "RAG를 추가해 줘")하려고 할 때 사용하세요.

adk-scaffold란 무엇인가요?

이 스킬은 Google ADK (Agent Development Kit)를 기반으로 한 에이전트 프로젝트를 생성하거나 개선할 때 반드시 참조해야 하는 핵심 지침을 제공합니다. AI 어시스턴트 (예: Claude Code, Cursor)가 사용자의 요청에 따라 새로운 에이전트를 처음부터 구축하거나, 기존 프로젝트에 CI/CD, RAG (Retrieval-Augmented Generation), API 통합 등의 기능을 추가할 때 이 스킬을 먼저 읽어야 합니다. 스킬은 ADK 프로젝트의 표준 구조, 설정 파일, 의존성 관리 방법, 배포 전략 등을 상세히 설명하여 일관성 있고 유지보수 가능한 코드를 생성하도록 돕습니다. Google ADK의 공식 문서를 기반으로 하며, Cursor, Claude Code, Codex 등 다양한 AI 코딩 에이전트 플랫폼에서 사용할 수 있습니다. 이 스킬을 통해 에이전트 개발자는 빠르게 프로토타입을 만들고, 팀 내 표준화된 개발 방식을 따를 수 있습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/google/adk-docs/tree/main/skills/adk-scaffold

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

adk-scaffold은(는) 무엇을 하나요?

ADK 에이전트 프로젝트를 생성하거나 개선하기 전에 반드시 읽어야 합니다. 사용자가 새로운 에이전트(예: "검색 에이전트를 만들어 줘")를 구축하거나 기존 프로젝트를 개선(예: "내 프로젝트에 CI/CD를 추가해 줘", "RAG를 추가해 줘")하려고 할 때 사용하세요.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

google/adk-cheatsheet

MUST READ before writing or modifying ADK agent code. ADK API quick reference for Python — agent types, tool definitions, orchestration patterns, callbacks, and state management. Includes an index of all ADK documentation pages. Do NOT use for creating new projects (use adk-scaffold).

google/adk-deploy-guide

MUST READ before deploying any ADK agent. ADK deployment guide — Agent Engine, Cloud Run, GKE, CI/CD pipelines, secrets, observability, and production workflows. Use when deploying agents to Google Cloud or troubleshooting deployments. Do NOT use for API code patterns (use adk-cheatsheet), evaluation (use adk-eval-guide), or project scaffolding (use adk-scaffold).

google/adk-dev-guide

ALWAYS ACTIVE — read at the start of any ADK agent development session. ADK development lifecycle and mandatory coding guidelines — spec-driven workflow, code preservation rules, model selection, and troubleshooting.

google/adk-eval-guide

MUST READ before running any ADK evaluation. ADK evaluation methodology — eval metrics, evalset schema, LLM-as-judge, tool trajectory scoring, and common failure causes. Use when evaluating agent quality, running adk eval, or debugging eval results. Do NOT use for API code patterns (use adk-cheatsheet), deployment (use adk-deploy-guide), or project scaffolding (use adk-scaffold).

google/adk-observability-guide

MUST READ before setting up observability for ADK agents or when analyzing production traffic, debugging agent behavior, or improving agent performance. ADK observability guide — Cloud Trace, prompt-response logging, BigQuery Agent Analytics, third-party integrations, and troubleshooting. Use when configuring monitoring, tracing, or logging for agents, or when understanding how a deployed agent handles real traffic.

관련 스킬