Skip to content

Commit 943d95d

Browse files
FreekHeijtingclaude
andcommitted
feat: V3.0 — 60 skills, ~95% Frappe Framework coverage
7 new skills: - frappe-core-translation (i18n, _(), CSV/PO files) - frappe-core-utils (140+ utility functions reference) - frappe-syntax-print (print formats, PDF generation) - frappe-syntax-query-builder (frappe.qb, joins, cross-DB) - frappe-impl-workspace (workspace builder, number cards, charts) - frappe-core-logging (frappe.logger, Error Log, Sentry) - frappe-core-search (link search, global search, SQLiteSearch FTS5) 12 existing skills extended with 13 new reference files: - controls-api, tree-view, generators, print-format-decision - email-system, module-workspace-shipping, document-api-complete - custom-commands, request-lifecycle, advanced-debugging - frappe-packages, data-masking, type-stubs Coverage: 53 → 60 skills, ~85% → ~95% surface area Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent aae1ff7 commit 943d95d

58 files changed

Lines changed: 11519 additions & 48 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

CHANGELOG.md

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,30 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
77

88
## [Unreleased]
99

10+
## [3.0.0] - 2026-03-21
11+
12+
### Added
13+
- 7 new skills: frappe-core-translation, frappe-core-utils, frappe-syntax-print, frappe-syntax-query-builder, frappe-impl-workspace, frappe-core-logging, frappe-core-search
14+
- 13 new reference files extending 12 existing skills (controls-api, tree-view, generators, print-format-decision, email-system, module-workspace-shipping, document-api-complete, custom-commands, request-lifecycle, advanced-debugging, frappe-packages, data-masking, type-stubs)
15+
16+
### Changed
17+
- Total skill count: 53 → 60
18+
- Framework coverage: ~85% → ~95%
19+
- INDEX.md rebuilt with all 60 skills and expanded selection guide
20+
- README.md updated with v3.0 stats
21+
22+
## [2.0.0] - 2026-03-20
23+
24+
### Added
25+
- 25 new skills (ops, testing, agents, syntax, core, impl categories)
26+
- All 28 existing skills fully rewritten with fresh research
27+
- Renamed erpnext-* → frappe-* (all 28 existing skills)
28+
29+
### Changed
30+
- Total skill count: 28 → 53
31+
- Framework coverage: ~16% → ~85%
32+
- 7 categories (added ops/, testing/)
33+
1034
## [1.2.0] - 2026-01-18
1135

1236
### Added

INDEX.md

Lines changed: 33 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,19 @@
11
# Frappe Claude Skill Package — Index
22

3-
> 53 deterministic skills for Frappe Framework v14-v16 development and operations.
3+
> 60 deterministic skills for Frappe Framework v14-v16 development and operations.
44
55
## Quick Stats
66

77
| Category | Count | Purpose |
88
|----------|:-----:|---------|
9-
| syntax/ | 11 | Code syntax reference |
10-
| core/ | 7 | Cross-cutting concerns |
11-
| impl/ | 13 | Implementation workflows |
9+
| syntax/ | 13 | Code syntax reference |
10+
| core/ | 11 | Cross-cutting concerns |
11+
| impl/ | 14 | Implementation workflows |
1212
| errors/ | 7 | Error handling |
1313
| ops/ | 8 | Operations & deployment |
1414
| agents/ | 5 | Intelligent agents |
1515
| testing/ | 2 | Quality & CI/CD |
16-
| **Total** | **53** | |
16+
| **Total** | **60** | |
1717

1818
## Skills by Category
1919

@@ -28,6 +28,8 @@
2828
| [frappe-syntax-hooks](skills/source/syntax/frappe-syntax-hooks/) | Use when configuring Frappe hooks.py for app events, scheduler tasks, document events, fixtures, boot session, jenv customization, or website routing. |
2929
| [frappe-syntax-hooks-events](skills/source/syntax/frappe-syntax-hooks-events/) | Use when implementing document lifecycle hooks via doc_events in hooks.py, understanding event execution order, or extending/overriding document behavior from another app. |
3030
| [frappe-syntax-jinja](skills/source/syntax/frappe-syntax-jinja/) | Use when writing Jinja templates for ERPNext/Frappe Print Formats, Email Templates, and Portal Pages. |
31+
| [frappe-syntax-print](skills/source/syntax/frappe-syntax-print/) | Use when creating print formats or generating PDFs in Frappe v14-v16. Covers Jinja, Print Designer, Letter Head, get_pdf(). |
32+
| [frappe-syntax-query-builder](skills/source/syntax/frappe-syntax-query-builder/) | Use when building database queries with frappe.qb in Frappe v14-v16. Covers joins, aggregation, cross-DB compatibility. |
3133
| [frappe-syntax-reports](skills/source/syntax/frappe-syntax-reports/) | Use when building Query Reports, Script Reports, or configuring Report Builder, including chart data integration. |
3234
| [frappe-syntax-scheduler](skills/source/syntax/frappe-syntax-scheduler/) | Use when configuring scheduler events and background jobs in Frappe/ERPNext v14/v15/v16. |
3335
| [frappe-syntax-serverscripts](skills/source/syntax/frappe-syntax-serverscripts/) | Use when writing Python code for ERPNext/Frappe Server Scripts including Document Events, API endpoints, Scheduler Events, and Permission Queries. |
@@ -41,8 +43,12 @@
4143
| [frappe-core-cache](skills/source/core/frappe-core-cache/) | Use when implementing Redis caching, cache invalidation, or distributed locking in Frappe. |
4244
| [frappe-core-database](skills/source/core/frappe-core-database/) | Use when performing database operations in ERPNext/Frappe v14-v16. |
4345
| [frappe-core-files](skills/source/core/frappe-core-files/) | Use when handling file uploads, attachments, private/public file access, or S3 storage configuration. |
46+
| [frappe-core-logging](skills/source/core/frappe-core-logging/) | Use when implementing logging, error tracking, or monitoring in Frappe v14-v16. Covers frappe.logger(), log_error(), Sentry. |
4447
| [frappe-core-notifications](skills/source/core/frappe-core-notifications/) | Use when implementing email notifications, system alerts, Assignment Rules, Auto Repeat, or ToDo items. |
4548
| [frappe-core-permissions](skills/source/core/frappe-core-permissions/) | Use when implementing the Frappe/ERPNext permission system. |
49+
| [frappe-core-search](skills/source/core/frappe-core-search/) | Use when implementing search functionality in Frappe v14-v16. Covers link search, global search, SQLiteSearch FTS5. |
50+
| [frappe-core-translation](skills/source/core/frappe-core-translation/) | Use when implementing translations/i18n in Frappe v14-v16 apps. Covers _(), __(), CSV/PO files, string extraction. |
51+
| [frappe-core-utils](skills/source/core/frappe-core-utils/) | Use when working with utility functions in Frappe v14-v16. Covers 140+ date, number, string, validation functions. |
4652
| [frappe-core-workflow](skills/source/core/frappe-core-workflow/) | Use when creating or modifying Frappe Workflows, defining states and transitions, adding action conditions, or troubleshooting workflow permission errors. |
4753

4854
### impl/ — Implementation Workflows
@@ -62,6 +68,7 @@
6268
| [frappe-impl-website](skills/source/impl/frappe-impl-website/) | Use when building portal pages, Web Forms, website routes, or configuring themes and SEO in Frappe. |
6369
| [frappe-impl-whitelisted](skills/source/impl/frappe-impl-whitelisted/) | Use when building API endpoints with @frappe.whitelist() in Frappe. |
6470
| [frappe-impl-workflow](skills/source/impl/frappe-impl-workflow/) | Use when implementing document Workflows, approval chains, or state-based transitions in Frappe. |
71+
| [frappe-impl-workspace](skills/source/impl/frappe-impl-workspace/) | Use when creating or customizing Workspace pages in Frappe v14-v16. Covers shortcuts, number cards, charts, JSON format. |
6572

6673
### errors/ — Error Handling
6774

@@ -128,8 +135,8 @@ What do you need to build?
128135
├─► Build API endpoints
129136
│ └─► syntax-whitelisted + impl-whitelisted + core-api + errors-api
130137
131-
├─► Print formats / Templates
132-
│ └─► syntax-jinja + impl-jinja
138+
├─► Print formats / Templates / PDF
139+
│ └─► syntax-print + syntax-jinja + impl-jinja
133140
134141
├─► Reports & Dashboards
135142
│ └─► syntax-reports + impl-reports
@@ -152,6 +159,24 @@ What do you need to build?
152159
├─► Website / Portal
153160
│ └─► impl-website + syntax-jinja + impl-jinja
154161
162+
├─► Translation / i18n
163+
│ └─► core-translation
164+
165+
├─► Utility functions (date, money, string)
166+
│ └─► core-utils
167+
168+
├─► Search functionality
169+
│ └─► core-search
170+
171+
├─► Logging & error tracking
172+
│ └─► core-logging + agent-debugger
173+
174+
├─► Workspace / Dashboard
175+
│ └─► impl-workspace + impl-ui-components
176+
177+
├─► Complex database queries
178+
│ └─► syntax-query-builder + core-database
179+
155180
├─► Deploy to production
156181
│ └─► ops-deployment + ops-bench + ops-performance + ops-backup
157182
@@ -185,4 +210,4 @@ What do you need to build?
185210

186211
---
187212

188-
*Frappe Claude Skill Package v2.0 | 53 skills | Last updated: 2026-03-20*
213+
*Frappe Claude Skill Package v3.0 | 60 skills | Last updated: 2026-03-21*

README.md

Lines changed: 14 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
<p align="center">
2-
<img src="docs/social-preview.png" alt="53 Deterministic Claude AI Skills for Frappe Framework" width="100%">
2+
<img src="docs/social-preview.png" alt="60 Deterministic Claude AI Skills for Frappe Framework" width="100%">
33
</p>
44

55
<p align="center">
66
<a href="#-installation"><img src="https://img.shields.io/badge/Claude_Code-Ready-27ca40?style=for-the-badge" alt="Claude Code Ready"></a>
77
<a href="#-version-compatibility"><img src="https://img.shields.io/badge/Frappe-v14_|_v15_|_v16-0089FF?style=for-the-badge" alt="Frappe Versions"></a>
88
<a href="https://agentskills.org"><img src="https://img.shields.io/badge/Agent_Skills-Standard-DA7756?style=for-the-badge" alt="Agent Skills Standard"></a>
99
<a href="LICENSE.md"><img src="https://img.shields.io/badge/License-MIT-lightgrey?style=for-the-badge" alt="MIT License"></a>
10-
<a href="#-skill-categories"><img src="https://img.shields.io/badge/v2.0-53_skills-blueviolet?style=for-the-badge" alt="v2.0 — 53 Skills"></a>
10+
<a href="#-skill-categories"><img src="https://img.shields.io/badge/v3.0-60_skills-blueviolet?style=for-the-badge" alt="v3.0 — 60 Skills"></a>
1111
</p>
1212

1313
<p align="center">
14-
<strong>53 deterministic skills</strong> enabling Claude AI to generate flawless Frappe/ERPNext code.<br>
15-
Covers ~85% of the Frappe Framework surface area across 7 categories.<br>
14+
<strong>60 deterministic skills</strong> enabling Claude AI to generate flawless Frappe/ERPNext code.<br>
15+
Covers ~95% of the Frappe Framework surface area across 7 categories.<br>
1616
Built on the <a href="https://agentskills.org">Agent Skills</a> open standard.
1717
</p>
1818

@@ -34,23 +34,23 @@ today = nowdate()
3434
today = frappe.utils.nowdate()
3535
```
3636

37-
This package encodes **53 hard-won lessons** like this into deterministic skills that Claude follows automatically.
37+
This package encodes **60 hard-won lessons** like this into deterministic skills that Claude follows automatically.
3838

3939
---
4040

4141
## 📦 Skill Categories
4242

4343
| Category | Count | What's Covered |
4444
|:---------|:-----:|:---------------|
45-
| **Syntax** | 11 | Client scripts, server scripts, controllers, hooks, whitelisting, Jinja templating, scheduler events, custom apps, form manipulation, workspace configuration, print formats |
46-
| **Core** | 7 | Database operations, permissions system, REST API patterns, DocType architecture, naming rules, caching, background jobs |
47-
| **Implementation** | 13 | Step-by-step development workflows for common tasks, migrations, fixtures, data import/export, custom fields, report builder, dashboard creation |
45+
| **Syntax** | 13 | Client scripts, server scripts, controllers, hooks, Jinja, scheduler, custom apps, print formats, query builder |
46+
| **Core** | 11 | Database, permissions, REST API, caching, files, notifications, workflow, translation/i18n, utilities, logging, search |
47+
| **Implementation** | 14 | Development workflows, migrations, fixtures, integrations, reports, UI components, website, workspaces |
4848
| **Error Handling** | 7 | Production-ready error patterns and debugging |
49-
| **Operations** | 8 | Deployment, bench management, site configuration, backup/restore, monitoring, multi-tenancy, update procedures, performance tuning |
50-
| **Agents** | 5 | Code interpretation, validation, migration planning, test generation, review automation |
51-
| **Testing** | 2 | Unit testing patterns, integration test workflows |
49+
| **Operations** | 8 | Deployment, bench management, backup/restore, monitoring, performance tuning, upgrades |
50+
| **Agents** | 5 | Code interpretation, validation, migration planning, architecture, debugging |
51+
| **Testing** | 2 | Unit testing patterns, CI/CD workflows |
5252

53-
**Total: 53 skills covering ~85% of the Frappe Framework surface area** (up from 28 skills / ~16% in v1.x).
53+
**Total: 60 skills covering ~95% of the Frappe Framework surface area** (up from 53 skills / ~85% in v2.0).
5454

5555
---
5656

@@ -62,7 +62,7 @@ This package encodes **53 hard-won lessons** like this into deterministic skills
6262
# Clone the repository
6363
git clone https://github.com/OpenAEC-Foundation/Frappe_Claude_Skill_Package.git
6464

65-
# Copy all 53 skills to your Claude Code skills directory
65+
# Copy all 60 skills to your Claude Code skills directory
6666
cp -r Frappe_Claude_Skill_Package/skills/source/* ~/.claude/skills/
6767
```
6868

@@ -81,7 +81,7 @@ cp -r Frappe_Claude_Skill_Package/skills/source/* ~/.claude/skills/
8181

8282
## 🔄 Version Compatibility
8383

84-
All 53 skills document version-specific behavior for Frappe Framework v14 through v16.
84+
All 60 skills document version-specific behavior for Frappe Framework v14 through v16.
8585

8686
| Feature | v14 | v15 | v16 |
8787
|:--------|:---:|:---:|:---:|

ROADMAP.md

Lines changed: 45 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@
33
> **📍 Dit is de SINGLE SOURCE OF TRUTH voor project status en voortgang.**
44
> Claude Project Instructies verwijzen hiernaar - geen dubbele tracking.
55
6-
> **Laatste update**: 2026-03-20
7-
> **Status**: V2.0 COMPLEET — V3.0 GEPLAND
6+
> **Laatste update**: 2026-03-21
7+
> **Status**: V3.0 COMPLEET — Release pending
88
> **V3 Gap Analysis**: [frappe-skill-package-gap-analysis-v3.md](docs/masterplan/frappe-skill-package-gap-analysis-v3.md)
99
> **V2 Tech Spec**: [frappe-skill-package-tech-spec-v2.md](docs/masterplan/frappe-skill-package-tech-spec-v2.md)
1010
> **V2 Gap Analysis**: [frappe-skill-package-gap-analysis.md](docs/masterplan/frappe-skill-package-gap-analysis.md)
@@ -67,22 +67,22 @@
6767

6868
| Categorie | Voltooid | Totaal |
6969
|-----------|:--------:|:------:|
70-
| Nieuwe skills (P0: translation, utils) | 0 | 2 |
71-
| Nieuwe skills (P1: print, query-builder, workspace) | 0 | 3 |
72-
| Nieuwe skills (P2: logging, search) | 0 | 2 |
73-
| Uitbreidingen bestaande skills | 0 | 12 |
74-
| **TOTAAL v3.0** | **0** | **19** |
70+
| Nieuwe skills (P0: translation, utils) | 2 | 2 |
71+
| Nieuwe skills (P1: print, query-builder, workspace) | 3 | 3 |
72+
| Nieuwe skills (P2: logging, search) | 2 | 2 |
73+
| Uitbreidingen bestaande skills | 12 | 12 |
74+
| **TOTAAL v3.0** | **19** | **19** |
7575

76-
**V3 Progress**: ░░░░░░░░░░░░░░░░░░░░ **0%**Gepland
76+
**V3 Progress**: ████████████████████ **100%**Alle 60 skills compleet!
7777

7878
### V3 Fasen
7979

8080
| Fase | Beschrijving | Status |
8181
|------|-------------|:------:|
82-
| V3.1 | Research voor 7 nieuwe skills | ⏳ Gepland |
83-
| V3.2 | Nieuwe skills creeren (P0 -> P1 -> P2) | ⏳ Gepland |
84-
| V3.3 | 12 bestaande skills uitbreiden | ⏳ Gepland |
85-
| V3.4 | Validatie + INDEX + README | ⏳ Gepland |
82+
| V3.1 | Research voor 7 nieuwe skills | ✅ Compleet |
83+
| V3.2 | Nieuwe skills creeren (P0 -> P1 -> P2) | ✅ Compleet |
84+
| V3.3 | 12 bestaande skills uitbreiden | ✅ Compleet |
85+
| V3.4 | Validatie + INDEX + README | ✅ Compleet |
8686
| V3.5 | Release v3.0.0 | ⏳ Gepland |
8787

8888
### V3 Nieuwe Skills
@@ -219,6 +219,14 @@ Alle 28 skills en agents voltooid en gedocumenteerd.
219219

220220
## Release History
221221

222+
### v3.0.0 (2026-03-21) - Full Coverage (~95%) ✅
223+
224+
- 60 skills (was 53) across 7 categories
225+
- 7 new skills: translation, utils, print, query-builder, workspace, logging, search
226+
- 12 existing skills extended with new reference files
227+
- ~95% Frappe Framework surface area coverage (was ~85%)
228+
- All 60 skills validated (under 500 lines, valid frontmatter)
229+
222230
### v2.0.0 (2026-03-20) - Frappe Framework Full Coverage ✅
223231

224232
- 53 skills (was 28) across 7 categories
@@ -271,6 +279,26 @@ Alle 28 skills en agents voltooid en gedocumenteerd.
271279

272280
## Changelog
273281

282+
### 2026-03-21 (sessie 26) - V3.0 COMPLEET
283+
284+
**V3.0 Upgrade — 53 skills -> 60 skills + 12 uitbreidingen:**
285+
- V3.1: Research voor 7 nieuwe skills (5 agents parallel)
286+
- V3.2: 7 nieuwe skills gecreeerd (P0: translation, utils; P1: print, query-builder, workspace; P2: logging, search)
287+
- V3.3: 12 bestaande skills uitgebreid met nieuwe reference files (12 agents parallel)
288+
- V3.4: Validatie (60/60 pass), INDEX.md herbouwd, README.md geupdate
289+
- Issue #14 gesloten (topics waren al ingesteld)
290+
291+
**Totaal: 60 skills, ~95% Frappe surface area dekking**
292+
- syntax: 13 skills (+2: print, query-builder)
293+
- core: 11 skills (+4: translation, utils, logging, search)
294+
- impl: 14 skills (+1: workspace)
295+
- errors: 7 skills (unchanged)
296+
- ops: 8 skills (unchanged)
297+
- agents: 5 skills (unchanged)
298+
- testing: 2 skills (unchanged)
299+
300+
---
301+
274302
### 2026-03-20 (sessie 25) - V2.0 COMPLEET
275303

276304
**V2.0 Massive Upgrade — 28 skills -> 53 skills:**
@@ -354,13 +382,12 @@ Alle 28 skills en agents voltooid en gedocumenteerd.
354382

355383
## Next Steps
356384

357-
🎉 **Project is feature-complete!**
385+
🎉 **V3.0 feature-complete! 60 skills, ~95% coverage.**
358386

359-
Handmatige acties nog nodig:
360-
1. Repository public maken via GitHub UI
361-
2. Topics toevoegen (Issue #14): `erpnext`, `frappe`, `claude`, `anthropic`, `skills`, `ai-coding`
362-
3. Description toevoegen: "28 deterministic skills for Claude to generate flawless ERPNext/Frappe code"
363-
4. API tokens regenereren na public release
387+
Nog te doen:
388+
1. Release tag v3.0.0 aanmaken
389+
2. GitHub release publiceren
390+
3. Social preview banner updaten (60 skills)
364391

365392
---
366393

skills/source/agents/frappe-agent-debugger/SKILL.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,8 +3,8 @@ name: frappe-agent-debugger
33
description: >
44
Use when debugging Frappe errors, using bench console for live inspection, analyzing tracebacks, or reading Frappe log files.
55
Prevents wasted debugging time from ignoring log context, misreading tracebacks, and not using bench console effectively.
6-
Covers bench console, frappe.logger, error log DocType, traceback analysis, common error patterns, log file locations, pdb/debugger integration.
7-
Keywords: debug, bench console, traceback, error log, frappe.logger, pdb, debugging, log analysis, inspect.
6+
Covers bench console, frappe.logger, error log DocType, traceback analysis, common error patterns, log file locations, pdb/debugger integration, VS Code DAP, profiling, Frappe Recorder, mariadb diagnostics.
7+
Keywords: debug, bench console, traceback, error log, frappe.logger, pdb, debugging, log analysis, inspect, VS Code, DAP, profiling, recorder, mariadb, monitor.
88
license: MIT
99
compatibility: "Claude Code, Claude.ai Projects, Claude API. Frappe v14-v16."
1010
metadata:
@@ -274,3 +274,4 @@ ERROR RECEIVED
274274

275275
See [references/checklists.md](references/checklists.md) for complete diagnosis checklists.
276276
See [references/examples.md](references/examples.md) for debugging walkthrough examples.
277+
See [references/advanced-debugging.md](references/advanced-debugging.md) for VS Code DAP setup, bench console patterns, mariadb diagnostics, and profiling tools.

0 commit comments

Comments
 (0)