# frappe-code-review

frappe-code-review is a Claude Code skill that reviews Frappe apps by checklist, from correctness and stability to security and performance. Apply it to a diff, pull request or single file.

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

## What it does

The skill turns a review into an ordered pass. Correctness and stability come first, security next, performance last, and each finding has to say what breaks and for whom. Concurrency, readability, API design and testing get their own sections of the same checklist.

What it flags in practice: `frappe.db.commit()` or `db.rollback()` in the middle of a transaction, `set_value` and `db.delete` calls whose filter may be `None`, missing indexes on filtered columns, `allow_guest=True` used as a shortcut, webhooks without HMAC. Response-time budgets are spelled out too: common reads under 100ms, most writes under 5s, a slow synchronous request blocking a worker.

The sharpest item concerns types at trust boundaries. A `@frappe.whitelist` method that expects a string can be handed `{"key": ["!=", ""]}` and let a secret-key check pass, so the checklist asks for an explicit `isinstance` test. Everything here assumes a Frappe or ERPNext codebase built on `frappe.qb` and the whitelist decorator.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add frappe/skills --skill frappe-code-review -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add frappe/skills --skill frappe-code-review -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add frappe/skills --skill frappe-code-review -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install frappe/skills skills/frappe-code-review
```

2. **Manually: put the files in place**
- File: `.github/skills/frappe-code-review/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add frappe/skills --skill frappe-code-review -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/frappe/skills --path skills/frappe-code-review
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add frappe/skills --skill frappe-code-review -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/frappe/skills/tree/HEAD/skills/frappe-code-review/SKILL.md

## When to use it
- catch a mid-transaction commit before it ships
- audit a whitelist method for type confusion
- find a `db.delete` whose filter can arrive empty
- size a time budget for a hot endpoint
- check a webhook for a signature and replay

## Example prompts
- Review the diff in `api.py` with this checklist, start with correctness and security.
- Go through the PR for `stock_entry.py` and tell me where state can silently go wrong.
- Audit the `@frappe.whitelist` methods in `api.py` for injection and permission bypass.

## Similar
- [frappe-agent](https://affpapa.org/en/nevibecode/plugins/frappe-agent.md) — plugin · ★ 1596 repo stars
- [Frappe Dev MCP Server](https://affpapa.org/en/nevibecode/mcp/frappe-dev-mcp-server.md) — MCP server · ★ 5 repo stars
- [Pacioli — the ERPNext broker you can hand the books](https://affpapa.org/en/nevibecode/mcp/pacioli-the-erpnext-broker-you-can-hand-the-books.md) — MCP server · ★ 8 repo stars
- [python-code-review-expert](https://affpapa.org/en/nevibecode/agents/python-code-review-expert.md) — subagent · ★ 372 repo stars
- [ponytail-review](https://affpapa.org/en/nevibecode/skills/ponytail-review.md) — skill · 75500 installs
- [php-code-review-expert](https://affpapa.org/en/nevibecode/agents/php-code-review-expert.md) — subagent · ★ 372 repo stars

From the same set: [frappe/skills](https://affpapa.org/en/nevibecode/by/frappe/skills.md) — 10 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
