Frappe_Claude_Skill_Package

61 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 61 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	9	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: 61 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 61 skills to your Claude Code skills directory
cp -r Frappe_Claude_Skill_Package/skills/source/* ~/.claude/skills/

Claude.ai Web/Desktop

1. Download skill folders from skills/source/
2. ZIP each folder individually
3. Upload via Settings → Capabilities → Skills

Claude.ai Projects

1. Create a new project
2. Upload SKILL.md files to the Knowledge section

---

🔄 Version Compatibility

All 61 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}

⭐ Star this repo if it helps you!