Spec-first generation

By example, you can use agent skill dmr-openapi-skeleton when you already have an OpenAPI contract and want a runnable django-modern-rest skeleton.

Important

LLM-generated code cannot guarantee strict compliance with your OpenAPI specification. Always review and validate generated routes, schemas, media types, status codes, headers, and security requirements before production use.

This workflow is best used to save time on generating a project skeleton: DTOs, transport handlers, routers, docs wiring, and smoke tests.

How to use in Codex

  1. Prepare an OpenAPI 3.1+ spec (file path, URL, or pasted text).

  2. Ask Codex to use the skill $dmr-openapi-skeleton.

  3. Review generated transport layer and replace placeholders with real logic.

You can use prompt like this:

$dmr-openapi-skeleton Read `openapi.yaml` and create a new runnable Django
project in this folder. Use `django-modern-rest` as your REST framework.
Bootstrap the environment with `uv`, generate
`pyproject.toml`, settings, `manage.py`, DTOs, controllers, routers,
docs wiring, and minimal smoke tests.
Use `PydanticSerializer`, include `msgspec` and `openapi` extras,
and do not implement any business logic.

How to use in Claude Code

  1. Install the plugin:

/plugin install github.com/wemake-services/django-modern-rest

  1. Verify skills are available:

/skills list

  1. Invoke the skill:

/skills dmr-openapi-skeleton

  1. Then provide the OpenAPI source (file path, URL, or pasted spec) and generation constraints.

What is generated

  • Typed DTOs / serializers

  • Controller objects as operations handlers

  • All required urls.py + project URL wiring

  • OpenAPI docs (JSON, ReDoc, Swagger, Scalar)

  • Minimal smoke tests

Business logic is intentionally left unimplemented.