Matt Pocock’s Coding Agent Skills v1.3 Update and 25-Session Audit Prompt

Image source: GitHub / mattpocock

Matt Pocock (@mattpocockuk), widely recognized for his TypeScript educational resources and AI developer tooling contributions, has shared a practical two-step prompt following the v1.3 release of his popular open-source repository mattpocock/skills. The prompt guides developers to migrate repository domain documentation from CONTEXT.md to GLOSSARY.md, diff local customizations against upstream changes, and audit skill invocation patterns across their last 25 coding agent sessions to optimize day-to-day workflows.

As modular agent skill frameworks gain widespread traction across environments like Claude Code and OpenAI Codex, structuring project guidelines and recurring engineering tasks into dedicated skills has become standard practice. However, when an upstream library ships a new version, synchronizing repository configurations, managing local custom modifications, and discovering which skills are actually driving efficiency can create manual friction. Matt Pocock's prompt addresses this challenge by instructing the coding agent to handle both the configuration migration and historical session telemetry analysis directly.

1. What’s New in mattpocock/skills v1.3 and the GLOSSARY.md Migration

The primary architectural shift in the mattpocock/skills v1.3 release (PR #1120, commit 006a52b) is the formal renaming of domain documentation conventions.

The filenames CONTEXT.md and CONTEXT-MAP.md, used prior to this release, have been officially renamed to GLOSSARY.md and GLOSSARY-MAP.md.

• Rationale Behind the Renaming: Matt Pocock clarified that the original CONTEXT.md terminology drew inspiration from Domain-Driven Design (DDD) "bounded context" principles. In v1.3, the convention was formally renamed to GLOSSARY.md (and GLOSSARY-MAP.md) across skills and documentation to directly reflect its role as the repository's domain glossary.
• Affected Engineering Skills: The updated convention is wired across the repository's core skills, including domain-modeling, grill-with-docs, improve-codebase-architecture, setup-matt-pocock-skills, triage, tdd, diagnosing-bugs, ask-matt, codebase-design, wait-what, pr, alongside documentation and the repository's root glossary.
• Migration Command: Repositories with existing domain documentation should run git mv CONTEXT.md GLOSSARY.md (and git mv CONTEXT-MAP.md GLOSSARY-MAP.md if applicable). Skills in v1.3 exclusively search for and populate GLOSSARY.md/GLOSSARY-MAP.md.

In tandem with the file rename, repositories utilizing the engineering skill set should check /setup-matt-pocock-skills to ensure their issue tracker integration, triage label definitions, and domain document paths under docs/agents/ remain properly aligned with the updated schema.

2. Matt Pocock’s Two-Step Workflow Optimization Prompt

Matt Pocock published the complete "Prompt of the day" on X (Twitter):

Prompt of the day:

1. Re-check mattpocock/skills for the v1.3 release. Rename CONTEXT.md to GLOSSARY.md. Check /setup-matt-pocock-skills for any required changes. Perform a diff of the skills in my repository vs Matt's.

2. Get a sense for how I use Matt's skills: scan my last 25 sessions for skill invocations. Then, recommend how this release might improve my workflow.

Enjoy v1.3, pals.

The prompt divides the maintenance workflow into two actionable phases:

1. Step 1: Upstream Sync, Migration, and Local Diffing

   • Directs the agent to review the mattpocock/skills v1.3 release details.
   • Renames CONTEXT.md to GLOSSARY.md within the local repository.
   • Executes /setup-matt-pocock-skills to inspect backlog tracking and domain doc configuration for necessary adjustments.
   • Performs a diff between the skill implementations stored in the user's repository and the upstream versions to surface divergences.

2. Step 2: 25-Session Telemetry Audit and Custom Recommendations

   • Scans the history of the user's last 25 coding agent sessions to log skill invocations.
   • Synthesizes those invocation frequencies and real-world usage patterns to recommend concrete ways the v1.3 changes can streamline the developer's specific workflows.

3. Practical Implementation: Preserving Local Patches with 3-Way Diffs

Applying this prompt in production workflows highlights several important operational nuances noted across developer discussions:

• Managed Bundle vs. Editable Copy: mattpocock/skills offers two distribution models: a managed Claude Code plugin bundle installed from the official marketplace that updates automatically, and editable copies installed via skills.sh or npx skills add. Developers running editable local copies must explicitly manage upgrades to avoid losing custom modifications.
• Preventing Overwrites via 3-Way Diffing: Over 25 real-world sessions, developers frequently tailor skill prompts to their repository's exact testing conventions, styling rules, or bug-fix history. A blind overwrite can wipe out these battle-tested refinements. Performing a 3-way diff—comparing the prior upstream baseline, the local modified version, and the new v1.3 upstream release—ensures intentional repo-specific patches are preserved while merging new features.
• Auditing Sessions Without Skill Invocations: Beyond tallying which skills were called most often, examining sessions where no skill was invoked can be equally valuable. If an agent repeatedly handled a complex task from scratch without leveraging an existing skill, the audit helps developers discover overlooked built-in tools or identify candidates for new project-specific skills.

Original source

• X (Twitter) @mattpocockuk Original Post: Prompt of the day - skills v1.3
• GitHub mattpocock/skills Repository: mattpocock/skills Releases & CHANGELOG