django-ai-plugins

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-expert
• django-celery-expert
• cdrf-expert
• django-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