django-doctor

Audit Django codebases for security, performance, correctness, and architecture issues.

5|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/ragnarok22/agent-skills --skill django-doctor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: django-doctor
Source: https://github.com/ragnarok22/agent-skills/tree/main/skills/django-doctor
Command: npx skills add https://github.com/ragnarok22/agent-skills --skill django-doctor

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill identifies and helps remediate security vulnerabilities, performance bottlenecks, correctness issues, and architectural antipatterns in Django applications, ensuring a healthier and more robust backend.

Core Features & Use Cases

  • Comprehensive Auditing: Scans code across four critical categories: Security, Performance, Correctness, and Architecture.
  • Actionable Insights: Provides a scored report with prioritized remediation steps and detailed explanations for each finding.
  • Use Case: Before deploying a new Django feature, run this audit to catch potential security flaws like exposed secrets or performance issues like N+1 queries, ensuring a stable release.

Quick Start

Use the django-doctor skill to audit the current Django project for security and performance issues.

Frequently Asked Questions about django-doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a Django codebase for security vulnerabilities and performance issues?

Auditing a Django codebase for security vulnerabilities and performance issues requires scanning for architectural antipatterns and running migration drift detection. This skill executes static rule scans to output a 0-100 health score with actionable remediation steps.

What is Django migration drift detection and how does it improve correctness?

Django migration drift detection identifies discrepancies between your database schema and migration files to improve correctness. By executing system checks, it catches missing migrations that could cause runtime errors and provides detailed explanations for each finding.

Can I check my Python project for N+1 query bottlenecks before deployment?

Checking your Python project for N+1 query bottlenecks before deployment is possible through comprehensive performance auditing. The scan evaluates code across four critical categories, providing a scored report with prioritized fixes to ensure a stable release.

Does this Django audit tool work without external dependencies or packages?

This Django audit tool works without external dependencies, utilizing internal scripts and a reference catalog. It performs static rule scans and system checks directly on your codebase to identify exposed secrets and architectural antipatterns independently.

What is the best way to fix architectural antipatterns in a Django application?

The best way to fix architectural antipatterns in a Django application is to use a static rule scan that provides prioritized remediation steps. It identifies antipatterns across security, performance, and correctness, delivering a 0-100 health score with actionable fixes.

When should I run a Django health and security audit during development?

Running a Django health and security audit is recommended before deploying new features to catch potential security flaws and performance issues. It ensures robust backend architecture by scanning for correctness problems and providing a scored report with prioritized remediation.