CtrlK
BlogDocsLog inGet started
Tessl Logo

align-recipe-pyproject

Aligns a Python recipe's pyproject.toml with the repo's standards enforced by .github/workflows/python-validate-recipe.yml, plus one critical [build-system] presence check. Scope is pyproject.toml only — standalone ruff.toml / .ruff.toml files (also forbidden in recipes) are caught by the CI workflow instead, not by this skill. Runs in two modes: a read-only --dry-run that reports what needs alignment, and an apply mode that rewrites pyproject.toml (and optionally manifest.yaml) using comment-preserving TOML/YAML editors. Use when the user wants to "align the recipe's pyproject.toml", "fix pyproject to match the repo standard", "check what needs changing in a recipe's pyproject", or clean up a recipe before submitting a PR.

74

Quality

91%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 thorough, highly actionable skill body with executable commands, clear validation-gated workflow, and appropriate delegation to the bundled script. The only lever is trimming a few rationale paragraphs to tighten the token budget.

DimensionReasoningScore

Conciseness

Mostly efficient and assumes Claude's competence — rule logic, flags, and file paths are stated directly without explaining basics — but a few rationale blocks (the 'adk-major-current' paragraph, the stale-refs bash example, long rule-table cells) could be tightened without losing the skill-specific knowledge Claude needs.

4 / 5

Actionability

Provides fully executable, copy-paste-ready `uv run --no-project --with tomlkit --with 'ruamel.yaml' --with packaging` commands for every mode, exact flags, real script path, concrete TOML build-system templates, and a precise response-format spec covering the common cases.

5 / 5

Workflow Clarity

The destructive rewrite workflow has explicit validation checkpoints: always start with --dry-run, filter to status != 'ok', handle needs_input/report_only before applying, exit-code 0/1 semantics, and a Next-steps verification reminder — with clear feedback loops (dry-run → review → apply → verify).

5 / 5

Progressive Disclosure

Well-organized into What it Checks / Rules for the Agent / Input / Run / Respond, with the executable logic correctly delegated to the bundled scripts/align_pyproject.py and referenced by real path; minor gaps in that the build-system templates and full response-format prose are inlined rather than split out.

4 / 5

Total

18

/

20

Passed

Description

95%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, third-person description that cleanly answers what and when with multiple natural trigger phrases and a tightly scoped niche. Minor room to surface the concrete rule set rather than the abstract 'repo standards' phrasing.

DimensionReasoningScore

Specificity

Lists several concrete actions ('rewrites pyproject.toml (and optionally manifest.yaml) using comment-preserving TOML/YAML editors', 'read-only --dry-run that reports what needs alignment', 'one critical [build-system] presence check'), but the umbrella 'aligns with the repo's standards' leaves the individual rules implicit rather than enumerated.

4 / 5

Completeness

Explicitly answers both 'what' (aligns pyproject.toml with repo standards via dry-run/apply modes) and 'when' (a 'Use when...' clause with concrete trigger phrases), matching the top anchor.

5 / 5

Trigger Term Quality

Provides verbatim natural user phrases — 'align the recipe's pyproject.toml', 'fix pyproject to match the repo standard', 'check what needs changing in a recipe's pyproject', 'clean up a recipe before submitting a PR' — covering synonyms and the PR-cleanup variant a user would actually say.

5 / 5

Distinctiveness Conflict Risk

The niche is sharply bounded — a Python recipe's pyproject.toml against one specific workflow — and scope is explicitly narrowed (ruff.toml handled by CI, not this skill), minimizing conflict with adjacent skills.

5 / 5

Total

19

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
google/adk-samples
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.