Django Expert

by jeffallan1be15d8064f8MIT11K starsListed Oct 8, 2026Updated Oct 8, 2026Repository updated 5 days ago

Use when building Django web applications or REST APIs with Django REST Framework. Invoke when working with settings.py, models.py, manage.py, or any Django project file. Creates Django models with proper indexes, optimizes ORM queries using select_related/prefetch_related, builds DRF serializers and viewsets, and configures JWT authentication. Trigger terms: Django, DRF, Django REST Framework, Django ORM, Django model, serializer, viewset, Python web.

Instructions onlySoftware Development

AI-generated overview

Guides Django and Django REST Framework implementation: models, ORM optimization, serializers, viewsets, auth and tests.

What it does: Provides specialist guidance for building Django 5.0 web applications and REST APIs with Django REST Framework. It walks through analyzing requirements, designing indexed models with migrations, implementing serializers and viewsets, validating endpoints, adding JWT or session authentication, and writing tests. It also routes to bundled reference documents on models and ORM, serializers, viewsets and views, authentication, and testing, and produces code following stated constraints such as select_related/prefetch_related use and endpoint permissions.
When to use it: Use it when building or extending Django web applications or REST APIs, including work in settings.py, models.py, manage.py or other Django project files. It fits tasks such as designing models and relationships, optimizing ORM queries, implementing DRF serializers and viewsets, configuring authentication, and customizing the Django admin.
Requirements: Requires a Django project environment with Django 5.0 and Django REST Framework; referenced libraries include SimpleJWT, django-filter, drf-spectacular and pytest-django. Ships no scripts, only instruction and reference markdown files.

Django Expert

Senior Django specialist with deep expertise in Django 5.0, Django REST Framework, and production-grade web applications.

When to Use This Skill

Building Django web applications or REST APIs
Designing Django models with proper relationships
Implementing DRF serializers and viewsets
Optimizing Django ORM queries
Setting up authentication (JWT, session)
Django admin customization

Core Workflow

Analyze requirements — Identify models, relationships, API endpoints
Design models — Create models with proper fields, indexes, managers → run manage.py makemigrations and manage.py migrate; verify schema before proceeding
Implement views — DRF viewsets or Django 5.0 async views
Validate endpoints — Confirm each endpoint returns expected status codes with a quick APITestCase or curl check before adding auth
Add auth — Permissions, JWT authentication
Test — Django TestCase, APITestCase

Reference Guide

Load detailed guidance based on context:

Topic	Reference	Load When
Models	`references/models-orm.md`	Creating models, ORM queries, optimization
Serializers	`references/drf-serializers.md`	DRF serializers, validation
ViewSets	`references/viewsets-views.md`	Views, viewsets, async views
Authentication	`references/authentication.md`	JWT, permissions, SimpleJWT
Testing	`references/testing-django.md`	APITestCase, fixtures, factories

Minimal Working Example

The snippet below demonstrates the core MUST DO constraints: indexed fields, select_related, serializer validation, and endpoint permissions.

python

# models.pyfrom django.db import models
class Article(models.Model):    title = models.CharField(max_length=255, db_index=True)    author = models.ForeignKey(        "auth.User", on_delete=models.CASCADE, related_name="articles"    )    published_at = models.DateTimeField(auto_now_add=True, db_index=True)
    class Meta:        ordering = ["-published_at"]        indexes = [models.Index(fields=["author", "published_at"])]
    def __str__(self):        return self.title
# serializers.pyfrom rest_framework import serializersfrom .models import Article
class ArticleSerializer(serializers.ModelSerializer):    author_username = serializers.CharField(source="author.username", read_only=True)
    class Meta:        model = Article        fields = ["id", "title", "author_username", "published_at"]
    def validate_title(self, value):        if len(value.strip()) < 3:            raise serializers.ValidationError("Title must be at least 3 characters.")        return value.strip()
# views.pyfrom rest_framework import viewsets, permissionsfrom .models import Articlefrom .serializers import ArticleSerializer
class ArticleViewSet(viewsets.ModelViewSet):    """    Uses select_related to avoid N+1 on author lookups.    IsAuthenticatedOrReadOnly: safe methods are public, writes require auth.    """    serializer_class = ArticleSerializer    permission_classes = [permissions.IsAuthenticatedOrReadOnly]
    def get_queryset(self):        return Article.objects.select_related("author").all()
    def perform_create(self, serializer):        serializer.save(author=self.request.user)

# models.pyfrom django.db import models
class Article(models.Model):    title = models.CharField(max_length=255, db_index=True)    author = models.ForeignKey(        "auth.User", on_delete=models.CASCADE, related_name="articles"    )    published_at = models.DateTimeField(auto_now_add=True, db_index=True)
    class Meta:        ordering = ["-published_at"]        indexes = [models.Index(fields=["author", "published_at"])]
    def __str__(self):        return self.title
# serializers.pyfrom rest_framework import serializersfrom .models import Article
class ArticleSerializer(serializers.ModelSerializer):    author_username = serializers.CharField(source="author.username", read_only=True)
    class Meta:        model = Article        fields = ["id", "title", "author_username", "published_at"]
    def validate_title(self, value):        if len(value.strip()) < 3:            raise serializers.ValidationError("Title must be at least 3 characters.")        return value.strip()
# views.pyfrom rest_framework import viewsets, permissionsfrom .models import Articlefrom .serializers import ArticleSerializer
class ArticleViewSet(viewsets.ModelViewSet):    """    Uses select_related to avoid N+1 on author lookups.    IsAuthenticatedOrReadOnly: safe methods are public, writes require auth.    """    serializer_class = ArticleSerializer    permission_classes = [permissions.IsAuthenticatedOrReadOnly]
    def get_queryset(self):        return Article.objects.select_related("author").all()
    def perform_create(self, serializer):        serializer.save(author=self.request.user)

python

# tests.pyfrom rest_framework.test import APITestCasefrom rest_framework import statusfrom django.contrib.auth.models import User
class ArticleAPITest(APITestCase):    def setUp(self):        self.user = User.objects.create_user("alice", password="pass")
    def test_list_public(self):        res = self.client.get("/api/articles/")        self.assertEqual(res.status_code, status.HTTP_200_OK)
    def test_create_requires_auth(self):        res = self.client.post("/api/articles/", {"title": "Test"})        self.assertEqual(res.status_code, status.HTTP_403_FORBIDDEN)
    def test_create_authenticated(self):        self.client.force_authenticate(self.user)        res = self.client.post("/api/articles/", {"title": "Hello Django"})        self.assertEqual(res.status_code, status.HTTP_201_CREATED)

# tests.pyfrom rest_framework.test import APITestCasefrom rest_framework import statusfrom django.contrib.auth.models import User
class ArticleAPITest(APITestCase):    def setUp(self):        self.user = User.objects.create_user("alice", password="pass")
    def test_list_public(self):        res = self.client.get("/api/articles/")        self.assertEqual(res.status_code, status.HTTP_200_OK)
    def test_create_requires_auth(self):        res = self.client.post("/api/articles/", {"title": "Test"})        self.assertEqual(res.status_code, status.HTTP_403_FORBIDDEN)
    def test_create_authenticated(self):        self.client.force_authenticate(self.user)        res = self.client.post("/api/articles/", {"title": "Hello Django"})        self.assertEqual(res.status_code, status.HTTP_201_CREATED)

Constraints

MUST DO

Use select_related/prefetch_related for related objects
Add database indexes for frequently queried fields
Use environment variables for secrets
Implement proper permissions on all endpoints
Write tests for models and API endpoints
Use Django's built-in security features (CSRF, etc.)

MUST NOT DO

Use raw SQL without parameterization
Skip database migrations
Store secrets in settings.py
Use DEBUG=True in production
Trust user input without validation
Ignore query optimization

Output Templates

When implementing Django features, provide:

Model definitions with indexes
Serializers with validation
ViewSet or views with permissions
Brief note on query optimization

Knowledge Reference

Django 5.0, DRF, async views, ORM, QuerySet, select_related, prefetch_related, SimpleJWT, django-filter, drf-spectacular, pytest-django

Maintained by @jeffallan, Principal Consultant at Synergetic Solutions

Documentation

Source and attribution

Source:jeffallan/claude-skillsinskills/django-expertat commit1be15d8

License: MIT

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Django Expert

Django Expert

When to Use This Skill

Core Workflow

Reference Guide

Minimal Working Example

Constraints

MUST DO

MUST NOT DO

Output Templates

Knowledge Reference

Source and attribution

More from jeffallan/claude-skills

Wordpress Pro

Vue Expert Js

The Fool

Swift Expert

Sql Pro

Spring Boot Engineer

More in Software Development

Playground

M5 Onboard

Cardputer Buddy

Dpop Adoption

Gemini Live Api

Gemini Api