CtrlK
BlogDocsLog inGet started
Tessl Logo

litestar-project-starter

Scaffold a production-ready Litestar 2.x application with class-based controllers, DTOs, guards, SQLAlchemy plugin, and auto-generated OpenAPI docs.

73

Quality

64%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./backend-python/litestar-project-starter/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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

DimensionReasoningScore

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')

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
achreftlili/deep-dev-skills
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.