opinionated-django skill

The opinionated-django skill set teaches an agent to build Django projects with API, service, DTO and repository layers.

  • 112 ★ on the repository
  • Last commit
  • MIT
Skill

Minimal access

Why this level

  • The `dj-scaffold` skill installs dependencies and creates project files.
All reasons and checks

dvf/opinionated-django

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add skills/opinionated-django

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Minimal accessThe tool runs nothing and makes no network calls.

  • The `dj-scaffold` skill installs dependencies and creates project files.

This is third-party code. Review the repository files before installing.

What it does

Opinionated-django, a collection of agent skills, sets a layered Django architecture. The django-ninja API stays thin, business logic lives in services with svcs dependency injection, typed Pydantic DTOs cross layer boundaries and all ORM work hides in repositories. Skills are invoked per task: `dj-scaffold` creates the skeleton, `dj-models`, `dj-services`, `dj-signals`, `dj-settings` and `dj-lint` carry the rest, and `dj-prefixed-ulids` introduces keys like `prd_01jq3v…`. A working sample lives in `example_project/`.

Who it is for. Django developers building a large project with an agent who want one set of layering rules.

Good fit when

  • A new Django project must start from a skeleton with ruff, pytest and Celery.
  • An agent drags ORM queries into views and the code must be split by layers.
  • Models get Stripe-style prefixed primary keys.
  • A team brings signals and settings to one template.

Not a fit when

  • The project is small and repository and DTO layers add needless code.
  • The team accepts neither django-ninja, Pydantic nor svcs.
  • You need classic template views with no separate API.

Example request

Create a Django project skeleton in the opinionated-django style and add an orders app with a repository, a service and a DTO.

Limitations

The skills impose a specific library set: django-ninja, svcs and Pydantic v2. The author calls the approach opinionated and it does not fit every project. The `dj-scaffold` skeleton installs dependencies with `uv`, so run it in an empty project. The last commit dates from August 2026. MIT license; the sample project in `example_project/` shows the expected structure.

How to disable. Remove the skills with the installer or by hand from the agent skills directory. Project code created from them stays and needs no removal.

FAQ

Can I install a single skill?

Yes. Append the name to the repository, for example `npx skills add dvf/opinionated-django/dj-scaffold`.

Which skill goes first?

`dj-scaffold`: it creates the app skeleton, installs dependencies through `uv` and configures ruff, pyrefly and pytest.

Is there a working sample?

Yes, the `example_project/` folder with orders and products apps, models, repositories, services and DTOs.

Which libraries are assumed?

`django-ninja` for the API, `svcs` for dependencies, Pydantic v2 for DTOs and Django itself for models and repositories.

Why prefixed ULIDs?

Keys like `prd_01jq3v…` sort by time, are safe in URLs, read well in logs and stay strings across layers.

Discussion

No questions or reviews yet.

Skills

A skill that interviews you about a project and writes a working Django app with up-to-date packages, settings and CI.

PluginExtended access57Repository stars

Five Django skills from Vinta Software: ORM and DRF, Celery, zero-downtime PostgreSQL migrations, Classy DRF classes and code review

SkillMinimal access172Repository stars

A skill that teaches your agent to run datamodel-codegen and get Pydantic models from OpenAPI, JSON Schema and GraphQL

SkillExtended access4.1KRepository stars

Laravel API Architecture Skill

Laravel API Production-Ready Architecture Skill

A skill that keeps an agent within a layered Laravel API architecture: JSON:API v1.1, strict types, PHPStan level 8 and tests

SkillMinimal access22Repository stars

An MCP server that exposes a Django project's models, URLs, migrations and settings to an assistant through read-only tools.

MCP serverExtended access114Repository stars
Editors’ pick

The official FastAPI skill, bundled with the package, teaching agents to write code for the installed version

SkillMinimal access104.7KRepository stars

Comparison with similar tools

Cards that share the main search query, and how they differ.

ToolOfficialAuthenticationRepository starsMain difference
opinionated-django (this card)no112
Django AI Skillsno172collects general Django tips; opinionated-django sets one layered architecture with DTOs
Django AI Boostnonot required114gives an agent MCP access to a Django project; this carries code design rules, not an access tool

README in short

The README sets out the layer idea, lists the library of each layer and describes the individual skills with the `npx skills add` install command.

README badge

Report a problem