Django Agent Skills

A collection of skills and agents for AI coding agents specialized in Django backend development. Skills are packaged instructions and references that extend agent capabilities. Agents are autonomous specialists that proactively review and refine code.

Skills follow the Agent Skills format and work with any compatible AI coding agent.

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

To install the skills, run:

npx skills add vintasoftware/django-ai-plugins

To list available skills before installing:

npx skills add vintasoftware/django-ai-plugins -l

To install the agents, run:

First, add the marketplace to Claude Code:

/plugin marketplace add vintasoftware/django-ai-plugins

Then install the agent plugin:

/plugin install django-reviewer@vintasoftware-django-ai-plugins

You can also browse all available plugins interactively with /plugin and navigate to the Discover tab.

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:

• Skills (skills/SKILL.md) — Instructions and reference documentation loaded on-demand
• Agents (agents/<name>.md) — Autonomous specialists that proactively review and refine code

Integration with django-ai-boost MCP Server

This skill works seamlessly with the django-ai-boost MCP server, which provides additional Django-specific tools and capabilities.

To use both together:

1. Install the django-ai-boost MCP server following its documentation
2. Install this skill using the instructions above
3. The skills will leverage the tools provided by the MCP server for enhanced Django development capabilities

License

MIT @ Vinta Software