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.

Quality

84%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

86%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is highly actionable and well-structured, with executable commands and clear input-validation checkpoints. The main gap is the absence of an explicit post-run verification and error-recovery loop.

Suggestions

Add an explicit post-run verification step (e.g. confirm the expected files exist under <OUTPUT_DIRECTORY>/<RECIPE_NAME>) and an error-recovery branch in case the scaffold script fails.

Tighten the vertical-skill aside or move it to a brief one-line boundary note to reduce token weight on an off-path concern.

Reconcile the script path: the intro references scripts/scaffold.py while the Run command uses .agents/skills/scaffold-python-recipe/scripts/scaffold.py — pick one consistent path.

Dimension	Reasoning	Score
Conciseness	The body is lean and sectioned, assuming Claude's competence without explaining basic concepts; minor digressions (e.g. the vertical-skill shape enumeration) could be trimmed, placing it at anchor 4 rather than 5.	4 / 5
Actionability	Provides a fully executable, copy-paste-ready command with its two exact flags, input-validation rules, and concrete quick-start commands (uv sync, uv run pytest, uv run adk run app), matching anchor 5.	5 / 5
Workflow Clarity	Clear Inputs -> Run -> Respond sequence with explicit pre-flight validation checkpoints (name rules, ask for missing output dir, "do not proceed until confirmed"), but lacks a post-run verification step and an error-recovery feedback loop, so it sits at anchor 4 rather than 5.	4 / 5
Progressive Disclosure	Well-organized into Rules, Inputs, Run, and Respond sections, references a real bundle file (scripts/scaffold.py) one level deep, and qualifies for the simple-skill exception, matching anchor 5.	5 / 5
	Total	18 / 20 Passed

Description

82%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description clearly states what the skill does and when to use it, with multiple natural trigger phrases and a distinct niche. Its only weakness is capability specificity, since it describes just two underlying actions.

Dimension	Reasoning	Score
Specificity	Names the domain (Python ADK sample) and two concrete actions ("copy template files and resolve basic placeholders"), but offers only two actions rather than a comprehensive list, matching anchor 3 rather than 4.	3 / 5
Completeness	Explicitly answers both "what" (scaffold a Python ADK sample recipe via an automated script) and "when" ("This skill should be used when the user wants to..." followed by concrete trigger phrases), matching anchor 5.	5 / 5
Trigger Term Quality	Five natural trigger phrases with synonyms (create, scaffold, generate, add) that users would plausibly say; good coverage, though a few variants (e.g. "ADK sample template") are missing, so it sits at anchor 4 rather than 5.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche (scaffolding Python ADK samples in a specific repository layout) with distinct triggers and minimal overlap with other skills, matching anchor 5.	5 / 5
	Total	17 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: google/adk-samples
Path: .agents/skills/scaffold-python-recipe/SKILL.md
Commit: 2d0c272

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.