feat: add discovery manifests and quality fixes

- Add package.json with agents.skills[] manifest (npm-agentskills standard, 60 skills)
- Add agents/openai.yaml for OpenAI Codex discoverability
- Add SKILLS_LOG.md to .gitignore
- Fix em-dashes in 31 SKILL.md section headings (replaced with colons)
- Add GitHub topic agentskills

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: FreekHeijting

.gitignore

@@ -45,3 +45,4 @@ build/
 
 # NOTE: .skill files are NOT ignored - they are our deliverables!
 # If you need to ignore local/draft skills, put them in a drafts/ folder
+SKILLS_LOG.md

agents/openai.yaml

@@ -0,0 +1,5 @@
+# OpenAI Codex skill discovery
+name: frappe-claude-skill-package
+description: >
+  60 deterministic Claude AI skills for Frappe Framework & ERPNext v14-v16 development and operations
+skills_directory: ./skills/source

package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@openaec/frappe-claude-skill-package",
+  "version": "1.0.0",
+  "description": "60 deterministic Claude AI skills for Frappe Framework & ERPNext v14-v16 development and operations",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/OpenAEC-Foundation/Frappe_Claude_Skill_Package"
+  },
+  "keywords": ["agent-skills", "agentskills", "claude-skills", "frappe", "erpnext", "python", "javascript"],
+  "agents": {
+    "skills": [
+      { "name": "frappe-agent-architect", "path": "./skills/source/agents/frappe-agent-architect" },
+      { "name": "frappe-agent-debugger", "path": "./skills/source/agents/frappe-agent-debugger" },
+      { "name": "frappe-agent-interpreter", "path": "./skills/source/agents/frappe-agent-interpreter" },
+      { "name": "frappe-agent-migrator", "path": "./skills/source/agents/frappe-agent-migrator" },
+      { "name": "frappe-agent-validator", "path": "./skills/source/agents/frappe-agent-validator" },
+      { "name": "frappe-core-api", "path": "./skills/source/core/frappe-core-api" },
+      { "name": "frappe-core-cache", "path": "./skills/source/core/frappe-core-cache" },
+      { "name": "frappe-core-database", "path": "./skills/source/core/frappe-core-database" },
+      { "name": "frappe-core-files", "path": "./skills/source/core/frappe-core-files" },
+      { "name": "frappe-core-logging", "path": "./skills/source/core/frappe-core-logging" },
+      { "name": "frappe-core-notifications", "path": "./skills/source/core/frappe-core-notifications" },
+      { "name": "frappe-core-permissions", "path": "./skills/source/core/frappe-core-permissions" },
+      { "name": "frappe-core-search", "path": "./skills/source/core/frappe-core-search" },
+      { "name": "frappe-core-translation", "path": "./skills/source/core/frappe-core-translation" },
+      { "name": "frappe-core-utils", "path": "./skills/source/core/frappe-core-utils" },
+      { "name": "frappe-core-workflow", "path": "./skills/source/core/frappe-core-workflow" },
+      { "name": "frappe-errors-api", "path": "./skills/source/errors/frappe-errors-api" },
+      { "name": "frappe-errors-clientscripts", "path": "./skills/source/errors/frappe-errors-clientscripts" },
+      { "name": "frappe-errors-controllers", "path": "./skills/source/errors/frappe-errors-controllers" },
+      { "name": "frappe-errors-database", "path": "./skills/source/errors/frappe-errors-database" },
+      { "name": "frappe-errors-hooks", "path": "./skills/source/errors/frappe-errors-hooks" },
+      { "name": "frappe-errors-permissions", "path": "./skills/source/errors/frappe-errors-permissions" },
+      { "name": "frappe-errors-serverscripts", "path": "./skills/source/errors/frappe-errors-serverscripts" },
+      { "name": "frappe-impl-clientscripts", "path": "./skills/source/impl/frappe-impl-clientscripts" },
+      { "name": "frappe-impl-controllers", "path": "./skills/source/impl/frappe-impl-controllers" },
+      { "name": "frappe-impl-customapp", "path": "./skills/source/impl/frappe-impl-customapp" },
+      { "name": "frappe-impl-hooks", "path": "./skills/source/impl/frappe-impl-hooks" },
+      { "name": "frappe-impl-integrations", "path": "./skills/source/impl/frappe-impl-integrations" },
+      { "name": "frappe-impl-jinja", "path": "./skills/source/impl/frappe-impl-jinja" },
+      { "name": "frappe-impl-reports", "path": "./skills/source/impl/frappe-impl-reports" },
+      { "name": "frappe-impl-scheduler", "path": "./skills/source/impl/frappe-impl-scheduler" },
+      { "name": "frappe-impl-serverscripts", "path": "./skills/source/impl/frappe-impl-serverscripts" },
+      { "name": "frappe-impl-ui-components", "path": "./skills/source/impl/frappe-impl-ui-components" },
+      { "name": "frappe-impl-website", "path": "./skills/source/impl/frappe-impl-website" },
+      { "name": "frappe-impl-whitelisted", "path": "./skills/source/impl/frappe-impl-whitelisted" },
+      { "name": "frappe-impl-workflow", "path": "./skills/source/impl/frappe-impl-workflow" },
+      { "name": "frappe-impl-workspace", "path": "./skills/source/impl/frappe-impl-workspace" },
+      { "name": "frappe-ops-app-lifecycle", "path": "./skills/source/ops/frappe-ops-app-lifecycle" },
+      { "name": "frappe-ops-backup", "path": "./skills/source/ops/frappe-ops-backup" },
+      { "name": "frappe-ops-bench", "path": "./skills/source/ops/frappe-ops-bench" },
+      { "name": "frappe-ops-cloud", "path": "./skills/source/ops/frappe-ops-cloud" },
+      { "name": "frappe-ops-deployment", "path": "./skills/source/ops/frappe-ops-deployment" },
+      { "name": "frappe-ops-frontend-build", "path": "./skills/source/ops/frappe-ops-frontend-build" },
+      { "name": "frappe-ops-performance", "path": "./skills/source/ops/frappe-ops-performance" },
+      { "name": "frappe-ops-upgrades", "path": "./skills/source/ops/frappe-ops-upgrades" },
+      { "name": "frappe-syntax-clientscripts", "path": "./skills/source/syntax/frappe-syntax-clientscripts" },
+      { "name": "frappe-syntax-controllers", "path": "./skills/source/syntax/frappe-syntax-controllers" },
+      { "name": "frappe-syntax-customapp", "path": "./skills/source/syntax/frappe-syntax-customapp" },
+      { "name": "frappe-syntax-doctypes", "path": "./skills/source/syntax/frappe-syntax-doctypes" },
+      { "name": "frappe-syntax-hooks", "path": "./skills/source/syntax/frappe-syntax-hooks" },
+      { "name": "frappe-syntax-hooks-events", "path": "./skills/source/syntax/frappe-syntax-hooks-events" },
+      { "name": "frappe-syntax-jinja", "path": "./skills/source/syntax/frappe-syntax-jinja" },
+      { "name": "frappe-syntax-print", "path": "./skills/source/syntax/frappe-syntax-print" },
+      { "name": "frappe-syntax-query-builder", "path": "./skills/source/syntax/frappe-syntax-query-builder" },
+      { "name": "frappe-syntax-reports", "path": "./skills/source/syntax/frappe-syntax-reports" },
+      { "name": "frappe-syntax-scheduler", "path": "./skills/source/syntax/frappe-syntax-scheduler" },
+      { "name": "frappe-syntax-serverscripts", "path": "./skills/source/syntax/frappe-syntax-serverscripts" },
+      { "name": "frappe-syntax-whitelisted", "path": "./skills/source/syntax/frappe-syntax-whitelisted" },
+      { "name": "frappe-testing-cicd", "path": "./skills/source/testing/frappe-testing-cicd" },
+      { "name": "frappe-testing-unit", "path": "./skills/source/testing/frappe-testing-unit" }
+    ]
+  }
+}

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

@@ -84,15 +84,15 @@ Map each business requirement to Frappe mechanisms:
 
 ## Step 2: App Boundary Decision Framework
 
-### Single App — Use When
+### Single App: Use When
 
 - Total DocTypes < 15
 - Single team maintains the code
 - All DocTypes share the same business domain
 - No plans to distribute/sell components separately
 - All DocTypes have tight data dependencies
 
-### Multiple Apps — Use When
+### Multiple Apps: Use When
 
 - Total DocTypes > 15
 - Multiple teams with separate release cycles

skills/source/core/frappe-core-api/SKILL.md

@@ -101,7 +101,7 @@ Session cookies expire after ~3 days. NEVER use for long-running integrations.
 
 ---
 
-## REST API — Resource CRUD
+## REST API: Resource CRUD
 
 ### Endpoints
 
@@ -202,7 +202,7 @@ requests.post(f'{base_url}/api/method/upload_file',
 
 ---
 
-## RPC API — Custom Methods
+## RPC API: Custom Methods
 
 ### Server-Side Endpoint
 

skills/source/core/frappe-core-cache/SKILL.md

@@ -188,7 +188,7 @@ def get_exchange_rate(from_currency, to_currency):
 
 ---
 
-## frappe.local.cache — Request-Scoped Cache
+## frappe.local.cache: Request-Scoped Cache
 
 `frappe.local.cache` is a plain Python dict that lives for the duration of a single HTTP request. It is NOT stored in Redis.
 

skills/source/core/frappe-core-database/SKILL.md

@@ -78,7 +78,7 @@ What do you need?
 
 ---
 
-## ORM — Document Operations
+## ORM: Document Operations
 
 ### Get Document
 ```python
@@ -145,7 +145,7 @@ doc.insert(
 
 ---
 
-## Database API — Reading
+## Database API: Reading
 
 ### get_value
 ```python
@@ -229,7 +229,7 @@ or_filters = {'priority': 'Urgent', 'status': 'Overdue'}
 
 ---
 
-## Database API — Writing
+## Database API: Writing
 
 ### set_value
 ```python
@@ -262,7 +262,7 @@ frappe.db.bulk_update('Task', {
 
 ---
 
-## Raw SQL — ALWAYS Parameterized
+## Raw SQL: ALWAYS Parameterized
 
 ```python
 # ✅ CORRECT — parameterized query
@@ -484,7 +484,7 @@ sql = qb_obj.get_sql()
 
 ---
 
-## Query Builder — Dedicated Skill
+## Query Builder: Dedicated Skill
 
 For complex queries (joins, aggregations, subqueries, cross-DB compatibility), see **[frappe-syntax-query-builder](../../syntax/frappe-syntax-query-builder/SKILL.md)**.
 - **frappe.db methods** (this skill) — Simple CRUD, get_value, get_list, exists checks

skills/source/core/frappe-core-files/SKILL.md

@@ -57,7 +57,7 @@ What file operation do you need?
 
 ---
 
-## File DocType — Core Fields
+## File DocType: Core Fields
 
 | Field | Type | Description |
 |-------|------|-------------|

skills/source/core/frappe-core-logging/SKILL.md

@@ -59,7 +59,7 @@ Need to log something?
 
 ---
 
-## Quick Reference — frappe.logger()
+## Quick Reference: frappe.logger()
 
 ```python
 # Get a logger for your module (ALWAYS specify module name)
@@ -100,7 +100,7 @@ frappe.utils.logger.set_log_level("DEBUG")
 
 ---
 
-## Quick Reference — frappe.log_error()
+## Quick Reference: frappe.log_error()
 
 ```python
 # ALWAYS use keyword arguments (title/message can swap otherwise)

skills/source/core/frappe-core-notifications/SKILL.md

@@ -134,7 +134,7 @@ Set **Attach Print** to include a PDF of the document. Select a **Print Format**
 
 ---
 
-## frappe.sendmail() — Programmatic Email
+## frappe.sendmail(): Programmatic Email
 
 ```python
 frappe.sendmail(
@@ -172,7 +172,7 @@ pending = frappe.get_all("Email Queue", filters={"status": "Not Sent"}, limit=10
 
 ---
 
-## frappe.publish_realtime() — System Notifications
+## frappe.publish_realtime(): System Notifications
 
 ```python
 frappe.publish_realtime(