Official agent skill

Scaffold Python ADK Recipe

by google in google/adk-recipes

Creates a new Python recipe for the ADK recipes repository by running a scaffold script that copies template files, after confirming the output directory and recipe name.

OfficialApache-2.0Auto-check passedDevelopment

Install Scaffold Python ADK Recipe

skills CLI
$ npx skills add google/adk-recipes --skill scaffold-python-recipe -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install google/adk-recipes scaffold-python-recipe --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/google/adk-recipes.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/scaffold-python-recipe .claude/skills/scaffold-python-recipe && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
scaffold-python-recipe
GitHub stars
10k
Token cost
~931 tokens
SKILL.md length
432 words
Files
25 (incl. scripts)
Skills in repo
14
Repo updated
First seen
Licence
Apache-2.0

At a glance

Creates a new Python recipe for the ADK recipes repository by running a scaffold script that copies template files, after confirming the output directory and recipe name.

  • Works in 2 steps: Output Directory (Required — must ask if… → Recipe Name (Required — must ask if not…
  • Starting a new Python recipe in contrib/python
  • SKILL.md covers Rules, Inputs, Run and Respond
  • Runs Python scripts from its folder; calls uv and python3

What it does

This skill creates a new Python ADK recipe inside the adk-recipes repository by running scripts/scaffold.py, never by writing boilerplate files by hand. The agent must have two inputs first and ask if either is missing: an output directory, chosen from contrib/python/ (community recipes, preferred), core/python/ (curated) or the legacy flat contrib/, and a recipe name made only of lowercase letters and hyphens, at most 30 characters, not starting or ending with a hyphen. An invalid name is explained and a corrected one requested.

The script takes exactly two flags, --name and --output-dir, and copies a template tree that includes an app with an agent module, a FastAPI-style app file and telemetry helpers, a manifest.yaml, pyproject.toml, a README, an .env.example and an eval setup with a basic evalset. After it succeeds, the agent tells you the recipe is ready and lists the next steps, making no further changes in that turn. Everything it creates is called a recipe, never a project, and vertical plugins under plugins/ are out of scope because no template for them exists yet.

When your agent uses it

  • Starting a new Python recipe in contrib/python
  • Adding a curated recipe under core/python
  • Checking whether a proposed recipe name is valid

Example prompts

  • “Scaffold a new Python recipe called support-triage in contrib/python.”
  • “Create a curated Python recipe named invoice-reader under core/python.”
  • “Is Invoice_Reader_v2 a valid name for a new recipe?”

Requirements

  • Python 3 to run scripts/scaffold.py
  • A checkout of the adk-recipes repository

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Output Directory (Required — must ask if not provided)
  2. Recipe Name (Required — must ask if not provided)

What it can do on your machine

Read from SKILL.md and the folder at commit fa9bdde. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • uv
    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Scaffold Python ADK Recipe loads about 931 tokens when it runs. Until then it costs about 89 tokens; SKILL.md has 432 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~89
When it runs · the whole SKILL.md, loaded when a task matches
~931

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from google/adk-recipes at commit fa9bdde, republished under its Apache-2.0 licence (© google). 432 words, ~931 tokens.

Download SKILL.mdSave it as .claude/skills/scaffold-python-recipe/SKILL.md (or your agent's skills folder). This skill also uses 24 other files; get the full folder from GitHub.
name
scaffold-python-recipe
description
This skill should be used when the user wants to "create a new Python ADK recipe", "scaffold a new Python recipe", "generate a new Python recipe in contrib", "add a new Python recipe to the adk-recipes repository", or "create a Python adk recipe". It utilizes an automated script to copy template files and resolve basic placeholders.
metadata.author
Google
metadata.license
Apache-2.0
metadata.version
1.0.0

Scaffolding a New Python ADK Recipe

Use this skill to scaffold a new Python ADK recipe inside this repository using the automated script at scripts/scaffold.py.


Rules

  1. No Manual Boilerplate Writing: Always use scripts/scaffold.py to create the recipe. Never write the boilerplate files manually.
  2. Do Not Modify After Scaffolding: Once the script runs successfully, do not make any further changes to the recipe in this turn.
  3. Use the Correct Terminology (Recipe): Always refer to what is being created as a recipe, never as a "project". Ensure all output messages, instructions, and explanations to the user use "recipe" exclusively.

Inputs

You must have both pieces of information below before running the script. If either is missing or was not explicitly provided by the user, ask for it — do not assume or use a default.

1. Output Directory (Required — must ask if not provided)

The user must choose one of these valid locations:

  • contrib/python/ — community recipes; preferred for new Python recipes
  • core/python/ — curated recipes
  • contrib/ — legacy flat layout, still accepted; prefer contrib/python/

If the user has not specified which directory, ask them to choose. Do not proceed until a valid choice is confirmed.

This skill cannot scaffold a vertical plugin (plugins/<vertical>/<solution>/). Those have a different shape — SKILL.md, EVAL.yaml, scripts/, assets/, references/, tests/unit/ — and no template ships for them yet. If the user asks for one, tell them so rather than scaffolding into the wrong place.

Show full SKILL.md (197 more words)Show less
2. Recipe Name (Required — must ask if not provided)

The recipe name must satisfy all of the following rules:

  • Contains only lowercase letters and hyphens (a-z, -)
  • Is 30 characters or less
  • Does not start or end with a hyphen

If the user provided a name, validate it against these rules before proceeding. If it is invalid, explain which rule it violates and ask for a corrected name. Do not proceed until a valid name is confirmed.


Run

Execute the scaffold script:

bash
python3 .agents/skills/scaffold-python-recipe/scripts/scaffold.py --name <RECIPE_NAME> --output-dir <OUTPUT_DIRECTORY>

The script accepts exactly two flags: --name (required) and --output-dir (required). Do not pass any other flags.


Respond

Once the script succeeds, inform the user the recipe is ready and highlight the following required next steps:

  1. Update manifest.yaml: Fill in the description, ownership.team, and ownership.poc fields (placeholders are marked with TODO:). This file is validated by CI and must not contain placeholder values. Use the generate-manifest skill if you want it populated automatically from the source code.
  2. Update README.md: Replace the generic title and description with details specific to this recipe (ownership/POC live in manifest.yaml, above — not in the README).

Then, provide these quick-start commands:

bash
cd <OUTPUT_DIRECTORY>/<RECIPE_NAME>
uv sync                  # install dependencies
uv run pytest            # run the test suite
uv run adk run app       # run the agent interactively

Do not make any further changes. End your turn.

© google, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 24 other files (scripts) in .agents/skills/scaffold-python-recipe of google/adk-recipes.

  • SKILL.md
  • resources/templates/.env.example
  • resources/templates/README.md
  • resources/templates/app/__init__.py
  • resources/templates/app/agent.py
  • resources/templates/app/app_utils/__init__.py
  • resources/templates/app/app_utils/telemetry.py
  • resources/templates/app/app_utils/typing.py
  • resources/templates/app/fast_api_app.py
  • resources/templates/manifest.yaml
  • resources/templates/pyproject.toml
  • resources/templates/tests/eval/eval_config.json
  • resources/templates/tests/eval/evalsets/README.md
  • resources/templates/tests/eval/evalsets/basic.evalset.json
  • … and 11 more

Open the folder on GitHubat commit fa9bdde

Compare with similar skills

Scaffold Python ADK Recipe next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Scaffold Python ADK Recipe compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Scaffold Python ADK Recipe this skillgoogle/adk-recipes10k—~931Automated safety check: PassApache-2.0
Mirage VFS Adapter Authoringstrukto-ai/mirage3.7k—~2.4kAutomated safety check: PassApache-2.0
CLI-Anything for CodexHKUDS/CLI-Anything52k—~1.5kAutomated safety check: PassApache-2.0
CLI-Anything for ReasonixHKUDS/CLI-Anything52k—~1.8kAutomated safety check: PassApache-2.0
README and DESIGN Generatorfengshao1227/ccg-workflow5.9k—~410Automated safety check: NotesMIT
Project Scaffolderpretend1111/claude-desktop-app4941 repos~498Automated safety check: PassCustom licence

Similar skills

  • Builds or extends a custom Mirage virtual filesystem adapter for an API, database, object store or app data, with a working mount configuration and filesystem tests.

    3.7k GitHub stars~2.4k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • CLI-Anything for Codex

    HKUDS/CLI-Anything

    Lets Codex build, refine, test, validate and list CLI-Anything harnesses for GUI applications or source repositories, following the project's full methodology.

    52k GitHub stars~1.5k tokensUpdated 16 days ago
    DevelopmentAuto-check passed
  • CLI-Anything for Reasonix

    HKUDS/CLI-Anything

    Adapts the CLI-Anything methodology so Reasonix can build, refine, test and validate a command-line harness for an existing GUI application or source repository.

    52k GitHub stars~1.8k tokensUpdated 16 days ago
    DevelopmentAuto-check passed
  • README and DESIGN Generator

    fengshao1227/ccg-workflow

    Generates README.md and DESIGN.md skeletons for a module by scanning its structure with a Node script, then lists what to fill in by hand.

    5.9k GitHub stars~410 tokensUpdated 22 days ago
    DevelopmentAuto-check: notes
  • Project Scaffolder

    pretend1111/claude-desktop-app

    Scaffolds a complete, runnable project from scratch, covering web, Python and Node.js projects, with a working entry point and no placeholder code.

    494 GitHub starsUsed in 1 repo~498 tokens
    DevelopmentAuto-check passed
  • Guides Hermes Agent through building, refining and testing a CLI-Anything harness that wraps a GUI application or source repository in a scriptable command line.

    52k GitHub stars~1.1k tokensUpdated 16 days ago
    DevelopmentAuto-check passed

More from google/adk-recipes

All 14 skills in this repo
  • Retail Product Search Agent

    google/adk-recipes

    Official

    Builds a retail product search agent on Google Cloud, from catalog ingestion into BigQuery and Vector Search to ADK scaffolding, evaluation and Cloud Run deployment.

    10k GitHub stars~3k tokensUpdated 2 days ago
    Auto-check passed
  • Align Recipe pyproject.toml

    google/adk-recipes

    Official

    Brings a Python recipe's pyproject.toml in line with the repo's CI rules, either as a read-only dry run or by rewriting the file while keeping comments.

    10k GitHub stars~4.6k tokensUpdated 2 days ago
    Auto-check passed
  • Official

    Generates a minimal tests/test_runnability.py for a Python agent recipe that imports the agent module and checks root_agent, adding only the mocks and env vars it needs.

    10k GitHub stars~3.3k tokensUpdated 2 days ago
    Auto-check passed
  • Retail Virtual Try-On Agent

    google/adk-recipes

    Official

    Sets up a virtual try-on agent on Google Cloud that generates image and catwalk-video try-ons with Gemini, from first setup through local testing.

    10k GitHub stars~3.5k tokensUpdated 2 days ago
    Auto-check passed
  • Official

    Reviews a GitHub pull request and drafts a small set of inline comments in a human reviewing voice, each checkable from the line it points at, then posts them after approval.

    10k GitHub stars~8.4k tokensUpdated 2 days ago
    Auto-check passed
  • Official

    Makes an existing Python recipe deployable: generates the serving files a container needs (Dockerfile, .dockerignore, fastapiapp.py, apputils/a2a.py, apputils/services.py…

    10k GitHub stars~6.9k tokensUpdated 2 days ago
    Auto-check: notes

Works with

Categories

Questions about Scaffold Python ADK Recipe

What does Scaffold Python ADK Recipe do?

Creates a new Python recipe for the ADK recipes repository by running a scaffold script that copies template files, after confirming the output directory and recipe name. py, never by writing boilerplate files by hand. The agent must have two inputs first and ask if either is missing: an output directory, chosen from contrib/python/ (community recipes, preferred), core/python/ (curated) or the legacy flat contrib/, and a recipe name made only of lowercase letters and hyphens, at most 30 characters, not starting or ending with a hyphen.

When should I use Scaffold Python ADK Recipe?

Scaffold Python ADK Recipe fits situations like: starting a new Python recipe in contrib/python; adding a curated recipe under core/python; checking whether a proposed recipe name is valid.

How do I install Scaffold Python ADK Recipe in Claude Code?

Run `npx skills add google/adk-recipes --skill scaffold-python-recipe -a claude-code`. Or copy the skill folder (.agents/skills/scaffold-python-recipe in google/adk-recipes) into .claude/skills/scaffold-python-recipe in your project. Claude Code loads it when a task matches its description.

How do I install Scaffold Python ADK Recipe in Codex?

Run `npx skills add google/adk-recipes --skill scaffold-python-recipe -a codex`. Or copy the skill folder (.agents/skills/scaffold-python-recipe in google/adk-recipes) into .agents/skills/scaffold-python-recipe in your project. Codex loads it when a task matches its description.

Can I use Scaffold Python ADK Recipe in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add google/adk-recipes --skill scaffold-python-recipe -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/scaffold-python-recipe, .gemini/skills/scaffold-python-recipe, .github/skills/scaffold-python-recipe and .opencode/skills/scaffold-python-recipe in your project.

What does Scaffold Python ADK Recipe need to run?

Going by SKILL.md and its folder, Scaffold Python ADK Recipe needs Python for the scripts in its folder and the command-line tools its instructions call (uv and python3). Our summary lists: Python 3 to run scripts/scaffold.py; A checkout of the adk-recipes repository.

Does Scaffold Python ADK Recipe access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Scaffold Python ADK Recipe safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Scaffold Python ADK Recipe use?

Scaffold Python ADK Recipe is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Scaffold Python ADK Recipe use?

About 931 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Scaffold Python ADK Recipe?

Skills that share tags, products or a category with Scaffold Python ADK Recipe: Mirage VFS Adapter Authoring (strukto-ai/mirage, 3.7k stars), CLI-Anything for Codex (HKUDS/CLI-Anything, 52k stars), CLI-Anything for Reasonix (HKUDS/CLI-Anything, 52k stars) and README and DESIGN Generator (fengshao1227/ccg-workflow, 5.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Scaffold Python ADK Recipe?

google (a GitHub organization, an official publisher) maintains it in google/adk-recipes, which has 10,419 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on October 5, 2026.

Source: google/adk-recipes on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.