frappe-code-review — Claude Code skill: 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.
no license 546 installs ★ 177 updated 2026-10-24
npx skills add frappe/skills --skill frappe-code-review -a claude-codeWhat frappe-code-review 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.
What it helps with
- catch a mid-transaction commit before it ships
- audit a whitelist method for type confusion
- find a
db.deletewhose filter can arrive empty - size a time budget for a hot endpoint
- check a webhook for a signature and replay
Example prompts for the agent
- Review the diff in
api.pywith this checklist, start with correctness and security. - Go through the PR for
stock_entry.pyand tell me where state can silently go wrong. - Audit the
@frappe.whitelistmethods inapi.pyfor injection and permission bypass.
How to install frappe-code-review
1Skills CLI (Vercel)
npx skills add frappe/skills --skill frappe-code-review -a claude-code2Manually: put the files in place
~/.claude/skills/frappe-code-review/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/frappe-code-review/
1Skills CLI (Vercel)
npx skills add frappe/skills --skill frappe-code-review -a codex2Manually: put the files in place
.agents/skills/frappe-code-review/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add frappe/skills --skill frappe-code-review -a cursor2Manually: put the files in place
.cursor/skills/frappe-code-review/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install frappe/skills skills/frappe-code-review2Manually: put the files in place
.github/skills/frappe-code-review/SKILL.md1Skills CLI (Vercel)
npx skills add frappe/skills --skill frappe-code-review -a gemini-cli2Platform CLI
gemini skills install https://github.com/frappe/skills --path skills/frappe-code-reviewManually: put the files in place
.devin/skills/frappe-code-review/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add frappe/skills --skill frappe-code-review -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about frappe-code-review
How to install frappe-code-review in Claude Code?
Run npx skills add frappe/skills --skill frappe-code-review -a claude-code. The skill lands in ~/.claude/skills/frappe-code-review/SKILL.md.
What does frappe-code-review do?
It gives the agent a review checklist for Frappe apps: transaction atomicity, injection, access control, indexes and response-time budgets. Works on a diff, a PR or a single file.
Does the skill work outside Frappe?
No. The items lean on frappe.db, frappe.qb and the @frappe.whitelist decorator, so most of them do not apply to another framework.