CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

fastapi-router-py

Create FastAPI routers following established patterns with proper authentication, response models, and HTTP status codes.

Quality

70%

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 ./plugins/AI-Agents-Safe-Coding-Skills/skills/fastapi-router-py/SKILL.md

The canonical home for this skill is fastapi-router-py in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

63%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 well-organized and concise with useful pattern snippets and a concrete integration sequence, but its foundation is broken: the referenced template file is missing, snippets are non-executable fragments, and it closes with meaningless filler. Fixing the missing template and replacing the filler 'When to Use' section with real guidance would lift most dimensions.

Suggestions

Add the missing assets/template.py (or inline the template in SKILL.md) so the Quick Start's copy-and-replace workflow is actually executable.

Replace the filler 'When to Use' section ('This skill is applicable to execute the workflow or actions described in the overview.') with concrete applicability guidance, and drop the verbatim repetition of the description.

Add a validation step to Integration Steps, e.g. 'Verify: start the app or run tests to confirm the router mounts and endpoints respond', to complete the workflow with a checkpoint.

DimensionReasoningScore

Conciseness

The body is tight — compact code snippets, no explanations of concepts Claude already knows — but it repeats the frontmatter description verbatim and ends with a vacuous filler section ('This skill is applicable to execute the workflow or actions described in the overview.'). These are minor instances that could be trimmed, so it sits at 4 rather than 5.

4 / 5

Actionability

Auth patterns, response-model snippets, status-code usage, and integration paths are concrete, but the Quick Start's primary instruction — 'Copy the template from assets/template.py' — references a file that does not exist in the bundle, and the snippets are incomplete fragments (no imports, '...' bodies). The core workflow cannot actually be executed as written, which fits the 'concrete guidance but incomplete / missing key details' anchor rather than 4.

3 / 5

Workflow Clarity

'Integration Steps' is a clear, concrete 5-step sequence with real paths ('src/backend/app/routers/', 'src/backend/app/main.py'). It falls short of 5 because there is no verification step (e.g., start the app or run tests to confirm the router mounts), but the steps are specific enough to exceed the 'checkpoints missing' anchor at 3.

4 / 5

Progressive Disclosure

Scored against the actual bundle structure: no references/, scripts/, or assets/ directories exist, yet the body directs readers to 'assets/template.py' — a dangling reference that breaks navigation at the skill's entry point. In-body section organization is good, but a broken primary reference is more than a 'minor organization gap', so it cannot score 4.

3 / 5

Total

14

/

20

Passed

Description

66%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 clearly states what the skill does with specific, domain-appropriate terminology, but entirely omits when to use it. Adding an explicit 'Use when...' trigger clause would resolve its main weakness.

Suggestions

Add an explicit trigger clause, e.g. 'Use when creating or modifying FastAPI routers, adding endpoints, or wiring authentication into API routes.'

Broaden trigger vocabulary with natural variations users would say, such as 'endpoints', 'routes', or 'API functions', to improve discoverability.

Consider mentioning integration scope (router mounting, Pydantic models, frontend API functions) to make the capability coverage more comprehensive.

DimensionReasoningScore

Specificity

Names the domain ('FastAPI routers') and enumerates three concrete concerns — 'proper authentication, response models, and HTTP status codes' — leaving only minor coverage gaps. It falls short of 5 because 'following established patterns' is vague padding and broader coverage (mounting, testing, Pydantic models) is absent.

4 / 5

Completeness

The 'what' is clear, but the description contains no 'Use when...' clause or equivalent explicit trigger guidance, capping completeness at 3 per the judging guidelines. Not 4 because nothing in the text implies when to invoke the skill.

3 / 5

Trigger Term Quality

Includes natural terms a FastAPI developer would actually say: 'FastAPI', 'routers', 'authentication', 'response models', 'HTTP status codes'. A few natural variations ('endpoints', 'routes', 'add an API') are missing, keeping it below 5.

4 / 5

Distinctiveness Conflict Risk

'FastAPI routers' carves a mostly distinct niche with minor overlap risk against broader API-development skills. Not 5 because distinctiveness rests on one phrase and 'authentication... HTTP status codes' overlaps with general backend skills.

4 / 5

Total

15

/

20

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.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

14

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/fastapi-router-py/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.