fastapi-project-starter

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

Quality

71%

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

Quality

Content

72%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 is highly actionable with executable, copy-paste-ready scaffolding code and good organization, but it lacks validation checkpoints in its DB-touching workflow and keeps all detail inline rather than progressively disclosing it to reference files.

Suggestions

Add explicit validation/feedback steps around the database workflow, e.g. after `alembic upgrade head`, verify with `alembic current` or a `/health` check, and instruct to fix and re-run on failure.

Split detailed module patterns (config, engine, logging, routers) and Integration Notes into reference files under references/, linked from a concise overview in SKILL.md, to improve progressive disclosure.

Remove duplication between the frontmatter compatibility/prerequisites and the body Prerequisites section, and drop the blockquote that restates the description.

Dimension	Reasoning	Score
Conciseness	Largely efficient concrete code with no re-explanation of concepts Claude already knows; minor redundancy (prerequisites duplicated from frontmatter, blockquote restating the description, First Steps/Common Commands overlap) could be trimmed.	4 / 5
Actionability	Provides a fully executable scaffold shell script, a complete pyproject.toml, and complete copy-paste-ready module code patterns covering the common FastAPI project cases.	5 / 5
Workflow Clarity	A clear sequence exists (Scaffold Command -> numbered First Steps -> Common Commands), but there are no explicit validation/feedback checkpoints, and database operations (alembic upgrade head) are present, which caps workflow clarity at 3.	3 / 5
Progressive Disclosure	Section headers are clear, but the ~380-line body is a monolith with no bundle files and no references to split-out detail files, so content that could live in separate references is inlined.	3 / 5
	Total	15 / 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.

The description is specific, distinctive, and uses strong natural trigger terms, but it omits an explicit 'Use when...' clause, leaving the invocation context implicit and capping completeness.

Suggestions

Add an explicit trigger clause, e.g. 'Use when scaffolding a new async FastAPI backend, or when the user asks to start/bootstrap a FastAPI project with SQLAlchemy and Alembic.'

Include common synonyms such as 'starter', 'bootstrap', or 'API service' to broaden natural trigger coverage.

Consider stating the primary action as more than a single verb (e.g. 'scaffold, configure, and wire up') to strengthen capability specificity.

Dimension	Reasoning	Score
Specificity	Names the domain and a concrete stack ('async FastAPI application with SQLAlchemy 2.0, Alembic migrations, Pydantic v2, and structured logging'), listing several specific components, though the action set is essentially single ('Scaffold').	4 / 5
Completeness	Clearly states what the skill does but provides no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the rubric guidelines.	3 / 5
Trigger Term Quality	Strong natural keywords users would say for this need ('FastAPI', 'SQLAlchemy', 'Alembic', 'Pydantic', 'structured logging'), but missing synonyms like 'starter', 'bootstrap', or 'API'.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche (async FastAPI scaffolding with a specific tech stack) with distinct triggers and minimal overlap risk with other skills.	5 / 5
	Total	16 / 20 Passed

Validation

93%

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 — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
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
Commit: 181fcbc

Reviewed: 5 hours 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.