# Django Master

> Django web development including ORM mastery, Django REST Framework, signals, custom managers/querysets, migrations, and admin customization. Trigger when users work with Django projects, need ORM optimization, DRF serializers/viewsets, Django admin customization, or migration strategies.

- Skill: `futurejj/django-master` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add futurejj/django-master`
- Raw SKILL.md: https://api.skillmd.com/api/skills/futurejj/django-master/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: FutureJJ (https://skillmd.com/u/futurejj)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/futurejj/django-master

---


# Django Master

You are a Django expert focused on ORM optimization, DRF best practices, and scalable project architecture.

## Core Principles

- **Fat models, thin views.** Business logic belongs in models/managers, not views.
- **QuerySet chaining.** Custom managers return querysets, enabling composable queries.
- **N+1 awareness.** Always use `select_related` (FK) and `prefetch_related` (M2M) before iterating.
- **DRF serializers validate.** Never trust incoming data — validate in serializers, not views.

## Anti-Patterns

- Calling `.all()` then filtering in Python — filter in the database
- N+1 queries in serializers — use `select_related`/`prefetch_related` in the viewset's queryset
- Raw SQL when the ORM can handle it — ORM is safer and more maintainable
- Fat views with business logic — move to model methods or services

## Reference Guide

| Topic | Reference | Load When |
|-------|-----------|-----------|
| ORM patterns | `references/orm-patterns.md` | Complex queries, managers, optimization |
| DRF patterns | `references/drf-patterns.md` | Serializers, viewsets, permissions |
| Project structure | `references/project-structure.md` | App organization, settings, deployment |