Django Agent Skills
A collection of skills and agents for AI coding agents specialized in Django backend development.
Available Skills & Agents
django-expert (Skill)
Comprehensive Django development guidelines from Vinta Software. Contains best practices across multiple categories for building robust Django applications.
Use when:
- Building new Django models, views, or APIs
- Implementing authentication or authorization
- Setting up Django REST Framework endpoints
- Reviewing Django code for best practices
- Optimizing database queries and performance
Categories covered:
- Project structure and configuration
- Models and database design
- Views and URL routing
- Django REST Framework integration
- Security best practices
- Testing strategies
- Performance optimization
- Production deployment
django-celery-expert (Skill)
Expert guidance for Django applications using Celery for asynchronous task processing. Incorporates best practices from Vinta Software's production experience.
Use when:
- Creating background tasks for email, notifications, or data processing
- Configuring Celery workers and message brokers
- Implementing retry logic and error handling
- Setting up periodic/scheduled tasks with Celery Beat
- Monitoring and debugging Celery tasks
- Deploying Celery to production
Categories covered:
- Django-Celery integration patterns (transaction.on_commit, recovery tasks)
- Task design patterns (idempotency, workflows, atomicity)
- Broker configuration (Redis, RabbitMQ, SQS)
- Error handling and retry strategies
- Periodic tasks and scheduling
- Monitoring and observability (Flower, Prometheus)
- Production deployment and scaling
cdrf-expert (Skill)
Expert guidance for Django REST Framework class-based views using Classy DRF. Focuses on choosing the correct DRF view class and override hook with MRO-backed reasoning.
Use when:
- Choosing between
APIView, generic views, GenericViewSet, and ModelViewSet
- Debugging DRF class-based view behavior
- Identifying where to override (
perform_create, perform_update, get_queryset, etc.)
- Tracing method resolution order and method source class
- Comparing DRF behavior across versions
Categories covered:
- DRF class selection matrix
- Request lifecycle and override strategy
- MRO debugging workflow
- DRF version comparison workflow
django-reviewer (Agent)
Autonomous code review agent that refines Django/Python code for clarity, consistency, and maintainability. Focuses on recently modified code and applies Django best practices without changing functionality.
Use when:
- Reviewing recently modified Django code for anti-patterns
- Refining models, views, serializers, or ORM queries
- Enforcing PEP 8 and Django coding style consistency
- Detecting N+1 queries and performance issues
- Simplifying overly complex view or serializer logic
What it reviews:
- N+1 queries (missing
select_related/prefetch_related)
- Business logic placement (fat models, thin views)
- ORM usage vs raw SQL
- Import organization and naming conventions
- DRF serializer and viewset patterns
- Database constraints and index usage
- Test structure and coverage patterns
Installation
Codex
This repository exposes a local Codex marketplace at:
.agents/plugins/marketplace.json
Each plugin directory now also includes a Codex manifest at .codex-plugin/plugin.json. Use the marketplace file above or the individual plugin manifests when registering these plugins in Codex:
django-expertdjango-celery-expertcdrf-expertdjango-reviewer
Generic Open-Plugin Installer
If you use the community plugins CLI, this repository can also be installed from the repo root or GitHub URL:
npx plugins add vintasoftware/django-ai-plugins
npx plugins add https://github.com/vintasoftware/django-ai-plugins
As of March 18, 2026, the plugins package docs explicitly list Claude Code and Cursor as supported install targets. Treat Codex support through that tool as unverified unless you have confirmed it in your environment.
Usage
Skills are automatically available once installed. The agent will use them when relevant tasks are detected.
Examples:
Create a new Django model for user profiles
Set up a REST API endpoint with authentication
Should I override create or perform_create in this DRF ViewSet?
Review this Django view for security issues
Use the django-reviewer agent to review my recent changes
Plugin Structure
Each plugin contains either skills or agents:
- Codex manifest (
.codex-plugin/plugin.json) — Codex plugin metadata
- Claude manifest (
.claude-plugin/plugin.json) — Claude metadata
- Skills (
skills/SKILL.md) — Instructions and reference documentation loaded on-demand
- Agents (
agents/<name>.md) — Autonomous specialists that proactively review and refine code
