How do I install the Scaffold Python Recipe skill?

Run npx skillmds@latest add google/scaffold-python-recipe-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Scaffold Python Recipe safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Scaffold Python Recipe?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Scaffold Python Recipe free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Scaffold Python Recipe?

Google (@google) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Scaffold Python Recipe by google — Agent Skill

Name: Scaffold Python Recipe
Rating: 4.2 (5 reviews)
Author: Google

Scaffold Python Recipe

This skill should be used when the user wants to "create a new Python ADK sample", "scaffold a new Python sample recipe", "generate a new Python sample in contrib", "add a new Python sample to the adk-samples repository", or "create a Python adk sample". It utilizes an automated script to copy template files and resolve basic placeholders.

Google Updated Sep 22, 2026 14.4k repo stars

File contents

Scaffolding a New Python ADK Sample

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

Rules

No Manual Boilerplate Writing: Always use scripts/scaffold.py to create the recipe. Never write the boilerplate files manually.
Do Not Modify After Scaffolding: Once the script runs successfully, do not make any further changes to the recipe in this turn.
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 skill (skills/<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.

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:

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:

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

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.

---name: scaffold-python-recipe-2description: This skill should be used when the user wants to "create a new Python ADK sample", "scaffold a new Python sample recipe", "generate a new Python sample in contrib", "add a new Python sample to the adk-samples repository", or "create a Python adk sample". It utilizes an automated script to copy template files and resolve basic placeholders.---# Scaffolding a New Python ADK SampleUse this skill to scaffold a new Python ADK sample recipe inside this repository using the automated script at `scripts/scaffold.py`.---## Rules1. **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.---## InputsYou **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 skill (`skills/<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.### 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 hyphenIf 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.---## RunExecute the scaffold script:```bashpython3 .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.*---## RespondOnce 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:```bashcd <OUTPUT_DIRECTORY>/<RECIPE_NAME>uv sync # install dependenciesuv run pytest # run the test suiteuv run adk run app # run the agent interactively```Do not make any further changes. End your turn.

Frequently asked questions