fastify-project-starter
Scaffold a production-ready Fastify 5.x API with TypeScript, plugin architecture, JSON Schema validation, and auto-generated Swagger docs.
79
71%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./backend-node/fastify-project-starter/SKILL.mdQuality
Discovery
50%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 excels at specificity by naming exact technologies and version (Fastify 5.x) with concrete deliverables, making it highly distinctive. However, it critically lacks any 'Use when...' guidance, which means Claude may not know when to select this skill over others. The trigger terms are adequate but could include more natural variations users might say.
Suggestions
Add a 'Use when...' clause with trigger phrases like 'Use when the user wants to create a Fastify API, build a Node.js backend with Fastify, or scaffold a TypeScript REST server'
Include additional natural trigger terms such as 'REST API', 'backend server', 'Node.js API', 'OpenAPI' to capture more user query variations
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Scaffold a production-ready Fastify 5.x API' with specific technologies including 'TypeScript, plugin architecture, JSON Schema validation, and auto-generated Swagger docs'. | 3 / 3 |
Completeness | Describes what the skill does but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. | 1 / 3 |
Trigger Term Quality | Includes relevant technical terms like 'Fastify', 'TypeScript', 'Swagger', 'API' that users might say, but missing common variations like 'REST API', 'backend', 'server', 'Node.js', or 'OpenAPI'. | 2 / 3 |
Distinctiveness Conflict Risk | Very specific niche targeting 'Fastify 5.x' specifically, which clearly distinguishes it from other API framework skills (Express, Hono, etc.) and general scaffolding tools. | 3 / 3 |
Total | 9 / 12 Passed |
Implementation
92%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a high-quality, production-ready skill that provides comprehensive, executable guidance for scaffolding Fastify 5.x APIs. The content is lean, actionable, and well-organized with clear patterns. The only weakness is the monolithic structure—some advanced patterns could be split into separate reference files for better progressive disclosure.
Suggestions
Consider splitting advanced patterns (auth, error handling, testing with inject()) into separate reference files linked from the main skill
Add a brief validation checkpoint after the scaffold command (e.g., 'Verify setup: pnpm tsx src/server.ts should start without errors')
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is dense with actionable content and avoids explaining concepts Claude already knows (no explanations of what TypeScript is, what APIs are, etc.). Every section provides concrete value without padding. | 3 / 3 |
Actionability | Provides fully executable, copy-paste ready code throughout—from scaffold commands to complete plugin implementations, route handlers, and service files. All code examples are complete and runnable. | 3 / 3 |
Workflow Clarity | Clear sequential workflow from scaffold command through project structure to implementation patterns. The 'First Steps After Scaffold' section provides explicit numbered steps, and common commands are well-organized for the development lifecycle. | 3 / 3 |
Progressive Disclosure | Content is well-structured with clear sections, but it's a monolithic document (~300 lines) that could benefit from splitting detailed patterns (auth, error handling, testing) into separate reference files. Integration notes at the end hint at topics that could be expanded elsewhere. | 2 / 3 |
Total | 11 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
- Repository
- achreftlili/deep-dev-skills
- Commit
181fcbc
- 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.