frappe-app-dev — Claude Code skill: what it does, how to install
Guides full-stack development for the Frappe Framework. It handles DocType setup, controller hooks, REST APIs, and bench CLI commands.
npx skills add frappe/skills --skill frappe-app-dev -a claude-codeWhat frappe-app-dev does
This skill structures full-stack Frappe Framework workflows directly inside the coding assistant. It guides tasks from scaffolding new sites to writing DocType controllers, @frappe.whitelist() endpoints, and WebSocket events. Instead of wasting turns on discovery commands like bench --version, the agent inspects the file tree directly with ls apps/ sites/ Procfile.
The rules enforce strict execution constraints. Folders for DocTypes must not be created manually with mkdir, because the framework creates them during migrations. Every bench migration command requires an explicit --site <site> flag, preventing unintended modifications across multiple sites in the same environment.
What it helps with
- scaffold new DocTypes and configure controller lifecycle hooks
- create REST endpoints using the
@frappe.whitelist()decorator - dispatch asynchronous background jobs with
frappe.enqueue - run site-specific migrations using explicit bench flags
Example prompts for the agent
- Add a custom field to the Customer DocType and run migrate for site test.local
- Write a whitelisted API method that returns order records
- Create a scheduled background task in hooks.py
How to install frappe-app-dev
1Skills CLI (Vercel)
npx skills add frappe/skills --skill frappe-app-dev -a claude-code2Manually: put the files in place
~/.claude/skills/frappe-app-dev/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/frappe-app-dev/
1Skills CLI (Vercel)
npx skills add frappe/skills --skill frappe-app-dev -a codex2Manually: put the files in place
.agents/skills/frappe-app-dev/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add frappe/skills --skill frappe-app-dev -a cursor2Manually: put the files in place
.cursor/skills/frappe-app-dev/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install frappe/skills frappe-app-dev2Manually: put the files in place
.github/skills/frappe-app-dev/SKILL.md1Skills CLI (Vercel)
npx skills add frappe/skills --skill frappe-app-dev -a gemini-cli2Platform CLI
gemini skills install https://github.com/frappe/skills --path skills/frappe-app-devManually: put the files in place
.devin/skills/frappe-app-dev/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add frappe/skills --skill frappe-app-dev -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-app-dev
How to install frappe-app-dev in Claude Code?
Run npx skills add frappe/skills --skill frappe-app-dev -a claude-code in your terminal.
What does frappe-app-dev do?
It guides the agent through building Frappe applications, managing DocTypes, database queries, and background workers.
Why does the skill require an explicit --site flag?
It forbids bare bench commands to ensure changes apply only to the intended site rather than affecting other databases in the bench.
