# django-reviewer

django-reviewer audits Django and Python diffs for ORM traps, DRF conventions, and code style. It stays in read-only mode by default, reporting issues before touching code.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 191 installs · ★ 176 repo stars
- Author: vintasoftware
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/vintasoftware/django-ai-plugins/tree/HEAD/skills/django-reviewer/SKILL.md
- Updated: 2026-07-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/django-reviewer

## What it does

This skill inspects your staged and unstaged `git diff` or specific paths you supply. It flags typical Django problems: N+1 query patterns, incorrect `select_related` paths, missing model constraints, and raw `count() > 0` checks instead of `.exists()`. It also watches DRF serializers, viewsets, and permission handling to ensure incoming data is validated at project boundaries.

File edits require explicit confirmation. Without clear intent to apply fixes, the skill returns a breakdown of issues and concrete recommendations without altering your codebase. It also stays strictly within target files, never scanning unrelated modules across the repository.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add vintasoftware/django-ai-plugins --skill django-reviewer -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/django-reviewer/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/django-reviewer/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add vintasoftware/django-ai-plugins --skill django-reviewer -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/django-reviewer/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add vintasoftware/django-ai-plugins --skill django-reviewer -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/django-reviewer/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install vintasoftware/django-ai-plugins skills/django-reviewer
```

2. **Manually: put the files in place**
- File: `.github/skills/django-reviewer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add vintasoftware/django-ai-plugins --skill django-reviewer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/vintasoftware/django-ai-plugins --path skills/django-reviewer
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/django-reviewer/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add vintasoftware/django-ai-plugins --skill django-reviewer -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/vintasoftware/django-ai-plugins/tree/HEAD/skills/django-reviewer/SKILL.md

## When to use it
- detect N+1 database queries and propose prefetching paths
- audit DRF serializers and endpoints for authorization gaps
- enforce PEP 8 and project style conventions on staged changes
- review recent Python diffs without unprompted file overwrites

## Example prompts
- Review my current git diff with django-reviewer
- Run django-reviewer on `apps/billing/` and check for slow queries
- Apply django-reviewer suggestions to `views.py` directly

## Similar
- [ac-django](https://affpapa.org/en/nevibecode/skills/ac-django.md) — skill · 1000 installs
- [django](https://affpapa.org/en/nevibecode/rules/django.md) — rule · ★ 3589 repo stars
- [django-patterns](https://affpapa.org/en/nevibecode/skills/django-patterns.md) — skill · 7100 installs
- [django-expert](https://affpapa.org/en/nevibecode/skills/httpsgithubcomjeffallan-django-expert.md) — skill · 4600 installs
- [django-developer](https://affpapa.org/en/nevibecode/agents/django-developer.md) — subagent · 344 installs
- [django-perf-review](https://affpapa.org/en/nevibecode/skills/django-perf-review.md) — skill · 3200 installs

From the same set: [vintasoftware/django-ai-plugins](https://affpapa.org/en/nevibecode/by/vintasoftware/django-ai-plugins.md) — 5 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
