Name: fastapi-router-py
Rating: 55.2 (1 reviews)
Author: administrakt0r

fastapi-router-py

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

Quality

63%

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 ./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

Quality

Content

65%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 content is a tight, well-sectioned reference with executable code patterns and a clear integration sequence, but it suffers from a missing bundled template, no validation checkpoints in the workflow, and a vague 'When to Use' filler line. Supplying the template file and a verification step would meaningfully raise the score.

Suggestions

Add the missing assets/template.py bundle (or remove the reference and inline the template) so the 'Copy the template' instruction resolves to a real file.

Insert an explicit validation/verification step into Integration Steps, e.g. 'Verify the router mounts and returns expected status codes by hitting the endpoint', to satisfy workflow checkpoints.

Replace the filler "When to Use" line with concrete trigger guidance or delete it, since it adds tokens without actionable information.

Dimension	Reasoning	Score
Conciseness	The body is mostly lean code and short numbered steps that assume Claude's competence, with only minor trimmable content; the vague filler line "This skill is applicable to execute the workflow or actions described in the overview" is unnecessary padding that keeps it just below level 5.	4 / 5
Actionability	Concrete code snippets for authentication, response models, and status codes plus a placeholder-substitution quick start give mostly executable guidance, but some examples use "..." ellipses and the referenced template is not bundled, leaving minor gaps short of fully copy-paste-ready level 5.	4 / 5
Workflow Clarity	"Integration Steps" lists a clear 5-step sequence (create router, mount, models, service, frontend) but has no validation or verification checkpoints, matching the anchor where steps are present yet checkpoints are missing or implicit.	3 / 5
Progressive Disclosure	Sections are well-organized and the template reference is clearly signaled, but "Copy the template from assets/template.py" points at a bundle file that does not exist in the skill directory, so the reference is dangling rather than cleanly one-level-deep, holding it at level 3.	3 / 5
	Total	14 / 20 Passed

Description

61%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 and domain-appropriate, naming FastAPI router creation with concrete sub-concerns, but it lacks any explicit "Use when..." trigger guidance, capping its completeness. Adding a trigger clause with common synonyms would lift both completeness and trigger-term quality.

Suggestions

Add an explicit 'Use when...' clause, e.g. 'Use when creating FastAPI routers, endpoints, or API routes that need authentication and consistent response models.'

Include common synonyms/trigger terms such as 'endpoints', 'API routes', and 'REST' to broaden natural-keyword coverage.

Expand the action list beyond the single 'Create' verb (e.g. 'Create, scaffold, and wire up FastAPI routers...') to push specificity toward comprehensive coverage.

Dimension	Reasoning	Score
Specificity	"Create FastAPI routers" names the domain plus several concrete attributes ("proper authentication, response models, and HTTP status codes"), but it is fundamentally a single action with modifiers rather than a comprehensive list of distinct actions, so it sits at the anchor for 1-2 concrete actions and not the multi-action level 4.	3 / 5
Completeness	It clearly states what the skill does ("Create FastAPI routers...") but has no "Use when..." clause or explicit trigger guidance, which per the judging guidelines caps completeness at 3.	3 / 5
Trigger Term Quality	"FastAPI routers", "authentication", "response models", and "HTTP status codes" are natural developer phrases, but common synonyms like "endpoints", "API routes", or "REST" are absent, placing it just below comprehensive coverage at level 5.	4 / 5
Distinctiveness Conflict Risk	The narrow focus on FastAPI router creation with named sub-concerns is mostly distinct from other skills, with only minor overlap risk against closely related backend/web-framework skills, so it does not reach the clearly-niched level 5.	4 / 5
	Total	14 / 20 Passed

Validation

87%

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

Validation for skill structure

Criteria	Description	Result
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
Commit: 57c135b

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