# Google Agents CLI Scaffold

Should be used when the user wants to "create an agent project", "start a new ADK...

- Repository: https://github.com/google/agents-cli (6276 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-10-27
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add google/agents-cli --skill google-agents-cli-scaffold -g -a claude-code -y`
Codex: `npx skills add google/agents-cli --skill google-agents-cli-scaffold -g -a codex -y`
Cursor: `npx skills add google/agents-cli --skill google-agents-cli-scaffold -g -a cursor -y`
Gemini CLI: `npx skills add google/agents-cli --skill google-agents-cli-scaffold -g -a gemini-cli -y`

## Description

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 agents-cli 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 (ADK projects: use google-agents-cli-adk-code) or deployment operations (use google-agents-cli-deploy).

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Project Scaffolding Guide

> **Requires:** `agents-cli` (`uv tool install google-agents-cli`), [install uv](https://docs.astral.sh/uv/getting-started/installation/index.md) first if needed.

Use the `agents-cli` CLI to create new agent projects or enhance existing ones with deployment, CI/CD, and infrastructure scaffolding.

---

## Prerequisite: Clarify Requirements (MANDATORY for new projects)

**Before scaffolding a new project, load `/google-agents-cli-workflow` and complete Phase 0**, clarify the user's requirements before running any `scaffold create` command. Ask what the agent should do, what tools/APIs it needs, and whether they want a prototype or full deployment.

---

## Step 1: Choose Architecture

**Mapping user choices to CLI flags:**

| Choice | CLI flag |
|--------|----------|
| Retrieval/RAG, sandboxed execution, cross-session memory, OAuth consent, guardrails, scheduled runs | **No flag**, these come from clone-and-study recipes. **ADK Python:** see the topic index in `/google-agents-cli-adk-code` → `references/recipes.md`; on other frameworks, see the agent catalog the framework template ships |
| A2A protocol | built into the scaffolded app, scaffold normally (**ADK Python:** `--agent adk_python`, the default; **ADK Go:** `--agent adk_go`) |
| Prototype (no deployment) | `--prototype` |
| Deployment target | `--deployment-target <agent_runtime\|cloud_run\|gke>` |
| CI/CD runner | `--cicd-runner <github_actions\|google_cloud_build>` |
| Session storage | `--session-type <in_memory\|cloud_sql\|agent_platform_sessions>` |

### Product name mapping

Current names (and older names users may say) → CLI values (`vertexai` SDK package name unchanged):

The rest: https://github.com/google/agents-cli/blob/HEAD/skills/google-agents-cli-scaffold/SKILL.md