skilld
All skills
google avatar

/google-agents-cli-scaffold

@2c39459
by googlegoogle/agents-cli6k stars
686

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).

Requires /google-agents-cli-workflow /google-agents-cli-adk-code /google-agents-cli-deploy /google-agents-cli-eval

Ask your Agent

Use this Skill: https://skilld.dev/gh/google/agents-cli/google-agents-cli-scaffold

This session only. Nothing lands on disk.

referencesflags.md

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

Command Flag Reference

agents-cli scaffold create Flags

Flag Short Default Description
--agent -a adk Agent template — local name (adk for Python, adk_go for Go), local path (local@/path), adk-samples shortcut (adk@<name>, legacy python/agents/ tree only), or remote Git URL
--deployment-target -d agent_runtime Deployment target (agent_runtime, cloud_run, gke, none)
--region us-east1 GCP region
--prototype -p off Skip CI/CD and Terraform (recommended for first pass)
--session-type — Session storage (in_memory, cloud_sql, agent_platform_sessions). Use with cloud_run or gke targets (Agent Runtime manages sessions itself).
--cicd-runner — CI/CD runner (github_actions, google_cloud_build, skip)
--agent-directory -dir app/ Custom agent code directory inside the project
--agent-guidance-filename GEMINI.md Coding agent guidance file (GEMINI.md, CLAUDE.md, or AGENTS.md)
--output-dir -o . Output directory for the project
--bq-analytics off Enable BigQuery Agent Analytics plugin (supported on agent_runtime, cloud_run, and gke)
--skip-checks -s off Skip verification checks for GCP and Agent Platform
--adk off Quickstart mode: adk + agent_runtime + prototype, skips prompts. It forces --agent adk (Python). For a Go quickstart use --agent adk_go --prototype --yes instead.
--auto-approve / --yes -y off Non-interactive: skip prompts, use defaults for missing params
--interactive -i off Interactive mode: show menus and prompts (for use in terminals)

For all available flags, run agents-cli scaffold create --help.

ADK-specific: --adk is a shortcut for the built-in ADK template, and adk is the only built-in one. --agent also takes a template repo (<org>/<repo>[/<path>]@<tag> or local@<path>), which is how other frameworks ship.

To use Google AI Studio instead of Vertex AI, edit the generated .env: comment the GOOGLE_* lines and uncomment GEMINI_API_KEY.

agents-cli scaffold enhance Flags

Flag Short Default Description
--deployment-target -d — Add deployment target (agent_runtime, cloud_run, gke, none)
--cicd-runner — Add CI/CD runner (github_actions, google_cloud_build, skip)
--agent-directory -dir app/ Agent code directory. Pass if not using the default.
--session-type — Session storage (in_memory, cloud_sql, agent_platform_sessions)
--region us-east1 GCP region
--dry-run off Preview changes without applying them (requires saved metadata)
--force off Force overwrite all files (skip smart-merge comparison)
--prefer-new off Resolve conflicts in favor of the new template version
--agent-guidance-filename GEMINI.md Coding agent guidance file (e.g. CLAUDE.md for Claude Code)
--bq-analytics off Add BigQuery Agent Analytics plugin
--skip-checks -s off Skip verification checks for GCP and Agent Platform
--prototype -p off Prototype mode (skips CI/CD runner prompt)
--auto-approve / --yes -y off Non-interactive: skip prompts, use defaults for missing params
--interactive -i off Interactive mode: show menus and prompts (for use in terminals)

For all available flags, run agents-cli scaffold enhance --help.

Source: SKILL.md on GitHub

Third-party checks

No alertstoday3 checks · Risk SAFE
  • Gen Agent Trust Hubtoday

    This skill provides a structured guide for using the `agents-cli` tool to scaffold and manage agent projects. It incorporates security-focused workflows, such as mandatory requirement clarification and user confirmation before executing commands. All external tool references align with the vendor's ecosystem.

  • Sockettoday

    No alerts

  • Snyktoday

    Risk: LOW · No issues

Provenance

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

Last checked against GitHub 2 days ago.

Activeupdated 2 days ago

Capability

Other metadata
metadata
{
  "author": "Google",
  "license": "Apache-2.0",
  "version": "1.8.0",
  "requires": {
    "bins": [
      "agents-cli"
    ],
    "install": "uv tool install google-agents-cli"
  }
}

README badge

README badge for google/agents-cli/google-agents-cli-scaffold