feat: expand skill keywords with user-friendly discovery terms

Add symptom-based, beginner-friendly, and plain-language keywords to all
SKILL.md frontmatter descriptions. This improves skill matching when users
describe problems in non-technical terms (e.g. "slow page", "nothing shows",
"how do I", "white screen").

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

Author: FreekHeijting

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

@@ -4,7 +4,7 @@ description: >
   Use when designing multi-app Frappe architectures, deciding whether to split functionality into separate apps, or implementing cross-app communication patterns.
   Prevents monolithic app sprawl, circular dependencies between apps, and broken override chains.
   Covers multi-app architecture decisions, app dependency management, cross-app hooks, override patterns, when to split vs extend, shared DocType strategies.
-  Keywords: architecture, multi-app, app splitting, cross-app, dependencies, override, extend, monolith, modular.
+  Keywords: architecture, multi-app, app splitting, cross-app, dependencies, override, extend, monolith, modular, how to structure frappe apps, when to split apps, app design, multi-app planning..
 license: MIT
 compatibility: "Claude Code, Claude.ai Projects, Claude API. Frappe v14-v16."
 metadata:

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

@@ -4,7 +4,7 @@ description: >
   Use when debugging Frappe errors, using bench console for live inspection, analyzing tracebacks, or reading Frappe log files.
   Prevents wasted debugging time from ignoring log context, misreading tracebacks, and not using bench console effectively.
   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.
-  Keywords: debug, bench console, traceback, error log, frappe.logger, pdb, debugging, log analysis, inspect, VS Code, DAP, profiling, recorder, mariadb, monitor.
+  Keywords: debug, bench console, traceback, error log, frappe.logger, pdb, debugging, log analysis, inspect, VS Code, DAP, profiling, recorder, mariadb, monitor, ERPNext error, how to debug, find the bug, what went wrong, stack trace, error message..
 license: MIT
 compatibility: "Claude Code, Claude.ai Projects, Claude API. Frappe v14-v16."
 metadata:

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

@@ -6,7 +6,8 @@ description: >
   auto-calculate' or 'add approval workflow' into concrete technical
   specifications. Determines which Frappe mechanisms to use and maps to
   the full 60-skill catalog. Keywords: vague requirement, clarify scope,
-  translate business need, technical spec, implementation plan.
+  translate business need, technical spec, implementation plan,
+  what does this mean, unclear requirement, translate to code, how to build this.
 license: MIT
 compatibility: "Claude Code, Claude.ai Projects, Claude API. Frappe v14-v16."
 metadata:

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

@@ -4,7 +4,7 @@ description: >
   Use when migrating a Frappe app between major versions, detecting breaking API changes, or resolving post-migration errors.
   Prevents failed migrations from undetected deprecated APIs, removed methods, and changed function signatures.
   Covers breaking change detection v14-v15-v16, deprecated API mapping, migration checklist, common migration errors, automatic fix suggestions.
-  Keywords: migration, version upgrade, breaking changes, deprecated API, v14, v15, v16, migrate, compatibility.
+  Keywords: migration, version upgrade, breaking changes, deprecated API, v14, v15, v16, migrate, compatibility, upgrade ERPNext, version change breaks, after update errors, deprecated method..
 license: MIT
 compatibility: "Claude Code, Claude.ai Projects, Claude API. Frappe v14-v16."
 metadata:

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

@@ -6,7 +6,8 @@ description: >
   validates against all 60 frappe-* skills, catches v16 patterns
   (extend_doctype_class, type annotations), validates ops patterns (bench
   commands, deployment), and generates correction reports. Keywords: review
-  code, check script, validate deployment, find bugs, code quality.
+  code, check script, validate deployment, find bugs, code quality,
+  check my code, is this correct, code review, before deploying, best practices check.
 license: MIT
 compatibility: "Claude Code, Claude.ai Projects, Claude API. Frappe v14-v16."
 metadata:

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

@@ -4,7 +4,7 @@ description: >
   Use when building ERPNext/Frappe API integrations (v14/v15/v16) including
   REST API, RPC API, authentication, webhooks, and rate limiting. Covers
   external API calls, endpoint design, token/OAuth2/session authentication.
-  Keywords: API integration, REST endpoint, webhook, token authentication,
+  Keywords: API integration, REST endpoint, webhook, token authentication,, how to connect, external API, send data to another system, API not working, 401 error.
   OAuth, frappe.call, external connection, rate limiting.
 license: MIT
 compatibility: "Claude Code, Claude.ai Projects, Claude API. Frappe v14-v16."

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

@@ -4,7 +4,7 @@ description: >
   Use when implementing Redis caching, cache invalidation, or distributed locking in Frappe.
   Prevents stale cache bugs, race conditions from missing locks, and memory bloat from unbounded cache keys.
   Covers frappe.cache(), @redis_cache decorator, cache.get_value/set_value, cache invalidation patterns, frappe.lock, TTL strategies.
-  Keywords: cache, Redis, redis_cache, invalidation, locking, frappe.cache, get_value, set_value, TTL, distributed lock.
+  Keywords: cache, Redis, redis_cache, invalidation, locking, frappe.cache, get_value, set_value, TTL, distributed lock, data not refreshing, stale data, cache not clearing, Redis error, slow repeated queries..
 license: MIT
 compatibility: "Claude Code, Claude.ai Projects, Claude API. Frappe v14-v16."
 metadata:

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

@@ -5,7 +5,8 @@ description: >
   frappe.db methods, ORM patterns (frappe.get_doc, frappe.get_list), raw SQL,
   caching patterns, and performance optimization. Prevents common mistakes
   with database transactions and query building. Keywords: frappe.db,
-  frappe.get_doc, database query, SQL, ORM, caching, database performance.
+  frappe.get_doc, database query, SQL, ORM, caching, database performance,
+  query returns nothing, slow database, how to fetch data, get document by name, frappe.get_list empty.
 license: MIT
 compatibility: "Claude Code, Claude.ai Projects, Claude API. Frappe v14-v16."
 metadata:

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

@@ -4,7 +4,7 @@ description: >
   Use when handling file uploads, attachments, private/public file access, or S3 storage configuration.
   Prevents broken file URLs, permission leaks on private files, and failed uploads from incorrect MIME handling.
   Covers File DocType, frappe.get_file, upload API, private vs public directories, S3 integration, file URL patterns, attach field types.
-  Keywords: file, upload, attachment, File DocType, private, public, S3, file_url, get_file, attach.
+  Keywords: file, upload, attachment, File DocType, private, public, S3, file_url, get_file, attach, upload not working, file missing, broken file link, download file, image not showing, attachment error..
 license: MIT
 compatibility: "Claude Code, Claude.ai Projects, Claude API. Frappe v14-v16."
 metadata:

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

@@ -6,7 +6,7 @@ description: >
   frappe.log_error() for Error Log DocType entries, request logging,
   Sentry integration, and production logging patterns. Prevents common
   mistakes with print(), swapped log_error arguments, and sensitive data.
-  Keywords: frappe.logger, log_error, Error Log, logging, Sentry,
+  Keywords: frappe.logger, log_error, Error Log, logging, Sentry,, where are the logs, how to log errors, error tracking, print not showing, production logs.
   monitor, request logging, error tracking, debug, production.
 license: MIT
 compatibility: "Claude Code, Claude.ai Projects, Claude API. Frappe v14-v16."