github.com/Impertio-Studio/Frappe_Claude_Skill_Package @v3.1.1
Chat with this repoWhat it actually does AI analysis from the code graph — generated when you open this
README
60 deterministic skills enabling Claude AI to generate flawless Frappe/ERPNext code.
Covers ~95% of the Frappe Framework surface area across 7 categories.
Built on the Agent Skills open standard.
🎯 Why This Exists
Claude is powerful, but without domain-specific guidance it generates Frappe/ERPNext code that looks correct but fails in production.
The #1 cause of AI-generated Frappe failures:
# ❌ WRONG - This fails silently in Server Scripts
from frappe.utils import nowdate
today = nowdate()
# ✅ CORRECT - Server Scripts block all imports
today = frappe.utils.nowdate()
This package encodes 60 hard-won lessons like this into deterministic skills that Claude follows automatically.
📦 Skill Categories
| Category | Count | What's Covered |
|---|---|---|
| Syntax | 13 | Client scripts, server scripts, controllers, hooks, Jinja, scheduler, custom apps, print formats, query builder |
| Core | 11 | Database, permissions, REST API, caching, files, notifications, workflow, translation/i18n, utilities, logging, search |
| Implementation | 14 | Development workflows, migrations, fixtures, integrations, reports, UI components, website, workspaces |
| Error Handling | 7 | Production-ready error patterns and debugging |
| Operations | 8 | Deployment, bench management, backup/restore, monitoring, performance tuning, upgrades |
| Agents | 5 | Code interpretation, validation, migration planning, architecture, debugging |
| Testing | 2 | Unit testing patterns, CI/CD workflows |
Total: 60 skills covering ~95% of the Frappe Framework surface area (up from 53 skills / ~85% in v2.0).
🚀 Installation
Claude Code (Recommended)
# Clone the repository
git clone https://github.com/OpenAEC-Foundation/Frappe_Claude_Skill_Package.git
# Copy all 60 skills to your Claude Code skills directory
cp -r Frappe_Claude_Skill_Package/skills/source/* ~/.claude/skills/
Claude.ai Web/Desktop
- Download skill folders from
skills/source/ - ZIP each folder individually
- Upload via Settings → Capabilities → Skills
Claude.ai Projects
- Create a new project
- Upload
SKILL.mdfiles to the Knowledge section
🔄 Version Compatibility
All 60 skills document version-specific behavior for Frappe Framework v14 through v16.
| Feature | v14 | v15 | v16 |
|---|---|---|---|
| Type annotations | ❌ | ✅ | ✅ |
| UUID autoname | ❌ | ✅ | ✅ |
| Data masking | ❌ | ❌ | ✅ |
| Scheduler improvements | ❌ | ✅ | ✅ |
| Virtual DocTypes | ❌ | ✅ | ✅ |
📚 Documentation
| Document | Description |
|---|---|
| INDEX.md | Complete skill catalog with descriptions and dependency graph |
| USAGE.md | Platform-specific installation guides |
| WAY_OF_WORK.md | 7-phase development methodology |
| LESSONS.md | Technical discoveries and gotchas |
| CHANGELOG.md | Version history |
🤝 Contributing
This package also serves as a template for building Claude skill packages in other technology domains.
See WAY_OF_WORK.md for the methodology we used to build these skills.
Found an issue? Open an issue Want to contribute? PRs welcome!
Companion Skills: Cross-Technology Integration
This package covers ERPNext and Frappe as individual technologies. When you need to bridge ERPNext with BIM/IFC tools, install the companion cross-technology package:
Cross-Tech AEC Integration Skills — 15 skills for technology boundaries
Relevant cross-tech skills for ERPNext users:
| Skill | Boundary | What it adds |
|---|---|---|
crosstech-impl-ifc-erpnext-costing |
IFC ↔ ERPNext | Extract IFC quantities → ERPNext BOMs, cost estimation pipeline |
crosstech-impl-n8n-aec-pipeline |
n8n ↔ ERPNext API | Automate IFC→ERPNext workflows with n8n |
crosstech-impl-docker-aec-stack |
Docker ↔ ERPNext | Containerized AEC stack with ERPNext integration |
crosstech-core-ifc-schema-bridge |
IFC ↔ All formats | IFC quantity sets, property sets, schema mapping |
📄 License
MIT — See LICENSE.md for details.
Built with ❤️ by OpenAEC Foundation
Open standards for AEC technology
Core symbols most depended-on inside this repo
replace_in_fileShape
Languages
Modules by API surface
For agents
$ claude mcp add Frappe_Claude_Skill_Package \
-- python -m otcore.mcp_server <graph>