CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

dmr-openapi-skeleton

Generate django-modern-rest transport-layer skeletons from OpenAPI 3.1+ specs. Use when asked to turn an OpenAPI file, URL, or pasted document into typed DTOs, controllers, routers, Django URL wiring, and minimal tests for this repository or similar projects built on dmr. Trigger on requests to scaffold APIs, bootstrap apps, or map OpenAPI operations to Controller, Router, and OpenAPI view constructs without implementing business logic.

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

81%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.

A well-structured, dense instruction skill: it sequences the generation workflow with explicit validation checkpoints and a fidelity gate, gives concrete dmr constructs and commands, and cleanly signals its three reference files. The main improvement areas are light duplication of install/media-type guidance and moving some detailed translation rules out of the main file.

Suggestions

Consolidate the duplicated installation guidance: the 'Bootstrap the environment' bullets and the 'Translation Rules' uv/poetry/pip add lines cover the same ground — keep one canonical location and cross-reference it.

State the unsupported-media-type scaffold modes (minimal-working vs strict-stub) once and keep only the verbatim question template as the second mention, trimming the repeated mode descriptions.

Move detail-heavy policy such as the fidelity gate mismatch taxonomy and multi-media-type negotiation rules into references/spec-fidelity.md, leaving the SKILL.md gate summary and a clear pointer.

DimensionReasoningScore

Conciseness

Nearly every bullet is a project-specific rule rather than explanation of known concepts, so the file is efficient per line. Minor trimming opportunities exist: installation-extras guidance appears in both 'Bootstrap the environment' and again in 'Translation Rules' ('uv add 'django-modern-rest[msgspec, openapi]''), and the unsupported-media-type modes are described twice (mode descriptions plus the 'mandatory question template').

4 / 5

Actionability

Guidance is concrete and executable: exact commands ('uv run python manage.py runserver'), specific constructs ('Body[...]', 'Query[...]', 'Router([...], prefix=.../')', 'include((router.urls, app_name), namespace=...)'), annotations ('@modify(status_code=HTTPStatus.NO_CONTENT)'), and a verbatim user-question template for unsupported media types. It stops short of a complete copy-paste-ready code example, which keeps it below the top anchor.

4 / 5

Workflow Clarity

The workflow is clearly sequenced from 'Read the specification first' through 'Apply a practical fidelity gate before finishing', with explicit validation steps ('compare the generated schema to the source spec before considering the task done'), a feedback loop ('keep iterating or ask the user to approve specific drift'), and a closing Output Checklist — matching the top anchor's sequence-plus-validation-plus-checklist profile.

5 / 5

Progressive Disclosure

Three real, one-level-deep reference files are each well-signaled with a purpose ('Read references/framework-patterns.md when choosing dmr constructs... project-map.md when deciding where generated files should live... spec-fidelity.md whenever a source OpenAPI document is authoritative'). The ~165-line body still carries substantial policy detail (Translation Rules, fidelity-gate specifics) that could partly move into the existing references, so organization is good but not fully split.

4 / 5

Total

17

/

20

Passed

Description

92%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.

A strong description: it states concrete capabilities in third person, gives explicit 'Use when' triggers with natural phrasing, and carves out a distinct niche with a clear no-business-logic boundary. Its only weakness is mild: a few common synonyms (Swagger, REST API) are absent from the trigger terms.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions with comprehensive coverage: 'Generate django-modern-rest transport-layer skeletons from OpenAPI 3.1+ specs' producing 'typed DTOs, controllers, routers, Django URL wiring, and minimal tests'. No vague filler and no coverage gaps in the described output surface, matching the top anchor.

5 / 5

Completeness

Explicitly answers both questions: what ('Generate django-modern-rest transport-layer skeletons... typed DTOs, controllers, routers, Django URL wiring, and minimal tests') and when ('Use when asked to turn an OpenAPI file, URL, or pasted document into...' plus 'Trigger on requests to scaffold APIs, bootstrap apps...'), with concrete trigger phrases throughout.

5 / 5

Trigger Term Quality

Good natural keyword coverage including 'OpenAPI file, URL, or pasted document', 'scaffold APIs', 'bootstrap apps', and 'map OpenAPI operations'. A few common synonyms users might say are missing (e.g. 'Swagger', 'REST API', '.yaml'), so it falls just short of the comprehensive-synonym anchor.

4 / 5

Distinctiveness Conflict Risk

A clear niche — scaffolding django-modern-rest transport layers from OpenAPI 3.1+ specs 'without implementing business logic' — with distinct, domain-specific triggers, so overlap risk with other skills is minimal.

5 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

wemake-services/django-modern-rest

Path

dmr/.agents/skills/dmr-openapi-skeleton/SKILL.md

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.