dmr-openapi-skeleton

Generate django-modern-rest transport-layer skeletons from OpenAPI 3.1+ specs. Use when Codex needs 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

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Quality

Content

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

The body is a well-structured, actionable workflow with strong validation gates and a sensible progressive-disclosure split across three reference files. Its main weakness is length and the absence of a single complete worked example to anchor the many scattered construct names.

Suggestions

Tighten section 2 (Bootstrap) by collapsing the multi-clause tool-preference rules into a compact decision table to reduce conditional verbosity.

Add one short end-to-end worked example (a single OpenAPI operation mapped to a complete DTO + Controller + Router snippet) so the construct names are shown assembled together.

Move the long lists in step 11's blocking-mismatch criteria and the Translation Rules media-type branches into a reference file to shorten the core workflow.

Dimension	Reasoning	Score
Conciseness	Largely lean, actionable instruction without concept-explanation padding, but the ~170-line body with heavy conditional 'prefer X / fall back to Y' branching in sections 2 and 4 could be tightened further.	4 / 5
Actionability	Provides concrete, executable constructs (Body[...], Query[...], Router([...], prefix='.../'), @modify(status_code=HTTPStatus.NO_CONTENT), uv add 'django-modern-rest[msgspec, openapi]') but lacks a full end-to-end copy-paste example tying them together.	4 / 5
Workflow Clarity	Clear 11-step sequence with explicit validation checkpoints in step 10 ('compare the generated schema to the source spec before considering the task done') and step 11 (blocking-mismatch gate plus 'Do not claim completion until... explicitly accepted'), plus a final Output Checklist and feedback loops.	5 / 5
Progressive Disclosure	Overview points to three real one-level-deep reference files (framework-patterns.md, project-map.md, spec-fidelity.md) each with a stated purpose, keeping the body an overview while details live in separate, clearly signaled files.	5 / 5
	Total	18 / 20 Passed

Description

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

The description is specific, complete, and well-triggered with concrete deliverables and clear 'Use when' guidance. It is mostly distinct, though a couple of trigger phrases are broad enough to risk minor overlap with general scaffolding skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions - 'typed DTOs, controllers, routers, Django URL wiring, and minimal tests' and 'map OpenAPI operations to Controller, Router, and OpenAPI view constructs' - giving comprehensive coverage of the skeleton's outputs.	5 / 5
Completeness	Explicitly answers both what ('Generate django-modern-rest transport-layer skeletons...') and when ('Use when Codex needs...', 'Trigger on requests to scaffold APIs, bootstrap apps...') with concrete trigger phrases.	5 / 5
Trigger Term Quality	Good natural trigger coverage ('OpenAPI file', 'scaffold APIs', 'bootstrap apps'), but common synonyms like 'Swagger' and file extensions (.yaml/.json) are absent.	4 / 5
Distinctiveness Conflict Risk	Clear niche scoped to dmr + OpenAPI 3.1+, but the 'scaffold APIs' and 'bootstrap apps' triggers create minor overlap risk with generic Django/API scaffolding skills.	4 / 5
	Total	18 / 20 Passed

Validation

100%

Warnings & errors only

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: .agents/skills/dmr-openapi-skeleton/SKILL.md
Commit: 87a02f5

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.