python-development-python-scaffold

You are a Python project architecture expert specializing in scaffolding production-ready Python applications. Generate complete project structures with modern tooling (uv, FastAPI, Django), type hint

Quality

40%

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

Fix and improve this skill with Tessl

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

Quality

Content

39%Scale 1-5

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

This skill provides a comprehensive catalog of Python project scaffolding templates with concrete, executable code, which is its main strength. However, it is excessively verbose for a skill file—inlining full project structures for five project types without any progressive disclosure or external references. It also lacks workflow validation steps (e.g., confirming the scaffolded project runs or tests pass) and includes unnecessary explanatory text that Claude doesn't need.

Suggestions

Extract the per-project-type templates (FastAPI, Django, Library, CLI) into separate bundle files (e.g., FASTAPI_TEMPLATE.md, DJANGO_TEMPLATE.md) and reference them from the main SKILL.md with clear navigation links.

Add validation checkpoints after scaffolding: e.g., 'Run `uv run pytest` to verify test setup works' and 'Run `uv run ruff check .` to confirm linting passes on generated code.'

Remove the 'Use this skill when / Do not use this skill when' and 'Context' sections—these explain obvious things Claude can infer. Also remove the project type descriptions (e.g., 'REST APIs, microservices, async applications') as Claude already knows what FastAPI is for.

Define the referenced but missing config.py/settings module to make the FastAPI example fully executable end-to-end.

Dimension	Reasoning	Score
Conciseness	The skill is significantly verbose, repeating full project structures and pyproject.toml files for every project type (FastAPI, Django, Library, CLI). It explains concepts Claude already knows (what FastAPI is for, what Django is for) and includes boilerplate like 'Use this skill when / Do not use this skill when' sections that add no value. The $ARGUMENTS placeholder is unexplained filler.	2 / 5
Actionability	The skill provides concrete, mostly executable code examples including full pyproject.toml configurations, directory structures, and Python source files. The bash commands and Python code are copy-paste ready. Minor gaps include the config.py/settings import being referenced but never defined, and the Django section being less complete than FastAPI.	4 / 5
Workflow Clarity	While numbered steps exist (1-7), they read more like a catalog of project types than a coherent workflow. There are no validation checkpoints—no step to verify the project was scaffolded correctly, no 'run the tests to confirm setup works,' no feedback loops. For a scaffolding task that creates many files, there should be verification that the generated structure is valid and the app runs.	2 / 5
Progressive Disclosure	All content is inlined in a single monolithic file with no references to supporting files. The FastAPI section alone is ~100 lines of code that could be in a template or separate reference file. The Django, Library, and CLI sections similarly bloat the main file. With no bundle files, all this detail competes for context window space in the main skill.	2 / 5
	Total	10 / 20 Passed

Description

41%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 is truncated mid-sentence, which severely undermines its effectiveness. While it identifies a clear domain (Python project scaffolding) and mentions specific tools, it lacks a 'Use when...' clause and comprehensive action listing. It also uses second-person framing ('You are') which is inappropriate for a skill description that should use third person voice.

Suggestions

Complete the truncated description and add a 'Use when...' clause with trigger phrases like 'new Python project', 'project setup', 'boilerplate', 'scaffold', 'project template', or 'project structure'.

Rewrite in third person voice (e.g., 'Scaffolds production-ready Python applications with modern tooling') instead of the current 'You are...' framing.

List more specific concrete actions such as 'generates pyproject.toml, creates directory layouts, configures linting/testing, sets up CI/CD pipelines' to improve specificity and trigger term coverage.

Dimension	Reasoning	Score
Specificity	Names the domain (Python project architecture) and a couple of concrete actions ('scaffolding', 'generate complete project structures') with some tooling mentions (uv, FastAPI, Django, type hints), but the description appears truncated and doesn't comprehensively list specific actions like creating config files, setting up testing, CI/CD, etc.	3 / 5
Completeness	Has a partial 'what' (scaffolding Python projects with modern tooling) but no 'when' clause at all. The description is also clearly truncated mid-sentence, making it incomplete. The missing 'Use when...' clause caps this at 3 per guidelines, and the truncation pushes it lower.	2 / 5
Trigger Term Quality	Includes some relevant keywords like 'Python', 'project', 'scaffolding', 'FastAPI', 'Django', 'uv', and 'type hint', but misses common natural user phrases like 'new project', 'boilerplate', 'project template', 'setup', 'cookiecutter', 'pyproject.toml', or file extensions. The description is also truncated, limiting keyword coverage.	3 / 5
Distinctiveness Conflict Risk	Somewhat specific to Python project scaffolding, which narrows the domain, but could overlap with general Python coding skills, project setup skills, or framework-specific skills (FastAPI, Django). The truncation prevents it from fully distinguishing itself.	3 / 5
	Total	11 / 20 Passed

Validation

90%

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 — 10 / 11 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	10 / 11 Passed

Repository: administrakt0r/AI-Agents-Safe-Coding-Skills
Path: skills/python-development-python-scaffold/SKILL.md
Commit: 57c135b

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