Content
18%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is essentially a stub—it has a title and metadata but lacks any substantive content for building FastAPI projects. There are no code examples, no project structure templates, no concrete commands, and no real workflow. The entire skill delegates to a resource file that doesn't exist in the bundle, leaving Claude with nothing actionable to work with.
Suggestions
Add a concrete project structure template (directory tree) and at least one executable FastAPI app example with async endpoint, dependency injection, and error handling patterns.
Replace the generic instruction bullets ('Apply relevant best practices') with a specific step-by-step workflow for scaffolding a FastAPI project, including validation steps like running tests or starting the dev server.
Either include the referenced `resources/implementation-playbook.md` in the bundle or inline the essential patterns (middleware setup, database connection, Pydantic models) directly in the SKILL.md.
Remove the generic 'Do not use this skill when' section and the boilerplate instructions to make room for actual FastAPI-specific guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 'Use this skill when' and 'Do not use this skill when' sections add moderate padding without much value—Claude doesn't need to be told when not to use a skill in such generic terms. The instructions section is generic boilerplate ('Clarify goals, constraints, and required inputs') rather than FastAPI-specific content. However, it's not excessively verbose overall. | 3 / 5 |
Actionability | There is zero concrete, executable guidance—no code examples, no project structure templates, no specific commands, no FastAPI patterns. The instructions are entirely abstract ('Apply relevant best practices and validate outcomes') and delegate everything to a referenced file that doesn't exist in the bundle. | 1 / 5 |
Workflow Clarity | There is no workflow, no sequenced steps, and no validation checkpoints. The four bullet points in Instructions are generic platitudes with no specific process for creating a FastAPI project. For a skill about creating production-ready projects, the absence of any concrete workflow is a critical gap. | 1 / 5 |
Progressive Disclosure | The skill references `resources/implementation-playbook.md` for detailed patterns, which is a reasonable disclosure strategy, but no bundle files are provided, meaning the reference leads nowhere. The SKILL.md itself contains almost no substantive content to serve as an effective overview or entry point, making the progressive disclosure structure hollow. | 2 / 5 |
Total | 7 / 20 Passed |