adk-agent-builder
Build production-ready AI agents using Google's Agent Development Kit with Claude integration, React patterns, multi-agent orchestration, and comprehensive tool libraries
When & Why to Use This Skill
The ADK Agent Builder is a specialized Claude skill designed to accelerate the development of production-ready AI agents using Google's Agent Development Kit (ADK). It provides automated scaffolding, sophisticated multi-agent orchestration patterns (ReAct, Sequential, Parallel), and seamless deployment paths to Vertex AI Agent Engine. By integrating tool wiring, testing frameworks, and deployment verification, it enables developers to build robust, scalable agentic workflows with enterprise-grade reliability.
Use Cases
- 1. Rapid Agent Scaffolding: Quickly generate standardized project structures including tool registries, configuration files, and dependency management for new AI agent projects.
- 2. Multi-Agent Orchestration: Design and implement complex systems where multiple specialized agents (e.g., supervisor, worker, and verifier) collaborate through defined sequential or parallel workflows.
- 3. Vertex AI Deployment: Streamline the transition from local development to cloud production by generating deployment commands and post-deployment validation checklists for Google Cloud's Agent Engine.
- 4. Automated Testing and Reliability: Implement comprehensive unit tests, smoke prompts, and error-handling strategies to manage tool failures, rate limits, and authentication issues effectively.
| name | adk-agent-builder |
|---|---|
| description | | |
| allowed-tools | Read, Write, Edit, Grep, Bash(cmd:*) |
| version | 1.0.0 |
| author | Jeremy Longshore <jeremy@intentsolutions.io> |
| license | MIT |
ADK Agent Builder
Build production-ready agents with Google’s Agent Development Kit (ADK): scaffolding, tool wiring, orchestration patterns, testing, and optional deployment to Vertex AI Agent Engine.
Overview
- Creates a minimal, production-oriented ADK scaffold (agent entrypoint, tool registry, config, and tests).
- Supports single-agent ReAct-style workflows and multi-agent orchestration (Sequential/Parallel/Loop).
- Produces a validation checklist suitable for CI (lint/tests/smoke prompts) and optional Agent Engine deployment verification.
Prerequisites
- Python runtime compatible with your project (often Python 3.10+)
google-adkinstalled and importable- If deploying: access to a Google Cloud project with Vertex AI enabled and permissions to deploy Agent Engine runtimes
- Secrets available via environment variables or a secret manager (never hardcoded)
Instructions
- Confirm scope: local-only agent scaffold vs Vertex AI Agent Engine deployment.
- Choose an architecture:
- Single agent (ReAct) for adaptive tool-driven tasks
- Multi-agent system (specialists + orchestrator) for complex, multi-step workflows
- Define the tool surface (built-in ADK tools + any custom tools you need) and required credentials.
- Scaffold the project:
src/agents/,src/tools/,tests/, and a dependency file (pyproject.tomlorrequirements.txt)
- Implement the minimum viable agent and a smoke test prompt; add regression tests for tool failures.
- If deploying, produce an
adk deploy ...command and a post-deploy validation checklist (AgentCard/task endpoints, permissions, logs).
Output
- A repo-ready ADK scaffold (files and directories) plus starter agent code
- Tool stubs and wiring points (where to add new tools safely)
- A test + validation plan (unit tests and a minimal smoke prompt)
- Optional: deployment commands and verification steps for Agent Engine
Error Handling
- Dependency/runtime issues: provide pinned install commands and validate imports.
- Auth/permission failures: identify the missing role/API and propose least-privilege fixes.
- Tool failures/rate limits: add retries/backoff guidance and a regression test to prevent recurrence.
Examples
Example: Scaffold a single ReAct agent
- Request: “Create an ADK agent that summarizes PRs and proposes test updates.”
- Result: agent entrypoint + tool registry + a smoke test command for local verification.
Example: Multi-agent orchestrator
- Request: “Build a supervisor + deployer + verifier team and deploy to Agent Engine.”
- Result: orchestrator skeleton, per-agent responsibilities, and
adk deploy ...+ post-deploy health checks.
Resources
- Full detailed guide (kept for reference):
{baseDir}/references/SKILL.full.md - Repo standards (source of truth):
000-docs/6767-a-SPEC-DR-STND-claude-code-plugins-standard.md000-docs/6767-b-SPEC-DR-STND-claude-skills-standard.md
- ADK / Agent Engine docs: https://cloud.google.com/vertex-ai/docs/agent-engine