CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fastapi-project-starter

Scaffold a production-ready async FastAPI application with SQLAlchemy 2.0, Alembic migrations, Pydantic v2, and structured logging.

Quality

78%

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 ./backend-python/fastapi-project-starter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

78%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 highly actionable, executable scaffold with clean structure and almost no padding — the main quality cost is its monolithic form. Moving full module templates into reference files, eliminating the duplicated commands, and fixing the .env.example gap would raise it across both workflow and disclosure dimensions.

Suggestions

Add the .env.example to the scaffold command (or show its contents) so 'First Steps' step 1 does not depend on a file the scaffold never creates.

Split the full module code templates (models, schemas, logging, conftest) into references/ files and link them from SKILL.md, keeping the overview plus one representative pattern inline.

Remove the duplicated uvicorn and alembic commands between 'First Steps After Scaffold' and 'Common Commands', and add explicit validation checkpoints (e.g., 'run pytest and confirm the health endpoint responds before proceeding').

DimensionReasoningScore

Conciseness

The body is almost entirely executable content (scaffold script, module code, commands) with no explanations of concepts Claude already knows, matching the 'efficient; minor instances that could be trimmed' anchor. Not a 5 because of redundancy: the uvicorn dev-server command and 'alembic upgrade head' each appear twice (First Steps and Common Commands), and the ruff lint list duplicates what pyproject.toml already configures.

4 / 5

Actionability

Fully executable end to end: a copy-paste scaffold command, complete pyproject.toml, full module implementations (config, engine, base, model, schemas, deps, router, app factory, logging, conftest), and concrete commands for every common task — matching the 'fully executable; copy-paste ready' anchor.

5 / 5

Workflow Clarity

A clear, correctly ordered sequence exists (scaffold command → 'First Steps After Scaffold' 1–6 → Common Commands) with a verification step ('Test the API: curl http://localhost:8000/docs') and a test suite, matching 'clear sequence with most checkpoints present; minor validation gaps'. It is not a 5 because checkpoints are not explicit (no 'verify before proceeding' framing), and step 1 references a '.env.example' file that the scaffold command never creates, so a user following the sequence literally would hit a missing-file error.

4 / 5

Progressive Disclosure

Section headers are clear and navigation within the file is fine, but the skill is a ~380-line monolith: 12+ full module code templates are inlined with no references/ or other bundle files, matching 'some structure but content that should be separate is inline'. It is not a 4 because per-file code templates (models, schemas, logging setup) clearly belong in separate reference files with the SKILL.md serving as overview.

3 / 5

Total

16

/

20

Passed

Description

70%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 specific, well-targeted description with concrete technology keywords and a clear 'what', but it completely lacks a 'Use when...' trigger clause, which both caps completeness and weakens discoverability. Adding explicit trigger guidance would lift it from good to excellent.

Suggestions

Append a trigger clause, e.g.: 'Use when starting a new FastAPI project, scaffolding a production Python API/backend service, or setting up async SQLAlchemy with Alembic migrations.'

Include natural user phrasings such as 'new API project', 'backend starter', or 'REST API setup' to broaden trigger term coverage beyond framework names.

Briefly enumerate what the scaffold produces (routed endpoints, ORM models, test setup, lint/CI commands) so the capability list is comprehensive rather than a single 'Scaffold' verb.

DimensionReasoningScore

Specificity

The description names a concrete action ('Scaffold a production-ready async FastAPI application') and a specific tech stack ('SQLAlchemy 2.0, Alembic migrations, Pydantic v2, and structured logging'), matching the 'several specific actions; minor gaps' anchor. It is not a 5 because 'Scaffold' is the only verb — it doesn't enumerate what the scaffold actually produces (routers, models, tests, CI commands).

4 / 5

Completeness

The 'what' is clearly and concretely stated, but there is no 'Use when...' clause or any equivalent trigger guidance, so per the judging guidelines completeness is capped at 3 ('clear what but when is missing').

3 / 5

Trigger Term Quality

Framework names ('FastAPI', 'SQLAlchemy', 'Alembic', 'Pydantic v2') are strong, natural keywords a user would say, matching 'good keyword coverage; a few natural terms missing'. It falls short of anchor 5 because common user phrasings like 'new API project', 'backend starter', 'REST API', or 'set up a Python service' are absent.

4 / 5

Distinctiveness Conflict Risk

'async FastAPI application with SQLAlchemy 2.0, Alembic migrations, Pydantic v2' carves out a clear, specific niche with distinct triggers and minimal overlap with other skills, matching anchor 5.

5 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

achreftlili/deep-dev-skills

Path

backend-python/fastapi-project-starter/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.