Index of every page on this site: llms.txt
All skills
jeremylongshore avatar

/adk-deployment-specialist

@820dfc8
Run it yourself

Deploy and orchestrate Vertex AI ADK agents using A2A protocol. Manages AgentCard discovery, task submission, Code Execution Sandbox, and Memory Bank. Use when asked to "deploy ADK agent" or "orchestrate agents". Trigger with phrases like 'deploy', 'infrastructure', or 'CI/CD'.

Use this Skill: https://skilld.dev/gh/jeremylongshore/tons-of-skills-marketplace/adk-deployment-specialist

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

referencesARD.md

≈1.2k tokens on demand. Your agent reads this file only when SKILL.md points to it.

ARD: ADK Deployment Specialist

Part of Tons of Skills by Intent Solutions | jeremylongshore.com

System Context

The ADK Deployment Specialist bridges local ADK agent development and production Agent Engine hosting. It interacts with the local codebase for implementation, the ADK SDK for agent construction, and Google Cloud for deployment and validation.

Local Agent Code
       ↓
[ADK Deployment Specialist]
  ├── Reads: agent source, configs, requirements
  ├── Writes: agent code, deploy scripts, smoke tests
  └── Calls: pytest, ADK CLI, Python SDK, gcloud, curl
       ↓
Vertex AI Agent Engine
  ├── AgentCard endpoint
  ├── Task Send/Status APIs
  ├── Code Execution Sandbox
  └── Memory Bank

Data Flow

  1. Input: Agent name or project ID, desired architecture (single/multi-agent), orchestration pattern, and tool requirements from user request
  2. Processing: Scaffold or patch agent code with A2A interfaces, configure Code Execution Sandbox (TTL 7-14 days, SECURE_ISOLATED), set up Memory Bank if stateful conversations needed, run local tests, then deploy via vertexai.Client().agent_engines.create() with validated requirements
  3. Output: Deployed agent with verified A2A endpoints, deployment confirmation with endpoint URLs, health check commands, and observability configuration (logs, dashboards, retry policies)

Key Design Decisions

Decision Choice Rationale
Python SDK for deployment vertexai.Client().agent_engines.create() No gcloud CLI surface for Agent Engine; SDK provides full control
A2A-first interface design Define AgentCard + task contracts before implementation Ensures inter-agent compatibility and testable contracts
Local-first testing Run all tests locally before any cloud deployment Catches issues early; avoids costly failed deployments
Sandbox defaults TTL 7-14 days, SECURE_ISOLATED type Balances state retention with security; matches Google's recommended production config
Sequential orchestration as starting point Default to SequentialAgent for multi-agent flows Predictable debugging path; upgrade to Parallel/Loop when performance requires it
Requirements isolation Production deps only in deployed package Test and dev deps increase package size and cold start time without benefit
Smoke tests for validation Automated endpoint verification post-deploy Catches deployment issues immediately rather than waiting for user traffic

Tool Usage Pattern

Tool Purpose
Read Inspect existing agent code, A2A contracts, deployment configs, and requirements files
Write Create agent entrypoints, tool modules, deploy scripts, and smoke test files
Edit Patch existing agents to add A2A endpoints, fix deployment issues, update requirements
Grep Search for import patterns, API usage, credential references, and configuration values
Glob Discover project structure — agent files, test suites, deployment artifacts
Bash(cmd:*) Run pytest, ADK commands, Python SDK deployment, gcloud IAM setup, curl for endpoint validation

Error Handling Strategy

Error Class Detection Recovery
Package dependency conflict pip install or Agent Engine returns requirements parse error Pin all deps with == versions; remove local paths from requirements.txt
Agent Engine creation timeout SDK call exceeds 300s without completion Reduce package size (exclude tests/docs); retry in us-central1 for best capacity
A2A endpoint 404 curl to /.well-known/agent-card returns 404 Verify agent is configured for A2A protocol; check A2A enablement in agent config
IAM permission denied PermissionDenied during deployment or endpoint access Grant roles/aiplatform.user and roles/aiplatform.deployer to the deploying identity
Memory Bank initialization failure Memory Bank returns errors or empty state Verify Firestore is provisioned in the project; check Memory Bank API enablement

Extension Points

  • Custom orchestration patterns: replace Sequential with Parallel or Loop agents by changing the pipeline definition
  • Additional A2A endpoints: extend the agent card with custom capabilities and task types
  • CI/CD integration: wrap deployment commands in GitHub Actions with WIF authentication (see gh-actions-validator)
  • Blue-green deployment: deploy new version alongside existing, validate, then switch traffic
  • Multi-region deployment: extend deploy scripts to target multiple regions with traffic splitting
  • Automated rollback: add rollback scripts that revert to previous agent version on validation failure
  • Custom health checks: extend post-deploy validation with application-specific probes beyond A2A endpoints

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

2 warnings2mo3 checks · Risk MEDIUM
  • Gen Agent Trust Hub2mo

    The skill is designed for deploying Google Vertex AI agents and includes scripts for deployment and protocol testing. While generally functional, it contains a testing utility that retrieves sensitive GCP access tokens and sends them to a URL provided at runtime, which presents a risk of data exfiltration if directed to a malicious endpoint. Additionally, the deployment script dynamically loads and executes code from local directories.

  • Socket2mo

    2 alerts: gptAnomaly

  • Snyk2mo

    Risk: LOW · No issues

Signed by skilld at 820dfc8. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub yesterday.

Activeupdated last month
What it can do
Reads files Edits files Runs commands
version
2.30.0
author
Jeremy Longshore <jeremy@intentsolutions.io>
effort
high
All 6 allowed tools
ReadWriteEditGrepGlobBash(cmd:*)
Other metadata
argument-hint
<agent-name or project-id>
tags
[
  "ai",
  "deployment",
  "ci-cd"
]
compatibility
Designed for Claude Code

README badge

README badge for jeremylongshore/tons-of-skills-marketplace/adk-deployment-specialist