google-agents-cli-scaffold

Creates and enhances Google ADK agent projects with deployment and CI/CD scaffolding via agents-cli.

Updated Dec 9, 2025
One-click install
npx skills add https://github.com/Aki2022/skills --skill google-agents-cli-scaffold-aki2022
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-agents-cli-scaffold
Source: https://github.com/Aki2022/skills/tree/main/google-agents-cli-scaffold
Command: npx skills add https://github.com/Aki2022/skills --skill google-agents-cli-scaffold-aki2022

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Setting up a new agent project involves wiring together templates, deployment targets, CI/CD pipelines, and session storage by hand. This Skill drives the agents-cli scaffold commands to create, enhance, and upgrade agent projects with the correct flags and constraints, avoiding misconfigured infrastructure. ## Core Features & Use Cases - Project Creation: Run agents-cli scaffold create with the right template, deployment target (Agent Runtime, Cloud Run, GKE), region, and prototype mode, while respecting naming constraints and CLI execution modes. - Enhancement & Upgrade: Add deployment targets or CI/CD runners (GitHub Actions, Google Cloud Build) to existing projects with scaffold enhance, and migrate projects to newer agents-cli versions with scaffold upgrade. - Prototype-First Workflow: Start with --prototype to skip CI/CD and Terraform, iterate on agent code, then add deployment later. - Use Case: A user asks to "build me a new agent deployed to Cloud Run" — the Skill clarifies requirements, scaffolds the ADK project with the correct flags, and hands off to the development workflow. ## Quick Start Ask the assistant to create a new ADK agent project with a chosen deployment target, and it will clarify your requirements before running the appropriate agents-cli scaffold command.

Frequently Asked Questions about google-agents-cli-scaffold

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new ADK agent project with agents-cli?

Run agents-cli scaffold create with a project name, the --agent adk template, and optionally a deployment target and region. The project name must be 26 characters or fewer using lowercase letters, numbers, and hyphens, and you must not create the directory beforehand.

How do I add deployment or CI/CD to an existing agent project?

Use agents-cli scaffold enhance from inside the project directory with --deployment-target (agent_runtime, cloud_run, or gke) or --cicd-runner (github_actions or google_cloud_build). If your agent code is not in app/, pass --agent-directory with the correct path.

What deployment targets does agents-cli scaffold support?

The supported targets are agent_runtime (managed Vertex AI Agent Runtime), cloud_run, gke (GKE Autopilot), and none for code-only scaffolding. All targets are container-based and include a Dockerfile.

Should I use prototype mode when scaffolding an agent project?

Yes, starting with --prototype is the recommended pattern because it skips CI/CD and Terraform so you can focus on the agent code first. You can add deployment later with agents-cli scaffold enhance.

Why does agents-cli scaffold create fail when I mkdir the project directory first?

The CLI creates the project directory itself, so pre-creating it causes the command to fail or switch into enhance mode unexpectedly. Run scaffold create directly and let the CLI generate the directory.

Can I scaffold agent frameworks other than ADK with agents-cli?

Only adk is a built-in template. Other frameworks ship as template repositories you reference directly with --agent, such as the first-party LangChain template at google/agents-cli/extensions/langchain/template.