From 5c89081d4bbeb3d039a42093653f90bb698d780e Mon Sep 17 00:00:00 2001 From: Claude Sonnet 5 Date: Wed, 19 Aug 2026 13:01:26 +0000 Subject: [PATCH 1/2] fix: quote SKILL.md descriptions with unquoted colons The colon-space sequences left behind by #905's em-dash-to-colon sweep make these six front-matter blocks invalid YAML, so skills.sh skips them during discovery and they can't be installed via `npx skills`. Quoting the description scalar fixes parsing without changing the wording. Fixes #907 Co-Authored-By: Claude Sonnet 5 --- skills/engineering/code-review/SKILL.md | 2 +- skills/engineering/setup-matt-pocock-skills/SKILL.md | 2 +- skills/engineering/to-spec/SKILL.md | 2 +- skills/in-progress/writing-fragments/SKILL.md | 2 +- skills/in-progress/writing-shape/SKILL.md | 2 +- skills/productivity/wait-what/SKILL.md | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/skills/engineering/code-review/SKILL.md b/skills/engineering/code-review/SKILL.md index 86b2b15..e28d7ac 100644 --- a/skills/engineering/code-review/SKILL.md +++ b/skills/engineering/code-review/SKILL.md @@ -1,6 +1,6 @@ --- name: code-review -description: Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes: Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/spec asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to "review since X". +description: "Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes: Standards (does the code follow this repo's documented coding standards?) and Spec (does the code match what the originating issue/spec asked for?). Runs both reviews in parallel sub-agents and reports them side by side. Use when the user wants to review a branch, a PR, work-in-progress changes, or asks to \"review since X\"." --- Two-axis review of the diff between `HEAD` and a fixed point the user supplies: diff --git a/skills/engineering/setup-matt-pocock-skills/SKILL.md b/skills/engineering/setup-matt-pocock-skills/SKILL.md index 7ddcbf4..7f6f576 100644 --- a/skills/engineering/setup-matt-pocock-skills/SKILL.md +++ b/skills/engineering/setup-matt-pocock-skills/SKILL.md @@ -1,6 +1,6 @@ --- name: setup-matt-pocock-skills -description: Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills. +description: "Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills." disable-model-invocation: true --- diff --git a/skills/engineering/to-spec/SKILL.md b/skills/engineering/to-spec/SKILL.md index 6aa60c8..3f52599 100644 --- a/skills/engineering/to-spec/SKILL.md +++ b/skills/engineering/to-spec/SKILL.md @@ -1,6 +1,6 @@ --- name: to-spec -description: Turn the current conversation into a spec and publish it to the project issue tracker: no interview, just synthesis of what you've already discussed. +description: "Turn the current conversation into a spec and publish it to the project issue tracker: no interview, just synthesis of what you've already discussed." disable-model-invocation: true --- diff --git a/skills/in-progress/writing-fragments/SKILL.md b/skills/in-progress/writing-fragments/SKILL.md index d50a632..c7c889b 100644 --- a/skills/in-progress/writing-fragments/SKILL.md +++ b/skills/in-progress/writing-fragments/SKILL.md @@ -1,6 +1,6 @@ --- name: writing-fragments -description: Writing, explore: mine raw fragments, no structure yet. +description: "Writing, explore: mine raw fragments, no structure yet." disable-model-invocation: true --- diff --git a/skills/in-progress/writing-shape/SKILL.md b/skills/in-progress/writing-shape/SKILL.md index 36ba11d..02f2866 100644 --- a/skills/in-progress/writing-shape/SKILL.md +++ b/skills/in-progress/writing-shape/SKILL.md @@ -1,6 +1,6 @@ --- name: writing-shape -description: Writing, exploit: shape raw material into an article, paragraph by paragraph. +description: "Writing, exploit: shape raw material into an article, paragraph by paragraph." disable-model-invocation: true --- diff --git a/skills/productivity/wait-what/SKILL.md b/skills/productivity/wait-what/SKILL.md index 53f48e3..f8854f1 100644 --- a/skills/productivity/wait-what/SKILL.md +++ b/skills/productivity/wait-what/SKILL.md @@ -1,6 +1,6 @@ --- name: wait-what -description: Stop. That last message did not land: re-pitch it. +description: "Stop. That last message did not land: re-pitch it." disable-model-invocation: true --- From 4f289474bad013fe2be8f8769d733f59d9103d6b Mon Sep 17 00:00:00 2001 From: Claude Sonnet 5 Date: Wed, 19 Aug 2026 13:04:09 +0000 Subject: [PATCH 2/2] chore: add changeset for YAML front-matter fix Co-Authored-By: Claude Sonnet 5 --- .changeset/fix-yaml-frontmatter-colons.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 .changeset/fix-yaml-frontmatter-colons.md diff --git a/.changeset/fix-yaml-frontmatter-colons.md b/.changeset/fix-yaml-frontmatter-colons.md new file mode 100644 index 0000000..64f830b --- /dev/null +++ b/.changeset/fix-yaml-frontmatter-colons.md @@ -0,0 +1,5 @@ +--- +"mattpocock-skills": patch +--- + +Quote the `description` front matter in `to-spec`, `code-review`, `setup-matt-pocock-skills`, `writing-fragments`, `writing-shape`, and `wait-what`. An unquoted colon-space left over from the em-dash sweep in #905 made each block invalid YAML, so `skills.sh` skipped all six during discovery and they couldn't be listed or installed via `npx skills`.