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.

referencesPRD.md

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

PRD: ADK Deployment Specialist

Version: 2.1.0 Author: Jeremy Longshore jeremy@intentsolutions.io Status: Active Marketplace: tonsofskills.com by Intent Solutions Portfolio: jeremylongshore.com


Problem Statement

Deploying ADK multi-agent systems to Vertex AI Agent Engine involves coordinating multiple complex surfaces: agent orchestration patterns (Sequential/Parallel/Loop), A2A protocol endpoints, Code Execution Sandbox configuration, Memory Bank state management, and IAM/networking setup. Getting any one of these wrong causes silent failures, broken inter-agent communication, or security vulnerabilities. Developers spend hours debugging deployment issues that stem from misconfigured agent contracts or missing A2A endpoints.

Target Users

User Context Primary Need
AI Engineer Building a new multi-agent system for production deployment End-to-end deployment from local agent code to live Agent Engine endpoints
Platform Engineer Migrating existing agents from local dev to Agent Engine Reliable deployment pipeline with endpoint validation and rollback guidance
DevOps Engineer Setting up CI/CD for agent deployments Automated deployment commands with health checks and observability hooks

Success Criteria

  1. Deploy an ADK agent to Agent Engine with verified A2A endpoints in under 15 minutes
  2. All A2A protocol endpoints (AgentCard, task send, task status) respond correctly post-deployment
  3. Code Execution Sandbox configured with 7-14 day TTL and SECURE_ISOLATED sandbox type
  4. Memory Bank enabled with minimum 100-memory retention and Firestore encryption
  5. Deployment includes observability: structured logging, retry/backoff, and health monitoring
  6. Agent package excludes test files and dev dependencies (minimized cold start)

Functional Requirements

  1. Confirm the desired architecture (single vs multi-agent) and orchestration pattern (Sequential/Parallel/Loop)
  2. Define AgentCard and A2A interfaces: inputs, outputs, task submission, and status polling contracts
  3. Implement agent(s) with the minimum required tool surface including Code Execution Sandbox and Memory Bank as needed
  4. Test locally with representative prompts and failure cases, then generate smoke tests for post-deploy
  5. Deploy to Vertex AI Agent Engine using the Python SDK (vertexai.Client.agent_engines.create())
  6. Validate deployed endpoints: /.well-known/agent-card, POST /v1/tasks:send, GET /v1/tasks/<id>
  7. Configure observability: structured logs, Cloud Monitoring dashboards, and retry/backoff for transient failures

Non-Functional Requirements

  • All deployments use OIDC/WIF for authentication; never commit long-lived service account keys
  • Agent packages must exclude test files and dev dependencies to minimize cold start time
  • Deployment commands must be idempotent (safe to re-run without side effects)
  • Support for both greenfield deployments and updates to existing Agent Engine instances
  • Local tests must pass before any deployment attempt (fail-fast principle)
  • All generated code must include error handling for transient failures (retries with backoff)
  • Deployment scripts must provide clear rollback instructions if validation fails

Dependencies

  • Google Cloud project with Vertex AI API enabled and Agent Engine permissions
  • ADK installed and pinned to the project's supported version
  • Python SDK google-cloud-aiplatform[agent_engines]>=1.120.0
  • gcloud CLI authenticated with deployment permissions
  • A test runner (pytest) available in the repository

Out of Scope

  • Infrastructure provisioning with Terraform (handled by adk-infra-expert)
  • Post-deployment inspection and scoring (handled by vertex-engine-inspector)
  • CI/CD pipeline creation for GitHub Actions (handled by gh-actions-validator)
  • Cost optimization and model selection strategy
  • Agent application logic design (handled by adk-engineer)
  • Multi-region deployment with traffic splitting

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