Back to Skills

google-agents-cli-scaffold

This skill should be used when the user wants to "create an agent project", "start a new ADK project", "build me a new agent", "add CI/CD to my project", "add deployment", "enhance my project", or "upgrade my project". Part of the Google ADK (Agent Development Kit) skills suite. Covers `agents-cli scaffold create`, `scaffold enhance`, and `scaffold upgrade` commands, template options, deployment targets, and the prototype-first workflow. Do NOT use for writing agent code (use google-agents-cli-a

2,079stars246forksUpdated 5/6/2026

Security Assessment

Safe(90/100)

Detected risks:

Sensitive File Access([SKILL.md] .env)
Security Score90/100

About google-agents-cli-scaffold

The `google-agents-cli-scaffold` skill is designed to streamline the creation and enhancement of agent projects within the Google ADK (Agent Development Kit) ecosystem. It addresses the challenges of setting up new agent projects, integrating CI/CD pipelines, managing deployment targets, and scaffolding infrastructure without requiring users to manually configure project directories or write repetitive boilerplate code. By providing a structured CLI-based workflow, this skill ensures consistency, reduces setup time, and supports both prototype-first and fully deployable project structures.

The main capabilities of this skill include scaffolding new projects via the `agents-cli scaffold create` command, enhancing existing projects with deployment and CI/CD integrations using `scaffold enhance`, and upgrading project configurations with `scaffold upgrade`. It supports multiple agent architectures, such as RAG (retrieval-augmented generation) with vector or document search, A2A protocols, and prototype projects. Users can specify deployment targets like agent runtime, Cloud Run, or GKE, configure CI/CD runners (GitHub Actions or Cloud Build), and select session storage options. Additionally, the skill provides guidance for mapping user terminology to the correct CLI flags and integrates seamlessly with the prototype-first workflow.

This skill is ideal for developers, AI engineers, and technical teams working with the ADK who need to quickly initialize projects or improve existing ones. Typical use cases include creating a new agent project from scratch, adding deployment capabilities, integrating CI/CD pipelines, or upgrading the infrastructure and configuration of existing projects. It is particularly useful for teams adopting a prototype-first approach, allowing them to validate ideas quickly before moving to full deployment, while ensuring compatibility with the Gemini Enterprise Agent Platform and related tools.

FAQ

Do I need to install any tools before using this skill?

Yes, you must have `agents-cli` installed. You can install it via `uv tool install google-agents-cli`. Ensure you have the UV tool installed first if needed.

Can I use this skill to write agent code?

No, this skill is specifically for scaffolding and enhancing projects. To write agent code, you should use `google-agents-cli-adk-code`.

What deployment targets are supported?

Supported deployment targets include `agent_runtime`, `cloud_run`, and `gke`. You can specify the target using the `--deployment-target` flag.

Are there any constraints on project names?

Yes, project names must be 26 characters or less and can only contain lowercase letters, numbers, and hyphens.

How does the skill handle existing projects?

You can enhance existing projects using `agents-cli scaffold enhance`. Ensure you specify the correct agent directory if code is not in `app/` to prevent misplacement of files.

All Files

2 files
SKILL.md11.2 KB
View
references/flags.md3.4 KB
View

Install google-agents-cli-scaffold

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill