Skip to content

Commit 3ca4366

Browse files
dwk-123dwk-123
committed
Update: add verified agent harness support
1 parent f969f28 commit 3ca4366

10 files changed

Lines changed: 431 additions & 175 deletions

‎INSTALL.md‎

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,11 @@
1-
-e # Installation Guide
1+
# Installation Guide
22

3-
> **This file has been replaced by [USAGE.md](USAGE.md)**
3+
> **This file has been replaced by [USAGE.md](USAGE.md).**
44
5-
Please see [USAGE.md](USAGE.md) for platform-specific installation guides:
5+
Please see:
66

7+
- [USAGE.md](USAGE.md) for the main guide
8+
- [Agent Harnesses: OpenCode, Codex, skills.sh](docs/usage/agent-harnesses.md)
79
- [Claude Code Installation](docs/usage/claude-code.md)
810
- [Claude.ai Web Installation](docs/usage/claude-web.md)
911
- [Claude Desktop Installation](docs/usage/claude-desktop.md)

‎MIGRATION-AGENT-SKILLS-STANDARD.md‎

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -72,15 +72,16 @@ Voeg aan INSTALL.md of USAGE.md de volgende sectie toe:
7272
```markdown
7373
### Globale installatie (Claude Code CLI)
7474

75-
Kopieer alle skills naar je globale skills directory zodat ze in elk project beschikbaar zijn:
75+
Kopieer alle skill folders naar je globale skills directory zodat ze in elk project beschikbaar zijn:
7676

77-
cp -r skills/source/* ~/.claude/skills/
77+
mkdir -p ~/.claude/skills
78+
cp -R skills/source/*/* ~/.claude/skills/
7879

7980
De skills gebruiken progressive disclosure: bij startup laadt Claude alleen
8081
de name en description (~100 tokens per skill). De volledige instructies
8182
worden pas geladen wanneer een skill relevant is voor je vraag.
8283

83-
28 skills × ~100 tokens = ~2.800 tokens startup-overhead. Dit is verwaarloosbaar
84+
61 skills × ~100 tokens = ~6.100 tokens startup-overhead. Dit is verwaarloosbaar
8485
op een context window van 200k tokens.
8586
```
8687

‎README.md‎

Lines changed: 18 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -56,26 +56,36 @@ This package encodes **61 hard-won lessons** like this into deterministic skills
5656

5757
## 🚀 Installation
5858

59-
### Claude Code (Recommended)
59+
### OpenCode, Codex, and skills.sh
60+
61+
See [`docs/usage/agent-harnesses.md`](docs/usage/agent-harnesses.md) for verified OpenCode, Codex, Claude Code, and `skills.sh` install paths.
62+
63+
```bash
64+
# Safe discovery command; lists all 61 skills without installing
65+
npx skills@1.5.13 add Impertio-Studio/Frappe_Claude_Skill_Package --list
66+
```
67+
68+
### Claude Code
6069

6170
```bash
6271
# Clone the repository
63-
git clone https://github.com/OpenAEC-Foundation/Frappe_Claude_Skill_Package.git
72+
git clone https://github.com/Impertio-Studio/Frappe_Claude_Skill_Package.git
6473

65-
# Copy all 61 skills to your Claude Code skills directory
66-
cp -r Frappe_Claude_Skill_Package/skills/source/* ~/.claude/skills/
74+
# Copy all 61 skill folders to your Claude Code skills directory
75+
mkdir -p ~/.claude/skills
76+
cp -R Frappe_Claude_Skill_Package/skills/source/*/* ~/.claude/skills/
6777
```
6878

6979
### Claude.ai Web/Desktop
7080

7181
1. Download skill folders from [`skills/source/`](skills/source/)
72-
2. ZIP each folder individually
82+
2. ZIP each skill folder individually, with `SKILL.md` at the folder root
7383
3. Upload via **Settings → Capabilities → Skills**
7484

7585
### Claude.ai Projects
7686

7787
1. Create a new project
78-
2. Upload `SKILL.md` files to the **Knowledge** section
88+
2. Upload relevant `SKILL.md` files to the **Knowledge** section
7989

8090
---
8191

@@ -111,7 +121,7 @@ This package also serves as a **template** for building Claude skill packages in
111121

112122
See [`WAY_OF_WORK.md`](WAY_OF_WORK.md) for the methodology we used to build these skills.
113123

114-
**Found an issue?** [Open an issue](https://github.com/OpenAEC-Foundation/Frappe_Claude_Skill_Package/issues/new)
124+
**Found an issue?** [Open an issue](https://github.com/Impertio-Studio/Frappe_Claude_Skill_Package/issues/new)
115125
**Want to contribute?** PRs welcome!
116126

117127
---
@@ -145,5 +155,5 @@ MIT — See [LICENSE.md](LICENSE.md) for details.
145155
</p>
146156

147157
<p align="center">
148-
<a href="https://github.com/OpenAEC-Foundation/Frappe_Claude_Skill_Package/stargazers">⭐ Star this repo if it helps you!</a>
158+
<a href="https://github.com/Impertio-Studio/Frappe_Claude_Skill_Package/stargazers">⭐ Star this repo if it helps you!</a>
149159
</p>

‎USAGE.md‎

Lines changed: 39 additions & 70 deletions
Original file line numberDiff line numberDiff line change
@@ -1,78 +1,47 @@
1-
# Using the ERPNext Skills Package
1+
# Using the Frappe Skills Package
22

3-
This guide shows you how to install and use the ERPNext Skills Package across different Claude platforms.
3+
This guide shows how to install and use the 61 Frappe/ERPNext Agent Skills across Claude platforms and other agent harnesses.
44

55
## Quick Start
66

77
| Platform | Installation Time | Difficulty |
88
|----------|:-----------------:|:----------:|
9-
| Claude Code (CLI) | 2 minutes | Easy |
10-
| Claude.ai Web | 5 minutes | Easy |
11-
| Claude Desktop | 5 minutes | Easy |
9+
| Claude Code | 2 minutes | Easy |
10+
| OpenCode / Codex | 2 minutes | Easy |
11+
| Claude.ai Web/Desktop | 5 minutes | Easy |
1212
| Claude Mobile | ❌ Not supported | - |
1313

1414
## Prerequisites
1515

16-
- **Claude Code**: Active Claude Code installation
16+
- **Claude Code**: active Claude Code installation
17+
- **OpenCode/Codex**: agent with Agent Skills support
1718
- **Claude.ai / Desktop**: Pro, Max, Team, or Enterprise plan with Code Execution enabled
1819

1920
## Platform-Specific Guides
2021

21-
- [Claude Code Installation](docs/usage/claude-code.md) - Recommended for developers
22-
- [Claude.ai Web Installation](docs/usage/claude-web.md) - Browser-based usage
23-
- [Claude Desktop Installation](docs/usage/claude-desktop.md) - Desktop app usage
22+
- [Agent Harnesses: OpenCode, Codex, skills.sh](docs/usage/agent-harnesses.md)
23+
- [Claude Code Installation](docs/usage/claude-code.md)
24+
- [Claude.ai Web Installation](docs/usage/claude-web.md)
25+
- [Claude Desktop Installation](docs/usage/claude-desktop.md)
2426

2527
## What's Included
2628

27-
This package contains 28 skills organized by category:
28-
29-
### Syntax Skills (8)
30-
Reference guides for ERPNext/Frappe code patterns:
31-
- `syntax-client-scripts` - Client Script syntax and events
32-
- `syntax-server-scripts` - Server Script sandbox rules
33-
- `syntax-controllers` - Document controller methods
34-
- `syntax-hooks` - hooks.py configuration
35-
- `syntax-whitelisted` - @frappe.whitelist() patterns
36-
- `syntax-jinja` - Jinja templating in print formats
37-
- `syntax-scheduler` - Scheduled job configuration
38-
- `syntax-custom-app` - Custom app structure
39-
40-
### Core Skills (3)
41-
Fundamental Frappe framework knowledge:
42-
- `core-database` - Database operations and ORM
43-
- `core-permissions` - Permission system
44-
- `core-api-patterns` - API design patterns
45-
46-
### Implementation Skills (8)
47-
Step-by-step workflows:
48-
- `impl-client-scripts` - Client Script implementation
49-
- `impl-server-scripts` - Server Script implementation
50-
- `impl-controllers` - Controller implementation
51-
- `impl-hooks` - Hooks implementation
52-
- `impl-database` - Database operation workflows
53-
- `impl-permissions` - Permission implementation
54-
- `impl-api` - API implementation
55-
- `impl-scheduler` - Scheduler implementation
56-
- `impl-jinja` - Print format implementation
57-
58-
### Error Handling Skills (7)
59-
Debugging and troubleshooting:
60-
- `errors-client` - Client-side error handling
61-
- `errors-server` - Server-side error handling
62-
- `errors-database` - Database error handling
63-
- `errors-permissions` - Permission error handling
64-
- `errors-api` - API error handling
65-
- `errors-scheduler` - Scheduler error handling
66-
- `errors-print` - Print format error handling
67-
68-
### Agents (2)
69-
Intelligent assistants:
70-
- `agent-erpnext-dev` - Full-stack ERPNext development
71-
- `agent-code-review` - ERPNext code review
29+
This package contains 61 skills organized by category:
30+
31+
| Category | Count | Examples |
32+
|---|:---:|---|
33+
| Syntax | 13 | `frappe-syntax-serverscripts`, `frappe-syntax-doctypes`, `frappe-syntax-query-builder` |
34+
| Core | 11 | `frappe-core-database`, `frappe-core-permissions`, `frappe-core-api` |
35+
| Implementation | 14 | `frappe-impl-serverscripts`, `frappe-impl-customapp`, `frappe-impl-workflow` |
36+
| Error Handling | 7 | `frappe-errors-serverscripts`, `frappe-errors-database`, `frappe-errors-api` |
37+
| Operations | 9 | `frappe-ops-deployment`, `frappe-ops-backup`, `frappe-ops-bench` |
38+
| Agents | 5 | `frappe-agent-validator`, `frappe-agent-architect`, `frappe-agent-debugger` |
39+
| Testing | 2 | `frappe-testing-unit`, `frappe-testing-cicd` |
7240

7341
## Version Compatibility
7442

75-
All skills support:
43+
All skills document version-specific behavior for:
44+
7645
- **Frappe/ERPNext v14** ✅
7746
- **Frappe/ERPNext v15** ✅
7847
- **Frappe/ERPNext v16** ✅
@@ -81,41 +50,41 @@ Version-specific differences are documented within each skill.
8150

8251
## How Skills Work
8352

84-
When you start a conversation, Claude loads only the skill names and descriptions (~100 tokens per skill). When your request matches a skill's description, Claude loads the full instructions. This "progressive disclosure" means you can have all 28 skills available without context bloat.
53+
When you start a conversation, the agent loads only skill names and descriptions. When your request matches a skill description, it loads the full instructions. This progressive disclosure keeps the 61-skill package usable without loading every full skill into context.
8554

8655
### Triggering Skills
8756

8857
Skills activate automatically based on your request:
8958

90-
```
59+
```text
9160
You: "Help me create a Server Script that validates Sales Orders"
92-
Claude: [Loads syntax-server-scripts and impl-server-scripts automatically]
61+
Agent: [Loads frappe-syntax-serverscripts and frappe-impl-serverscripts when relevant]
9362
```
9463

9564
You can also reference skills explicitly:
9665

97-
```
98-
You: "Using the server-scripts skill, show me the sandbox limitations"
66+
```text
67+
You: "Using frappe-syntax-serverscripts, show me the sandbox limitations"
9968
```
10069

10170
### Checking Available Skills
10271

103-
Ask Claude:
104-
```
105-
You: "What ERPNext skills do you have access to?"
72+
Ask your agent:
73+
74+
```text
75+
What Frappe skills do you have access to?
10676
```
10777

10878
## Global Installation (Claude Code CLI)
10979

110-
Copy all skills to your global skills directory so they're available in every project:
80+
Copy all skill folders to your global skills directory so they're available in every project:
11181

11282
```bash
113-
cp -r skills/source/* ~/.claude/skills/
83+
mkdir -p ~/.claude/skills
84+
cp -R skills/source/*/* ~/.claude/skills/
11485
```
11586

116-
The skills use progressive disclosure: at startup Claude only loads the name and description (~100 tokens per skill). Full instructions are loaded only when a skill is relevant to your request.
117-
118-
28 skills x ~100 tokens = ~2,800 tokens startup overhead. This is negligible on a 200k token context window.
87+
The skills use progressive disclosure: at startup the agent only loads each name and description. Full instructions are loaded only when a skill is relevant to your request.
11988

12089
## Critical: Server Script Sandbox
12190

@@ -137,9 +106,9 @@ This is the #1 cause of AI-generated ERPNext code failures. All skills in this p
137106

138107
## Support
139108

140-
- **Issues**: [GitHub Issues](https://github.com/OpenAEC-Foundation/Frappe_Claude_Skill_Package/issues)
109+
- **Issues**: [GitHub Issues](https://github.com/Impertio-Studio/Frappe_Claude_Skill_Package/issues)
141110
- **Documentation**: [Full Documentation](docs/)
142111

143112
## License
144113

145-
LGPL-3.0 License - See [LICENSE](LICENSE.md) for details.
114+
MIT License - See [LICENSE](LICENSE.md) for details.

0 commit comments

Comments
 (0)