CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

71

Quality

86%

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

The canonical home for this skill is dmr-openapi-skeleton in wemake-services/django-modern-rest

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 highly actionable, well-sequenced scaffolding workflow with real validation checkpoints and a fidelity gate, backed by genuine one-level-deep reference files. Its main weakness is redundancy: install guidance and spec-fidelity policy each appear in multiple sections, making the body longer than the overview-plus-references structure justifies.

Suggestions

Consolidate dependency-installation guidance into a single location: sections 2 and the Translation Rules both prescribe extras (`pydantic`, `msgspec`, `jwt`, `openapi`), so keep one canonical rule and cross-reference it to remove duplicated lines.

Move the detailed spec-fidelity policy (sections 1a, 10, and 11) into references/spec-fidelity.md and keep only a short trigger line plus the blocking-mismatch list in SKILL.md, letting the existing reference carry the comparison procedure.

Trim the Output Checklist to items not already stated in the workflow (or fold it into section 11's fidelity gate) to reduce repetition between the Workflow and final checklist.

DimensionReasoningScore

Conciseness

Every line is a directive with no explanation of concepts Claude already knows, but the 160-line body repeats itself noticeably: install guidance appears in both section 2 ("Install `django-modern-rest` together with the extras needed...", "install at least `django-modern-rest[pydantic]`") and again in Translation Rules ("`uv add 'django-modern-rest[msgspec, openapi]'`..."), and spec-fidelity policy is spread across sections 1a, 8, 10, and 11 despite a dedicated `references/spec-fidelity.md` existing. This fits the 3 anchor ("mostly efficient but... could be tightened") better than 4, where trimming would be minor rather than structural.

3 / 5

Actionability

Guidance is fully concrete and copy-paste ready: exact commands ("`uv add 'django-modern-rest[msgspec, openapi]'`", "`uv run python manage.py runserver`"), exact constructs ("`Router([...], prefix='.../')`", "`include((router.urls, 'app_name'), namespace='...')`", "`@modify(status_code=HTTPStatus.NO_CONTENT)`"), an exact settings snippet ("`DMR_SETTINGS = {Settings.semantic_responses: False}`"), and even a verbatim mandatory question template for unsupported media types. This matches the 5 anchor; the instruction-only style is appropriate for a scaffolding skill and specific examples cover the common cases.

5 / 5

Workflow Clarity

The workflow is a clearly numbered sequence (1 through 11 plus 1a) with explicit validation checkpoints and a feedback loop: section 10 requires comparing the generated schema to the source "before considering the task done", section 11 is a dedicated fidelity gate with a "keep iterating or ask the user to approve specific drift" loop, and "Do not claim completion until remaining differences are either resolved or explicitly accepted" closes the loop. An Output Checklist summarizes completion criteria. This matches the 5 anchor including the checklist-for-complex-processes criterion.

5 / 5

Progressive Disclosure

The three references (`framework-patterns.md`, `project-map.md`, `spec-fidelity.md`) are real files, exactly one level deep, and each is clearly signaled with its purpose and trigger condition ("Read references/framework-patterns.md when choosing dmr constructs, references/project-map.md when deciding where generated files should live, and references/spec-fidelity.md whenever a source OpenAPI document is authoritative"). Not the 5 anchor because substantial detail that the references exist to carry (notably spec-fidelity and translation rules) is inlined in the body rather than split out, so the overview role of SKILL.md is diluted.

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 in third person that states concrete capabilities, input variations, and explicit trigger guidance with a clear scope boundary (skeletons, no business logic). Keyword coverage is good but misses a few natural synonyms such as "Swagger" or file-extension triggers.

DimensionReasoningScore

Specificity

Multiple specific concrete actions are listed with comprehensive coverage: "Generate django-modern-rest transport-layer skeletons from OpenAPI 3.1+ specs" plus "typed DTOs, controllers, routers, Django URL wiring, and minimal tests", and it even enumerates input forms ("OpenAPI file, URL, or pasted document") and target constructs ("Controller, Router, and OpenAPI view constructs"). Coverage is comprehensive rather than leaving minor gaps, so it fits the 5 anchor rather than the 4.

5 / 5

Completeness

It explicitly answers both questions: the what is concrete ("Generate django-modern-rest transport-layer skeletons... typed DTOs, controllers, routers, Django URL wiring, and minimal tests") and the when is explicit with concrete trigger phrases ("Use when asked to turn an OpenAPI file, URL, or pasted document into...", "Trigger on requests to scaffold APIs, bootstrap apps..."). Not the 4 anchor because the when-clause is explicit and specific rather than improvable.

5 / 5

Trigger Term Quality

Good keyword coverage with natural phrases users would say — "OpenAPI file, URL, or pasted document", "scaffold APIs", "bootstrap apps", "map OpenAPI operations" — including input-format variations. A few common natural terms are missing, such as "Swagger", "REST API", "spec", or file extensions like ".yaml"/".json", which keeps it at the 4 anchor rather than 5.

4 / 5

Distinctiveness Conflict Risk

It carves a clear niche (django-modern-rest transport-layer scaffolding from OpenAPI 3.1+ specs for a specific repo) with distinct triggers ("dmr", "django-modern-rest", "OpenAPI operations to Controller, Router, and OpenAPI view constructs without implementing business logic"), so the risk of firing for an unrelated skill is minimal. The framework and version pinning distinguish it from generic Django or OpenAPI codegen skills.

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