CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

scaffold-python-recipe

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.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

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.

A well-structured, highly actionable instruction body for a simple single-purpose skill: exact commands, explicit input validation with feedback loops, and correct delegation of mechanics to the bundled scaffold script. The only gaps are minor repetition, slight over-explanation of the plugin layout, and no error path for script failure.

DimensionReasoningScore

Conciseness

The body is lean and imperative with no concept explanations, but has minor trimmable padding: 'Do not make any further changes' is repeated in Rules and Respond, and the enumerated file layout for vertical plugins (SKILL.md, EVAL.yaml, scripts/, ...) over-explains. This matches anchor 4 ('efficient; minor instances of over-explanation') rather than 5, and is clearly above anchor 3's unnecessary explanations.

4 / 5

Actionability

Fully executable guidance throughout: the exact scaffold command with both required flags, explicit recipe-name validation rules (lowercase/hyphens, ≤30 chars, no leading/trailing hyphen), enumerated valid output directories, specific manifest.yaml fields to fill in, and copy-paste quick-start commands. This matches anchor 5; nothing is pseudocode or abstract.

5 / 5

Workflow Clarity

The sequence (gather inputs → validate → run script → respond) is clear, with explicit input-validation feedback loops ('explain which rule it violates and ask for a corrected name. Do not proceed until a valid name is confirmed') and a success gate ('Once the script succeeds'). It falls just short of anchor 5 because there is no guidance for handling script failure itself, matching anchor 4's 'minor validation gaps'. Scaffolding creates new files rather than modifying existing ones, so the destructive/batch cap of 3 does not apply.

4 / 5

Progressive Disclosure

A short (~60 line) body organized into clear Rules / Inputs / Run / Respond sections, with the heavy lifting correctly delegated to the bundled scripts/scaffold.py (which exists at the referenced path) and a clearly signaled one-level-deep pointer to the generate-manifest skill. No references/ or assets/ are needed; this matches anchor 5 for a simple, single-purpose skill.

5 / 5

Total

18

/

20

Passed

Description

90%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.

A strong description that explicitly states both what the skill does and when to use it, with natural, comprehensive trigger phrases. The only weakness is modest specificity of the 'what' — it summarizes the mechanism (copy templates, resolve placeholders) rather than enumerating the concrete outcomes of scaffolding.

DimensionReasoningScore

Specificity

The description names the domain (Python ADK recipe scaffolding) and 1-2 concrete actions ('utilizes an automated script to copy template files and resolve basic placeholders'), but does not list several specific actions, so it matches anchor 3 rather than 4. It is in third person, so no voice penalty applies.

3 / 5

Completeness

Both questions are explicitly answered: what ('copy template files and resolve basic placeholders' via an automated script) and when ('This skill should be used when the user wants to' followed by concrete trigger phrases). This matches anchor 5; the explicit 'Use when' clause means the completeness cap of 3 does not apply.

5 / 5

Trigger Term Quality

It provides five natural quoted trigger phrases users would actually say ('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', 'create a Python adk recipe'), covering the verb and noun-phrase variants for this domain. No meaningful natural terms are missing, matching anchor 5 rather than 4.

5 / 5

Distinctiveness Conflict Risk

The trigger phrases are tightly scoped to scaffolding Python ADK recipes in a specific repository, a clear niche with distinct triggers and minimal overlap with other skills, matching anchor 5.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Reviewed

Table of Contents

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.