CtrlK
BlogDocsLog inGet started
Tessl Logo

maria/fastapi

FastAPI framework with Pydantic v2 patterns, PII sanitisation, and practical workflows

93

Quality

93%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

Overview
Skills
Evals
Files

scaffold-project

skills/scaffold-project/SKILL.md

Discovery

85%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

This is a well-crafted skill description that clearly communicates its purpose and includes explicit 'Use when' guidance. The main weakness is limited trigger term coverage - it could benefit from additional natural language variations users might employ when requesting this functionality.

Suggestions

Add trigger term variations like 'API project', 'backend', 'REST API', 'initialize', 'bootstrap', or 'setup FastAPI' to improve discoverability

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: 'Scaffold a new FastAPI project', 'opinionated directory layout', 'pydantic-settings config', and 'starter files'. These are concrete, actionable capabilities.

3 / 3

Completeness

Clearly answers both what ('Scaffold a new FastAPI project with an opinionated directory layout, pydantic-settings config, and starter files') and when ('Use when creating a new FastAPI application from scratch') with explicit trigger guidance.

3 / 3

Trigger Term Quality

Includes good terms like 'FastAPI', 'new', 'from scratch', and 'application', but misses common variations users might say like 'API project', 'backend', 'REST API', 'initialize', 'bootstrap', or 'setup'.

2 / 3

Distinctiveness Conflict Risk

Very specific niche targeting FastAPI project scaffolding specifically. The combination of 'FastAPI', 'scaffold', 'new project', and 'from scratch' creates a distinct trigger profile unlikely to conflict with general Python or web development skills.

3 / 3

Total

11

/

12

Passed

Implementation

100%

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

This is an excellent skill that efficiently teaches Claude how to scaffold a FastAPI project. It provides a clear directory structure, executable code for all generated files, a logical step sequence, and includes verification. The content is lean, actionable, and well-organized.

DimensionReasoningScore

Conciseness

Every line serves a purpose - directory structure is shown compactly, code examples are minimal but complete, and no unnecessary explanations of FastAPI concepts Claude already knows.

3 / 3

Actionability

Provides fully executable, copy-paste ready code for all generated files, specific directory structure, and concrete verification commands. No pseudocode or vague instructions.

3 / 3

Workflow Clarity

Clear 7-step sequence with explicit verification at the end. The workflow includes a concrete validation step (running the server and testing the health endpoint) to confirm success.

3 / 3

Progressive Disclosure

For a focused scaffolding skill under 50 lines, the content is well-organized with clear sections (layout, steps, code blocks). No need for external references given the self-contained scope.

3 / 3

Total

12

/

12

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata' field is not a dictionary

Warning

license_field

'license' field is missing

Warning

Total

14

/

16

Passed