From 67bce91c80cd1020a4f068ced32d0281656842ad Mon Sep 17 00:00:00 2001 From: Matt Pocock Date: Mon, 18 May 2026 13:21:28 +0100 Subject: [PATCH 1/5] Fix typo in README.md regarding ticket labels --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index f66fcac..2f4a38d 100644 --- a/README.md +++ b/README.md @@ -34,7 +34,7 @@ npx skills@latest add mattpocock/skills 3. Run `/setup-matt-pocock-skills` in your agent. It will: - Ask you which issue tracker you want to use (GitHub, Linear, or local files) - - Ask you what labels you apply to ticks when you triage them (`/triage` uses labels) + - Ask you what labels you apply to tickets when you triage them (`/triage` uses labels) - Ask you where you want to save any docs we create 4. Bam - you're ready to go. From feaaf4204d32c1ae098612194fd1f9da83676522 Mon Sep 17 00:00:00 2001 From: Matt Pocock Date: Tue, 19 May 2026 14:29:31 +0100 Subject: [PATCH 2/5] Added redaction info to handoff skill --- skills/productivity/handoff/SKILL.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/skills/productivity/handoff/SKILL.md b/skills/productivity/handoff/SKILL.md index 28bfb3a..ae29141 100644 --- a/skills/productivity/handoff/SKILL.md +++ b/skills/productivity/handoff/SKILL.md @@ -10,4 +10,6 @@ Suggest the skills to be used, if any, by the next session. Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead. +Redact any sensitive information, such as API keys, passwords, or personally identifiable information. + If the user passed arguments, treat them as a description of what the next session will focus on and tailor the doc accordingly. From bc32841b2e9782956c71430d0dfa8162d41c3e9e Mon Sep 17 00:00:00 2001 From: Matt Pocock Date: Tue, 19 May 2026 14:34:59 +0100 Subject: [PATCH 3/5] Update handoff skill documentation to clarify saving location for handoff documents --- skills/productivity/handoff/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/productivity/handoff/SKILL.md b/skills/productivity/handoff/SKILL.md index ae29141..6dfb7a2 100644 --- a/skills/productivity/handoff/SKILL.md +++ b/skills/productivity/handoff/SKILL.md @@ -4,7 +4,7 @@ description: Compact the current conversation into a handoff document for anothe argument-hint: "What will the next session be used for?" --- -Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save it to a path produced by `mktemp -t handoff-XXXXXX.md` (read the file before you write to it). +Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save to the temporary directory of the user's OS - not the current workspace. Suggest the skills to be used, if any, by the next session. From e7df78bb81da39c537be810e622d2b90bbdc7dc5 Mon Sep 17 00:00:00 2001 From: Matt Pocock Date: Tue, 19 May 2026 14:40:27 +0100 Subject: [PATCH 4/5] Removed relationships, example dialogue, and flagged ambiguities from CONTEXT.md template --- .../grill-with-docs/CONTEXT-FORMAT.md | 18 ++---------------- 1 file changed, 2 insertions(+), 16 deletions(-) diff --git a/skills/engineering/grill-with-docs/CONTEXT-FORMAT.md b/skills/engineering/grill-with-docs/CONTEXT-FORMAT.md index ddfa247..0830255 100644 --- a/skills/engineering/grill-with-docs/CONTEXT-FORMAT.md +++ b/skills/engineering/grill-with-docs/CONTEXT-FORMAT.md @@ -10,7 +10,7 @@ ## Language **Order**: -{A concise description of the term} +{A one or two sentence description of the term} _Avoid_: Purchase, transaction **Invoice**: @@ -20,27 +20,13 @@ _Avoid_: Bill, payment request **Customer**: A person or organization that places orders. _Avoid_: Client, buyer, account - -## Relationships - -- An **Order** produces one or more **Invoices** -- An **Invoice** belongs to exactly one **Customer** - -## Example dialogue - -> **Dev:** "When a **Customer** places an **Order**, do we create the **Invoice** immediately?" -> **Domain expert:** "No — an **Invoice** is only generated once a **Fulfillment** is confirmed." - -## Flagged ambiguities - -- "account" was used to mean both **Customer** and **User** — resolved: these are distinct concepts. ``` ## Rules - **Be opinionated.** When multiple words exist for the same concept, pick the best one and list the others as aliases to avoid. - **Flag conflicts explicitly.** If a term is used ambiguously, call it out in "Flagged ambiguities" with a clear resolution. -- **Keep definitions tight.** One sentence max. Define what it IS, not what it does. +- **Keep definitions tight.** One or two sentences max. Define what it IS, not what it does. - **Show relationships.** Use bold term names and express cardinality where obvious. - **Only include terms specific to this project's context.** General programming concepts (timeouts, error types, utility patterns) don't belong even if the project uses them extensively. Before adding a term, ask: is this a concept unique to this context, or a general programming concept? Only the former belongs. - **Group terms under subheadings** when natural clusters emerge. If all terms belong to a single cohesive area, a flat list is fine. From d54c497aa94400a496d3f2c38be10fa5f284c5a9 Mon Sep 17 00:00:00 2001 From: Matt Pocock Date: Tue, 19 May 2026 17:07:02 +0100 Subject: [PATCH 5/5] Improved wording of /handoff --- skills/productivity/handoff/SKILL.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/skills/productivity/handoff/SKILL.md b/skills/productivity/handoff/SKILL.md index 6dfb7a2..0aa5b99 100644 --- a/skills/productivity/handoff/SKILL.md +++ b/skills/productivity/handoff/SKILL.md @@ -6,7 +6,7 @@ argument-hint: "What will the next session be used for?" Write a handoff document summarising the current conversation so a fresh agent can continue the work. Save to the temporary directory of the user's OS - not the current workspace. -Suggest the skills to be used, if any, by the next session. +Include a "suggested skills" section in the document, which suggests skills that the agent should invoke. Do not duplicate content already captured in other artifacts (PRDs, plans, ADRs, issues, commits, diffs). Reference them by path or URL instead.