CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

python-development-python-scaffold

Scaffold Python projects with uv, package structure, type checking, and tests. Use when starting applications, services, or libraries with a consistent development setup.

58

Quality

73%

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

Fix and improve this skill with Tessl

tessl review fix ./skills/python-development-python-scaffold/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 delivers strong, copy-paste-ready scaffolding templates and commands organized into a clear numbered workflow, but it is undermined by padded framing sections, absent verification steps after scaffolding, and a monolithic single-file layout where per-project-type templates should be split into reference files. Tightening the framing text and adding a post-scaffold validation step would raise it substantially.

Suggestions

Remove the persona sentence, 'Context' section, and the tautological 'Use/Do not use this skill when' bullets — the frontmatter description already covers triggering, and Claude needs no reminder that unrelated tasks are out of scope.

Add a final validation step to the workflow, e.g. '8. Verify: uv sync && uv run pytest && uv run ruff check .' so the scaffold is confirmed working before handoff.

Split the four project-type templates (FastAPI, Django, library, CLI) into separate reference files (e.g. templates/fastapi.md, templates/django.md) and keep SKILL.md as a concise overview with one-level-deep, clearly signaled links; also define the config.py/settings module that main.py imports.

DimensionReasoningScore

Conciseness

The body is mostly concrete templates, but it carries noticeable padding Claude does not need: the persona line 'You are a Python project architecture expert specializing in...', the 'Context' section, and tautological bullets like 'The task is unrelated to python project scaffolding'. This sits between anchor 2 (several padded sections) and anchor 4 (minor trimming needed) — several sections exist but the bulk is actionable template content.

3 / 5

Actionability

Mostly executable guidance: runnable commands ('uv init <project-name>', 'django-admin startproject config .'), complete pyproject.toml files, a working cli.py, Makefile, and .env.example. It misses a 5 because settings/config.py is imported in main.py but never defined, and test files appear in directory trees without any test code shown.

4 / 5

Workflow Clarity

Steps 1-7 are clearly numbered and sequenced with per-step commands, but there are no validation checkpoints (e.g., 'run uv sync and pytest to verify the scaffold works'). This matches anchor 3 ('steps listed but validation gaps; checkpoints missing or implicit') — above anchor 2 due to the well-defined sequence, below anchor 4 because no verification step exists anywhere.

3 / 5

Progressive Disclosure

The skill has no bundle files; all four project-type templates (FastAPI, Django, library, CLI) plus tooling config are inlined in a single ~325-line file with good section headers. This matches anchor 3 ('some structure but content that should be separate is inline') — the per-project templates are natural candidates for separate reference files, though the sectioned structure keeps it above anchor 2's minimal-organization level.

3 / 5

Total

13

/

20

Passed

Description

75%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 solid third-person description that clearly states both what the skill does and when to use it, with concrete technology names (uv, type checking, tests) and explicit project-type triggers. Its main shortcoming is missing natural trigger variations like 'new Python project', 'set up', or 'boilerplate', and it does not hint at the framework-specific variants the skill actually contains.

DimensionReasoningScore

Specificity

The description names the domain and several concrete elements — 'Scaffold Python projects with uv, package structure, type checking, and tests' — matching the anchor for several specific actions with minor gaps. It falls short of a 5 because it omits the framework variants (FastAPI, Django, CLI) that constitute the skill's core content, and it exceeds a 3 by listing four distinct concrete capabilities rather than 1-2.

4 / 5

Completeness

It explicitly answers both 'what' ('Scaffold Python projects with uv, package structure, type checking, and tests') and 'when' ('Use when starting applications, services, or libraries with a consistent development setup'). It is not a 5 because the trigger clause covers only three project types without concrete variations or synonyms users might say, and it is well above a 3 since the 'when' is explicit rather than implied.

4 / 5

Trigger Term Quality

Natural phrases like 'scaffold', 'starting applications, services, or libraries', and 'Python projects' are present, giving good keyword coverage. A few common natural terms are missing ('new Python project', 'set up', 'boilerplate', 'project template'), which keeps it below the comprehensive-synonym coverage of a 5 but clearly above the partial coverage of a 3.

4 / 5

Distinctiveness Conflict Risk

The niche — Python project scaffolding with uv — is distinct with clear triggers, matching 'mostly distinct; minor overlap risk'. It risks minor overlap with general Python-development or uv-specific skills, which prevents a 5, but it is far more specific than the broad overlap examples at 2-3.

4 / 5

Total

16

/

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

rmyndharis/antigravity-skills

Path

skills/python-development-python-scaffold/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.