Scaffold a production-ready Litestar 2.x application with class-based controllers, DTOs, guards, SQLAlchemy plugin, and auto-generated OpenAPI docs.
73
64%
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-python/litestar-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 and distinctiveness by clearly naming the Litestar 2.x framework and its specific components. However, it critically lacks any 'Use when...' guidance, which would help Claude know when to select this skill over other web framework scaffolding skills. The technical terminology is appropriate but could benefit from more natural user-facing trigger terms.
Suggestions
Add a 'Use when...' clause with explicit triggers like 'Use when the user asks to create a Litestar project, scaffold a Litestar API, or mentions Litestar framework setup.'
Include broader natural language triggers that users might say, such as 'Python async API', 'Starlette alternative', or 'new backend project with Litestar'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Scaffold a production-ready Litestar 2.x application with class-based controllers, DTOs, guards, SQLAlchemy plugin, and auto-generated OpenAPI docs.' This clearly names the framework, version, and specific components. | 3 / 3 |
Completeness | Describes what the skill does (scaffold Litestar app with specific features) 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 'Litestar', 'controllers', 'DTOs', 'SQLAlchemy', 'OpenAPI' that users familiar with the framework would use, but misses common variations like 'API', 'web app', 'backend', or 'REST' that users might naturally say. | 2 / 3 |
Distinctiveness Conflict Risk | Highly distinctive due to the specific framework name 'Litestar 2.x' and its unique ecosystem terms (DTOs, guards, SQLAlchemy plugin). Unlikely to conflict with other web framework skills. | 3 / 3 |
Total | 9 / 12 Passed |
Implementation
79%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, actionable skill with excellent executable code examples covering the full Litestar stack. The main weaknesses are the lack of validation checkpoints in the workflow (e.g., verifying scaffold success, database connectivity before migrations) and the monolithic structure that could benefit from progressive disclosure to separate reference files.
Suggestions
Add validation checkpoints after key steps: verify directory structure after scaffold, test database connection before migrations, confirm server starts before proceeding
Split detailed patterns (DTOs, Services, Controllers) into a separate PATTERNS.md reference file, keeping SKILL.md as a concise overview with links
Add a troubleshooting section or feedback loop for common failures (e.g., 'If alembic upgrade fails, check DATABASE_URL and ensure PostgreSQL is running')
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is dense with executable code and avoids explaining concepts Claude already knows (no explanations of what Litestar is, what DTOs are, etc.). Every section provides actionable content without padding. | 3 / 3 |
Actionability | Fully executable code throughout - complete pyproject.toml, working Python modules, bash commands, and test examples. All code is copy-paste ready with proper imports and realistic implementations. | 3 / 3 |
Workflow Clarity | The 'First Steps After Scaffold' section provides a clear sequence, but lacks validation checkpoints. No verification steps after scaffold creation, no checks that the database is running before migrations, and no feedback loops for common failure scenarios. | 2 / 3 |
Progressive Disclosure | Content is well-organized with clear sections, but it's a monolithic document (~400 lines) that could benefit from splitting detailed patterns into separate reference files. The Integration Notes section hints at advanced topics but doesn't link to deeper documentation. | 2 / 3 |
Total | 10 / 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 | |
181fcbc
Table of Contents
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.