From f34d927194a521688da962fff50708f6238d06af Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Tue, 28 Jul 2026 09:18:32 +0000 Subject: [PATCH] chore: version skills --- .changeset/ask-matt-wayfinder-guidance.md | 10 ---- .changeset/codex-skill-metadata.md | 10 ---- .../friendlier-setup-and-local-tickets.md | 12 ----- .changeset/grilling-general-use.md | 5 -- .changeset/prototype-primary-source.md | 5 -- .changeset/ship-as-claude-plugin.md | 12 ----- .changeset/wayfinder-decision-tickets.md | 7 --- .changeset/wayfinder-research-subagents.md | 7 --- .../yagni-scope-improve-architecture.md | 5 -- CHANGELOG.md | 52 +++++++++++++++++++ package.json | 2 +- 11 files changed, 53 insertions(+), 74 deletions(-) delete mode 100644 .changeset/ask-matt-wayfinder-guidance.md delete mode 100644 .changeset/codex-skill-metadata.md delete mode 100644 .changeset/friendlier-setup-and-local-tickets.md delete mode 100644 .changeset/grilling-general-use.md delete mode 100644 .changeset/prototype-primary-source.md delete mode 100644 .changeset/ship-as-claude-plugin.md delete mode 100644 .changeset/wayfinder-decision-tickets.md delete mode 100644 .changeset/wayfinder-research-subagents.md delete mode 100644 .changeset/yagni-scope-improve-architecture.md diff --git a/.changeset/ask-matt-wayfinder-guidance.md b/.changeset/ask-matt-wayfinder-guidance.md deleted file mode 100644 index 2a6b124..0000000 --- a/.changeset/ask-matt-wayfinder-guidance.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -"mattpocock-skills": patch ---- - -Make `/ask-matt` clued-up about `/wayfinder` — the heaviest, most cognitively demanding flow. - -The router now sharpens the two routing mistakes people most often make with wayfinder: - -- **Over-reaching for it.** It's slower and denser than a single grill, so it's flagged as the heaviest flow and reserved for the idea that genuinely won't fit one session — a well-scoped feature belongs on `/grill-with-docs`, not here. -- **Losing the way at the handoff.** When the map clears, wayfinder hands off, it doesn't build: merge onto the main flow at `/to-spec` (which collapses the map's linked decisions into a buildable plan) rather than looping the map straight into `/implement`. Straight-to-`/implement` is only for efforts that turned out genuinely small. diff --git a/.changeset/codex-skill-metadata.md b/.changeset/codex-skill-metadata.md deleted file mode 100644 index 3d90ece..0000000 --- a/.changeset/codex-skill-metadata.md +++ /dev/null @@ -1,10 +0,0 @@ ---- -"mattpocock-skills": minor ---- - -Add Codex metadata alongside each skill's Claude Code frontmatter so the set works in both harnesses without generated copies. - -- Add an `agents/openai.yaml` beside every `SKILL.md` with Codex UI metadata (`interface.display_name`, `interface.short_description`). -- Mark every user-invoked skill with `policy.allow_implicit_invocation: false`, the Codex analog of `disable-model-invocation: true`, so Codex excludes it from implicit invocation while explicit `$skill` invocation still works. -- Document the dual-harness invocation model in `.agents/invocation.md`, `CLAUDE.md`, and the promoted-bucket READMEs. -- Add `AGENTS.md` as a symlink to `CLAUDE.md` so Codex reads the same repo instructions. diff --git a/.changeset/friendlier-setup-and-local-tickets.md b/.changeset/friendlier-setup-and-local-tickets.md deleted file mode 100644 index c74af24..0000000 --- a/.changeset/friendlier-setup-and-local-tickets.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -"mattpocock-skills": patch ---- - -Make `/setup-matt-pocock-skills` friendlier and align the local-markdown tracker with the current spec. - -- **Triage labels** are now asked about only when the `triage` skill is installed, and then as a single recommended-yes question ("keep the default triage labels?") instead of an override interrogation. When `triage` isn't installed, the section — and `docs/agents/triage-labels.md` — are skipped. -- **External PRs as a request surface** is no longer a setup question. The GitHub/GitLab templates still carry the flag, defaulted off; a user can flip it in `docs/agents/issue-tracker.md` later. -- **Domain docs** default to single-context without asking; multi-context is only offered when the repo shows monorepo signals. -- **Local-markdown tickets** are now one file per ticket under `.scratch//issues/-.md` — never a single combined `tickets.md`. `/to-tickets` and the local issue-tracker template now agree, and the spec file is `spec.md` (not `PRD.md`) to match `/to-spec`. - -Docs pages for `setup-matt-pocock-skills` and `to-tickets` re-synced. diff --git a/.changeset/grilling-general-use.md b/.changeset/grilling-general-use.md deleted file mode 100644 index 0d9fe1c..0000000 --- a/.changeset/grilling-general-use.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"mattpocock-skills": patch ---- - -Reword **`grilling`** for general use. Its description and body no longer scope the interview to a software plan: "this plan" → "this", "enact the plan" → "act on it", and "exploring the codebase" → "exploring the environment". The technique is unchanged; it now reads as a stress-test of any plan, decision, or idea. diff --git a/.changeset/prototype-primary-source.md b/.changeset/prototype-primary-source.md deleted file mode 100644 index 4e97b19..0000000 --- a/.changeset/prototype-primary-source.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"mattpocock-skills": minor ---- - -Reword how the **`prototype`** skill handles its artifacts around a single idea: **the prototype is a primary source**. Rather than being deleted once it's answered its question, the prototype is captured as runnable evidence on a throwaway branch (`prototype/`) out of main, with a context pointer to it left on the implementation issue — so the main branch keeps only the validated decision while the exploration stays findable. The answer (verdict + question) is still captured durably in an issue/ADR/commit. diff --git a/.changeset/ship-as-claude-plugin.md b/.changeset/ship-as-claude-plugin.md deleted file mode 100644 index b58c0d1..0000000 --- a/.changeset/ship-as-claude-plugin.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -"mattpocock-skills": minor ---- - -Ship the skill set as a native **Claude Code plugin**. The repo is now its own single-plugin marketplace, so you can subscribe to the promoted skills as a managed, read-only bundle instead of copying editable files: - -``` -/plugin marketplace add mattpocock/skills -/plugin install mattpocock-skills@mattpocock -``` - -`.claude-plugin/plugin.json` gains full marketplace metadata (version, description, author, license, keywords) and a sibling `.claude-plugin/marketplace.json` lists the plugin. `skills.sh` remains the universal installer (and the path for Codex and other harnesses today); a native Codex plugin is deferred — see `.agents/adr/0002-ship-as-a-claude-code-plugin.md` for why. diff --git a/.changeset/wayfinder-decision-tickets.md b/.changeset/wayfinder-decision-tickets.md deleted file mode 100644 index a311c45..0000000 --- a/.changeset/wayfinder-decision-tickets.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -"mattpocock-skills": patch ---- - -Name the `/wayfinder` unit a **decision ticket**. - -People kept reading a wayfinder ticket as an ordinary *implementation* ticket — a slice of a build to execute — when wayfinder uses them as **decision tickets**: questions whose resolution is a decision. The skill description and its opening line now introduce "decision ticket" (and say what makes it one), and the `ask-matt` / engineering README wayfinder blurbs and the docs page match — while "ticket" stays the everyday word once the term is established. `CONTEXT.md` records **Decision ticket** as a domain term so the "avoid: ticket" guidance no longer contradicts wayfinder's deliberate use of the word. diff --git a/.changeset/wayfinder-research-subagents.md b/.changeset/wayfinder-research-subagents.md deleted file mode 100644 index dd7b2cd..0000000 --- a/.changeset/wayfinder-research-subagents.md +++ /dev/null @@ -1,7 +0,0 @@ ---- -"mattpocock-skills": minor ---- - -Wayfinder now burns research tickets down with subagents instead of leaving them parked for a separately-launched session. - -Research stays a real ticket type — it's a genuine shared blocker that downstream decisions hang on, and that dependency is exactly what the frontier's blocking edges exist to render. What changes is how it's resolved: because research is AFK, charting doesn't stop and read it. After creating the tickets, the charting session fires a `/research` subagent for each research ticket to burn it down in parallel, capturing the findings on a throwaway `research/` branch with a context pointer. Research tickets are the one exception to *one ticket per session*. diff --git a/.changeset/yagni-scope-improve-architecture.md b/.changeset/yagni-scope-improve-architecture.md deleted file mode 100644 index bb1565a..0000000 --- a/.changeset/yagni-scope-improve-architecture.md +++ /dev/null @@ -1,5 +0,0 @@ ---- -"mattpocock-skills": minor ---- - -Add a YAGNI scoping filter to the **`improve-codebase-architecture`** skill's Explore step. Instead of scanning the whole repo evenly, it now scopes to where change is actually landing: if you name a direction it takes it, otherwise it reads the last ~20 commit messages to bias exploration toward actively-developed paths. A deepening opportunity in code nobody touches is a refactor you'll never cash in — the leverage only pays off where you keep editing — so the report stops tidying dormant corners of the repo. diff --git a/CHANGELOG.md b/CHANGELOG.md index f609fc1..10cd6fc 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,57 @@ # mattpocock-skills +## 1.2.0 + +### Minor Changes + +- [#551](https://github.com/mattpocock/skills/pull/551) [`697d4ce`](https://github.com/mattpocock/skills/commit/697d4ce9742da558fd1ba6697c8e9775e2e302dd) Thanks [@mattpocock](https://github.com/mattpocock)! - Add Codex metadata alongside each skill's Claude Code frontmatter so the set works in both harnesses without generated copies. + + - Add an `agents/openai.yaml` beside every `SKILL.md` with Codex UI metadata (`interface.display_name`, `interface.short_description`). + - Mark every user-invoked skill with `policy.allow_implicit_invocation: false`, the Codex analog of `disable-model-invocation: true`, so Codex excludes it from implicit invocation while explicit `$skill` invocation still works. + - Document the dual-harness invocation model in `.agents/invocation.md`, `CLAUDE.md`, and the promoted-bucket READMEs. + - Add `AGENTS.md` as a symlink to `CLAUDE.md` so Codex reads the same repo instructions. + +- [#488](https://github.com/mattpocock/skills/pull/488) [`cdec9f6`](https://github.com/mattpocock/skills/commit/cdec9f6eb24dbfe606e3ad9b3eb457ba09210b85) Thanks [@mattpocock](https://github.com/mattpocock)! - Reword how the **`prototype`** skill handles its artifacts around a single idea: **the prototype is a primary source**. Rather than being deleted once it's answered its question, the prototype is captured as runnable evidence on a throwaway branch (`prototype/`) out of main, with a context pointer to it left on the implementation issue — so the main branch keeps only the validated decision while the exploration stays findable. The answer (verdict + question) is still captured durably in an issue/ADR/commit. + +- [#536](https://github.com/mattpocock/skills/pull/536) [`42a5b70`](https://github.com/mattpocock/skills/commit/42a5b70fcacc7baff1977b13f3919fb2f63af14e) Thanks [@mattpocock](https://github.com/mattpocock)! - Ship the skill set as a native **Claude Code plugin**. The repo is now its own single-plugin marketplace, so you can subscribe to the promoted skills as a managed, read-only bundle instead of copying editable files: + + ``` + /plugin marketplace add mattpocock/skills + /plugin install mattpocock-skills@mattpocock + ``` + + `.claude-plugin/plugin.json` gains full marketplace metadata (version, description, author, license, keywords) and a sibling `.claude-plugin/marketplace.json` lists the plugin. `skills.sh` remains the universal installer (and the path for Codex and other harnesses today); a native Codex plugin is deferred — see `.agents/adr/0002-ship-as-a-claude-code-plugin.md` for why. + +- [#538](https://github.com/mattpocock/skills/pull/538) [`2602257`](https://github.com/mattpocock/skills/commit/260225724133c4a204489599f04642aa089259a0) Thanks [@mattpocock](https://github.com/mattpocock)! - Wayfinder now burns research tickets down with subagents instead of leaving them parked for a separately-launched session. + + Research stays a real ticket type — it's a genuine shared blocker that downstream decisions hang on, and that dependency is exactly what the frontier's blocking edges exist to render. What changes is how it's resolved: because research is AFK, charting doesn't stop and read it. After creating the tickets, the charting session fires a `/research` subagent for each research ticket to burn it down in parallel, capturing the findings on a throwaway `research/` branch with a context pointer. Research tickets are the one exception to _one ticket per session_. + +- [#533](https://github.com/mattpocock/skills/pull/533) [`45afd80`](https://github.com/mattpocock/skills/commit/45afd8074a8b7de5fe073845d080fa9dd6c429fa) Thanks [@mattpocock](https://github.com/mattpocock)! - Add a YAGNI scoping filter to the **`improve-codebase-architecture`** skill's Explore step. Instead of scanning the whole repo evenly, it now scopes to where change is actually landing: if you name a direction it takes it, otherwise it reads the last ~20 commit messages to bias exploration toward actively-developed paths. A deepening opportunity in code nobody touches is a refactor you'll never cash in — the leverage only pays off where you keep editing — so the report stops tidying dormant corners of the repo. + +### Patch Changes + +- [#535](https://github.com/mattpocock/skills/pull/535) [`e74fee8`](https://github.com/mattpocock/skills/commit/e74fee89feb6025a6a74f6282feb7d33b1b6e578) Thanks [@mattpocock](https://github.com/mattpocock)! - Make `/ask-matt` clued-up about `/wayfinder` — the heaviest, most cognitively demanding flow. + + The router now sharpens the two routing mistakes people most often make with wayfinder: + + - **Over-reaching for it.** It's slower and denser than a single grill, so it's flagged as the heaviest flow and reserved for the idea that genuinely won't fit one session — a well-scoped feature belongs on `/grill-with-docs`, not here. + - **Losing the way at the handoff.** When the map clears, wayfinder hands off, it doesn't build: merge onto the main flow at `/to-spec` (which collapses the map's linked decisions into a buildable plan) rather than looping the map straight into `/implement`. Straight-to-`/implement` is only for efforts that turned out genuinely small. + +- [#502](https://github.com/mattpocock/skills/pull/502) [`44eed54`](https://github.com/mattpocock/skills/commit/44eed545186ffd0263e8004867750b80cfddd215) Thanks [@mattpocock](https://github.com/mattpocock)! - Make `/setup-matt-pocock-skills` friendlier and align the local-markdown tracker with the current spec. + + - **Triage labels** are now asked about only when the `triage` skill is installed, and then as a single recommended-yes question ("keep the default triage labels?") instead of an override interrogation. When `triage` isn't installed, the section — and `docs/agents/triage-labels.md` — are skipped. + - **External PRs as a request surface** is no longer a setup question. The GitHub/GitLab templates still carry the flag, defaulted off; a user can flip it in `docs/agents/issue-tracker.md` later. + - **Domain docs** default to single-context without asking; multi-context is only offered when the repo shows monorepo signals. + - **Local-markdown tickets** are now one file per ticket under `.scratch//issues/-.md` — never a single combined `tickets.md`. `/to-tickets` and the local issue-tracker template now agree, and the spec file is `spec.md` (not `PRD.md`) to match `/to-spec`. + + Docs pages for `setup-matt-pocock-skills` and `to-tickets` re-synced. + +- [#532](https://github.com/mattpocock/skills/pull/532) [`170ad48`](https://github.com/mattpocock/skills/commit/170ad48655825783d0193e850e31a9aac957bb95) Thanks [@mattpocock](https://github.com/mattpocock)! - Reword **`grilling`** for general use. Its description and body no longer scope the interview to a software plan: "this plan" → "this", "enact the plan" → "act on it", and "exploring the codebase" → "exploring the environment". The technique is unchanged; it now reads as a stress-test of any plan, decision, or idea. + +- [#534](https://github.com/mattpocock/skills/pull/534) [`7d694b7`](https://github.com/mattpocock/skills/commit/7d694b7ae981ca221a8f759b15273fe7b5dc393e) Thanks [@mattpocock](https://github.com/mattpocock)! - Name the `/wayfinder` unit a **decision ticket**. + + People kept reading a wayfinder ticket as an ordinary _implementation_ ticket — a slice of a build to execute — when wayfinder uses them as **decision tickets**: questions whose resolution is a decision. The skill description and its opening line now introduce "decision ticket" (and say what makes it one), and the `ask-matt` / engineering README wayfinder blurbs and the docs page match — while "ticket" stays the everyday word once the term is established. `CONTEXT.md` records **Decision ticket** as a domain term so the "avoid: ticket" guidance no longer contradicts wayfinder's deliberate use of the word. + ## 1.1.0 ### Minor Changes diff --git a/package.json b/package.json index ac2c8d2..6e870b8 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "mattpocock-skills", - "version": "1.1.0", + "version": "1.2.0", "private": true, "description": "Matt Pocock's agent skills for real engineering", "repository": {