fix(skills): give every skill description real 'Use when:' trigger phrasing

plugins/context7/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "context7",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Looks up current library documentation, API references, and code examples via Context7 (ctx7 CLI or the Context7 MCP server) with a two-step resolve-then-query workflow: a lookup skill (default lookup plus an upstream drift-check action) and a setup skill for CLI install, auth, and MCP configuration.",
   "author": {
     "name": "Melodic Software",

plugins/context7/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to the `context7` plugin are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); this plugin uses semantic versioning.
 
+## [0.5.1]
+
+### Changed
+
+- **`/context7:lookup`'s `description` now leads with typed trigger phrases.** It previously stated
+  the routing condition only as prose ("whenever a question names a library, framework, SDK, CLI
+  tool, or cloud service"), which reads as a summary rather than a trigger spec, and the phrases a
+  user actually types were absent. `Use when:` now fronts `'look up the docs for X'`,
+  `'what's the API for X'`, `'how do I configure X'`, `'latest docs for X'`,
+  `'check context7 for X'` and `'how do I migrate to X v2'`, with the names-a-library condition
+  folded in behind them instead of stated twice.
+
 ## [0.5.0]
 
 ### Removed

plugins/context7/skills/lookup/SKILL.md

@@ -1,5 +1,5 @@
 ---
-description: "Look up current library documentation, API references, and code examples via Context7 (ctx7 CLI or the Context7 MCP server — same backend) whenever a question names a library, framework, SDK, CLI tool, or cloud service, including API syntax, configuration, setup, and version-migration questions. Actions: lookup <library> <query> (default) | update (CLI upgrade + upstream drift check). For CLI/MCP setup, auth, and Windows gotchas, run /context7:setup."
+description: "Look up current library documentation, API references, and code examples via Context7 (ctx7 CLI or the Context7 MCP server — same backend). Use when: 'look up the docs for X', 'what's the API for X', 'how do I configure X', 'latest docs for X', 'check context7 for X', 'how do I migrate to X v2', or whenever a question names a library, framework, SDK, CLI tool, or cloud service — including API syntax, configuration, setup, and version-migration questions. Actions: lookup <library> <query> (default) | update (CLI upgrade + upstream drift check). For CLI/MCP setup, auth, and Windows gotchas, run /context7:setup."
 argument-hint: "[lookup <library> <query> | update] (default: lookup — e.g., /context7:lookup react \"useEffect cleanup\")"
 user-invocable: true
 disable-model-invocation: false

plugins/debugging/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "debugging",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Debug observed failures via a disciplined six-phase loop: build a fast deterministic reproduction signal, reproduce, rank falsifiable hypotheses, instrument, fix with a regression test, then clean up and post-mortem.",
   "author": {
     "name": "Melodic Software",

plugins/debugging/CHANGELOG.md

@@ -3,6 +3,18 @@
 All notable changes to the `debugging` plugin are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); this plugin uses semantic versioning.
 
+## [0.6.1]
+
+### Changed
+
+- **`/debugging:debug`'s trigger phrases are now single-quoted.** They were written with escaped
+  double quotes inside the double-quoted YAML scalar, and the skill-quality gate's trigger-drop
+  protection tracks only `'single-quoted'` phrases — so all nine (`'diagnose this'`, `'debug this'`,
+  `'why is X broken'`, `'X is throwing'`, `'something is wrong with'`, `'investigate this bug'`,
+  `'performance regression'`, `'this is slow'`, `'intermittent failure'`) were invisible to it and a
+  future rewrite could have dropped any of them unnoticed. The wording is unchanged; only the
+  quoting is.
+
 ## [0.6.0]
 
 ### Removed

plugins/debugging/skills/debug/SKILL.md

@@ -1,5 +1,5 @@
 ---
-description: "Debug and diagnose broken behavior via a disciplined six-phase loop: build feedback loop → reproduce → hypothesise → instrument → fix + regression test → cleanup. Use when: \"diagnose this\", \"debug this\", \"why is X broken\", \"X is throwing\", \"something is wrong with\", \"investigate this bug\", \"performance regression\", \"this is slow\", \"intermittent failure\", broken behavior in UI / logs / production / screenshot, flaky test traced to root cause — any OBSERVED FAILURE without a pre-existing reproduction. Phase 1 builds the loop; no phase proceeds without a fast, deterministic signal. Skip when: the symptom is already a failing test with no reproduction gap — cycle it directly. Outputs: reproduction loop, root-cause hypothesis, regression test or documented seam gap, cleaned fix, post-mortem finding."
+description: "Debug and diagnose broken behavior via a disciplined six-phase loop: build feedback loop → reproduce → hypothesise → instrument → fix + regression test → cleanup. Use when: 'diagnose this', 'debug this', 'why is X broken', 'X is throwing', 'something is wrong with', 'investigate this bug', 'performance regression', 'this is slow', 'intermittent failure', broken behavior in UI / logs / production / screenshot, flaky test traced to root cause — any OBSERVED FAILURE without a pre-existing reproduction. Phase 1 builds the loop; no phase proceeds without a fast, deterministic signal. Skip when: the symptom is already a failing test with no reproduction gap — cycle it directly. Outputs: reproduction loop, root-cause hypothesis, regression test or documented seam gap, cleaned fix, post-mortem finding."
 argument-hint: "[bug description or observation] (e.g., /debugging:debug checkout times out for orders over $1k)"
 user-invocable: true
 disable-model-invocation: false

plugins/docs-hygiene/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "docs-hygiene",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Documentation-hygiene toolkit of six skills: compress (flavor-trim markdown with a semantic-diff safety net), audit-noise (classify markdown noise), extract-ssot (deduplicate repeated content into a single source of truth), audit-encapsulation (detect citations into skill-private surfaces), rename-references (sweep stale references after renames), and audit-derivability (classify whether a whole document earns its existence — could a fresh agent re-derive it from the code?).",
   "author": {
     "name": "Melodic Software",

plugins/docs-hygiene/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog — docs-hygiene plugin
 
+## [0.10.1]
+
+### Changed
+
+- **`/docs-hygiene:compress`'s trigger phrases are now single-quoted.** Same cause as the debugging
+  plugin's: escaped double quotes inside a double-quoted YAML scalar are not tracked by the
+  skill-quality gate's trigger-drop protection, so `'compress this doc'`, `'tighten markdown'`,
+  `'cut prose'`, `'shorten without losing meaning'` and `'trim onboarding doc'` carried no
+  regression cover. Quoting only; wording unchanged.
+
 ## [0.10.0]
 
 ### Changed

plugins/docs-hygiene/skills/compress/SKILL.md

@@ -1,5 +1,5 @@
 ---
-description: "Compress (tighten, shorten, trim) markdown files by dropping flavor — filler, hedging, articles — while preserving all content (directives, qualifiers, thresholds, examples), with a mandatory semantic-diff subagent that reverts any SEMANTIC LOSS or AMBIGUITY. Use when: \"compress this doc\", \"tighten markdown\", \"cut prose\", \"shorten without losing meaning\", \"trim onboarding doc\", or verbose prose in docs/, READMEs, rule bodies, skill bodies, or third-party pasted text — actions: default (snapshot → backend → semantic-diff subagent → revert-pass → markdownlint) and audit (read-only dry-run classifying SKIP/COMPRESS/UNCERTAIN per file); flags: --force (bypass <3% revert rule), --keep-snapshot; not for: session compaction (/compact), markdown noise classification (/audit-noise), code-comment trimming, or content relocation/SSOT consolidation (/extract-ssot)."
+description: "Compress (tighten, shorten, trim) markdown files by dropping flavor — filler, hedging, articles — while preserving all content (directives, qualifiers, thresholds, examples), with a mandatory semantic-diff subagent that reverts any SEMANTIC LOSS or AMBIGUITY. Use when: 'compress this doc', 'tighten markdown', 'cut prose', 'shorten without losing meaning', 'trim onboarding doc', or verbose prose in docs/, READMEs, rule bodies, skill bodies, or third-party pasted text — actions: default (snapshot → backend → semantic-diff subagent → revert-pass → markdownlint) and audit (read-only dry-run classifying SKIP/COMPRESS/UNCERTAIN per file); flags: --force (bypass <3% revert rule), --keep-snapshot; not for: session compaction (/compact), markdown noise classification (/audit-noise), code-comment trimming, or content relocation/SSOT consolidation (/extract-ssot)."
 argument-hint: "[audit] [target] [--force] [--keep-snapshot]"
 user-invocable: true
 disable-model-invocation: false

plugins/firecrawl/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "firecrawl",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Web scraping, search, crawling, and file parsing through the firecrawl-cli binary with a write-to-disk-then-Read pattern that keeps large results out of context — a user-facing wrapper skill, a lazy-install setup skill, and a separate gated maintainer update skill tracking the upstream CLI and skill source.",
   "author": {
     "name": "Melodic Software",

plugins/firecrawl/CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to the `firecrawl` plugin are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); this plugin uses semantic versioning.
 
+## [0.5.1]
+
+### Changed
+
+- **`/firecrawl:firecrawl`'s `Use when:` list now opens with typed phrases.** It previously listed
+  only *conditions* ("WebFetch returns 403/429", "a page requires JS rendering") — accurate, but
+  nothing a user types, and nothing the gate's trigger-drop protection could track.
+  `'scrape this page'`, `'crawl this site'`, `'search the web for X'`, `'WebFetch is blocked'`,
+  `'this page needs JS'` and `'extract the text from this PDF'` now front the list; every original
+  condition is retained behind them.
+
 ## [0.5.0]
 
 ### Changed

plugins/firecrawl/skills/firecrawl/SKILL.md

@@ -1,5 +1,5 @@
 ---
-description: "Scrape, search, crawl, map, parse, or interact with web pages via the firecrawl-cli binary, writing results to disk instead of streaming them into context — actions: scrape, search, crawl, map, parse, interact, agent, monitor. Use when: WebFetch returns 403/429 (Cloudflare, PerimeterX, anti-bot block), a page requires JS rendering or clicks/form fills, you need web search with scraped results, bulk URL discovery and crawling, a local file (PDF/DOCX/XLSX) needs text extraction to markdown, or a natural-language web research task — skip for plain unprotected pages (WebFetch suffices) or when you want synthesis rather than primary source."
+description: "Scrape, search, crawl, map, parse, or interact with web pages via the firecrawl-cli binary, writing results to disk instead of streaming them into context — actions: scrape, search, crawl, map, parse, interact, agent, monitor. Use when: 'scrape this page', 'crawl this site', 'search the web for X', 'WebFetch is blocked', 'this page needs JS', 'extract the text from this PDF', or WebFetch returns 403/429 (Cloudflare, PerimeterX, anti-bot block), a page requires JS rendering or clicks/form fills, you need web search with scraped results, bulk URL discovery and crawling, a local file (PDF/DOCX/XLSX) needs text extraction to markdown, or a natural-language web research task — skip for plain unprotected pages (WebFetch suffices) or when you want synthesis rather than primary source."
 argument-hint: "<command> [args] — commands: scrape, search, crawl, map, parse, interact, agent, monitor, search-feedback, credit-usage"
 user-invocable: true
 disable-model-invocation: false

plugins/implementation/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "implementation",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "description": "Disciplined implementation stage: execute approved plans inline (`/implementation:implement`) or via orchestrated worker subagents (`/implementation:implement-dispatch`) with incremental validation, TDD-by-default cadence, green-checkpoint commits, scope-fence drift detection, and divergence detection that routes back to planning. Build/test/lint, testing, and outcome verification live in the companion `toolchain`, `testing`, and `verification` plugins, invoked when installed.",
   "author": {
     "name": "Melodic Software",

plugins/implementation/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to the `implementation` plugin are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); this plugin uses semantic versioning.
 
+## [0.13.1]
+
+### Changed
+
+- **`/implementation:implement`'s `description` now uses `Use when:`.** Its routing phrases sat
+  behind a lowercase `use for`, which the skill-quality gate does not recognize as trigger phrasing.
+  `'build this'`, `'write the code'`, `'make this change'` and `'apply the plan'` join the four
+  already there, all of which are preserved verbatim.
+- **`/implementation:implement-dispatch` gained typed trigger phrases.** Its `Use when` clause
+  described a *state* ("the plan routes phases to worker surfaces") with no phrase a user would
+  type, so the gate saw no trackable trigger at all. `'dispatch this to workers'`,
+  `'run this with subagents'`, `'execute the plan in parallel'` and `'fan the plan out'` now precede
+  that condition, which is retained.
+
 ## [0.13.0]
 
 ### Removed

plugins/implementation/skills/implement-dispatch/SKILL.md

@@ -1,5 +1,5 @@
 ---
-description: "Orchestrate worker subagents to execute an approved plan — the main window composes scope-fenced briefs, dispatches workers, verifies their returns against direct evidence, and builds main-side instead of editing inline. Use when the plan routes phases to worker surfaces or the session runs autonomously; for interactive all-inline execution use /implementation:implement instead."
+description: "Orchestrate worker subagents to execute an approved plan — the main window composes scope-fenced briefs, dispatches workers, verifies their returns against direct evidence, and builds main-side instead of editing inline. Use when: 'dispatch this to workers', 'run this with subagents', 'execute the plan in parallel', 'fan the plan out', or the plan routes phases to worker surfaces or the session runs autonomously; for interactive all-inline execution use /implementation:implement instead."
 argument-hint: "[phase] [--wave-cap <N>] (e.g., /implementation:implement-dispatch, /implementation:implement-dispatch phase-2 --wave-cap 3)"
 user-invocable: true
 disable-model-invocation: false

plugins/implementation/skills/implement/SKILL.md

@@ -1,5 +1,5 @@
 ---
-description: "Execute approved plans, fix bugs, and make code changes inline with incremental validation — TDD by default, build+test after each logical block, commit at green checkpoints, and divergence detection that routes back to planning instead of pushing through a broken approach. Use for 'implement this', 'execute the plan', 'fix this bug', 'refactor', or whenever code is about to be written; modes: feature, fix, refactor, config."
+description: "Execute approved plans, fix bugs, and make code changes inline with incremental validation — TDD by default, build+test after each logical block, commit at green checkpoints, and divergence detection that routes back to planning instead of pushing through a broken approach. Use when: 'implement this', 'execute the plan', 'fix this bug', 'refactor', 'build this', 'write the code', 'make this change', 'apply the plan', or whenever code is about to be written; modes: feature, fix, refactor, config."
 argument-hint: "[task or mode] (e.g., /implementation:implement, /implementation:implement feature, /implementation:implement fix login-bug, /implementation:implement refactor)"
 user-invocable: true
 disable-model-invocation: false

plugins/kindle-dedrm/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
   "name": "kindle-dedrm",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Manage the Kindle for PC 2.8.0 + Calibre DeDRM workflow for personal-use ebook DRM removal on books you own (Windows only). Action router with setup, sync, update, cleanup, and status, each state mutation paired with a documented compensating reversal.",
   "author": {
     "name": "Melodic Software",

plugins/kindle-dedrm/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to the `kindle-dedrm` plugin are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); this plugin uses semantic versioning.
 
+## [0.7.1]
+
+### Changed
+
+- **`/kindle-dedrm:manage`'s trigger phrases are now single-quoted.** All eight
+  (`'set up Kindle DRM removal'`, `'remove DRM from Kindle books'`,
+  `'extract keys from my Kindle library'`, `'sync new Kindle books I bought'`,
+  `'check if DeDRM setup is current'`, `'clean up Kindle DRM tools'`, `'undo DeDRM setup'`,
+  `'convert Kindle books to EPUB'`) were written with escaped double quotes, which the skill-quality
+  gate's trigger-drop protection does not track — so none of them carried regression cover. Quoting
+  only; the wording is unchanged.
+
+  `'set up Kindle DRM removal'` is deliberately kept here even though the sibling
+  `/kindle-dedrm:setup` also lists it. That looks like a routing ambiguity, but `setup` is
+  `disable-model-invocation: true` — its description is never matched against user text — so
+  `manage` is the only skill that can receive the phrase by model invocation, and its action router
+  delegates to `/kindle-dedrm:setup` from there. Dropping the duplicate would make the phrase
+  reachable only by an explicit slash command.
+
 ## [0.7.0]
 
 ### Removed

plugins/kindle-dedrm/skills/manage/SKILL.md

@@ -1,5 +1,5 @@
 ---
-description: "Manage the Kindle for PC 2.8.0 + Calibre DeDRM workflow for personal-use ebook DRM removal on books you own (Windows only). Action router: setup (first-time provisioning — download, firewall block, ICACLS lock, Calibre plugins, keyfinder; delegated to the dedicated /kindle-dedrm:setup check/apply skill), sync (new purchases — disable firewall, sync Kindle, re-enable, re-run keyfinder), update (drift check — upstream version pins and tutorial URLs, no mutations), cleanup (reversible decommission — per-item confirmation, --soft or --full), status (diagnostic). Every state mutation has a documented compensating reversal. Use when: \"set up Kindle DRM removal\", \"remove DRM from Kindle books\", \"extract keys from my Kindle library\", \"sync new Kindle books I bought\", \"check if DeDRM setup is current\", \"clean up Kindle DRM tools\", \"undo DeDRM setup\", \"convert Kindle books to EPUB\", Calibre + Kindle mentioned together, or making Kindle library readable on a non-Kindle device."
+description: "Manage the Kindle for PC 2.8.0 + Calibre DeDRM workflow for personal-use ebook DRM removal on books you own (Windows only). Action router: setup (first-time provisioning — download, firewall block, ICACLS lock, Calibre plugins, keyfinder; delegated to the dedicated /kindle-dedrm:setup check/apply skill), sync (new purchases — disable firewall, sync Kindle, re-enable, re-run keyfinder), update (drift check — upstream version pins and tutorial URLs, no mutations), cleanup (reversible decommission — per-item confirmation, --soft or --full), status (diagnostic). Every state mutation has a documented compensating reversal. Use when: 'set up Kindle DRM removal', 'remove DRM from Kindle books', 'extract keys from my Kindle library', 'sync new Kindle books I bought', 'check if DeDRM setup is current', 'clean up Kindle DRM tools', 'undo DeDRM setup', 'convert Kindle books to EPUB', Calibre + Kindle mentioned together, or making Kindle library readable on a non-Kindle device."
 argument-hint: "[setup|sync|update|cleanup|status] [--dry-run] [--soft|--full]"
 user-invocable: true
 disable-model-invocation: false