ADK Agent Builder

adk-agent-builder

Build production-ready AI agents using Google's Agent Development Kit with AI assistant integration, React patterns, multi-agent orchestration, and comprehensive tool libraries. Use when appropriate context detected. Trigger with relevant phrases based on skill purpose.

Dicklesworthstone/pi_agent_rust·0installs1.8Kstars

SKILL.md

Full skill instructions

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-adk installed 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.toml or requirements.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.md
- 000-docs/6767-b-SPEC-DR-STND-claude-skills-standard.md
ADK / Agent Engine docs: https://cloud.google.com/vertex-ai/docs/agent-engine

Install skill

Copy and run in your terminal

npx -y skills add https://github.com/Dicklesworthstone/pi_agent_rust --skill adk-agent-builder

View on GitHub

tests/ext_conformance/artifacts/plugins-community/plugins/jeremy-google-adk/skills/adk-agent-builder/SKILL.md

deepgram-hello-world
Create a minimal working Deepgram transcription example. Use when starting a new Deepgram integration, testing your setup, or learning basic Deepgram API patterns. Trigger with phrases like "deepgram hello world", "deepgram example", "deepgram quick start", "simple transcription", "transcribe aud...
0 installs
interactive-shell
Cheat sheet + workflow for launching interactive coding-agent CLIs (Claude Code, Gemini CLI, Codex CLI, Cursor CLI, and pi itself) via the interactive_shell overlay or headless dispatch. Use for TUI agents and long-running processes that need supervision, fire-and-forget delegation, or headless b...
0 installs
documenso-prod-checklist
Execute Documenso production deployment checklist and rollback procedures. Use when deploying Documenso integrations to production, preparing for launch, or implementing go-live procedures. Trigger with phrases like "documenso production", "deploy documenso", "documenso go-live", "documenso launc...
0 installs
interactive-portfolio
Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities. Use when: portfolio, personal website, sho...
0 installs