matt-pocock-skills

Transform underspecified engineering requests into TDD-aligned plans with verifiable outcomes.

130|14|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/dmae97/oh-my-kimi --skill matt-pocock-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: matt-pocock-skills
Source: https://github.com/dmae97/oh-my-kimi/tree/main/templates/skills/agents/matt-pocock-skills
Command: npx skills add https://github.com/dmae97/oh-my-kimi --skill matt-pocock-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents wasted engineering effort by forcing real-engineering alignment: clarify ambiguous goals, define proof, and drive the work through small verifiable slices.

Core Features & Use Cases

  • Shared-language alignment: captures domain terms, abbreviations, and project-specific meanings so the team converges on the same understanding.
  • Test-first and evidence-gated outcomes: converts unclear requests into verifiable outcomes such as failing tests, typechecks, lint gates, screenshots, or replayable checks.
  • Debugging and architecture cleanup guidance: reproduces first, isolates the failing boundary, patches the smallest cause, and maps module responsibilities and seams to avoid rewrite churn.

Quick Start

Use matt-pocock-skills when you need to turn an underspecified bugfix or feature request into a test-first plan with explicit assumptions, acceptance criteria, and the smallest implementation slice to verify progress.

Frequently Asked Questions about matt-pocock-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn an ambiguous feature request into a test-first plan?

A test-first plan converts ambiguous feature requests into verifiable outcomes by defining shared terms, outlining acceptance criteria, and breaking implementation into small slices with feedback loops.

What is evidence-based debugging and how does it reduce wasted work?

Evidence-based debugging reduces wasted work by reproducing the failure first, isolating the failing boundary, and patching the smallest root cause rather than rewriting entire modules.

How do I plan an architecture review without causing rewrite churn?

Architecture review without rewrite churn requires mapping module responsibilities and seams first, identifying proof requirements, and slicing changes into verifiable outcomes.

Can I use test-first planning for non-trivial implementation tasks?

Test-first planning suits non-trivial implementation tasks by enforcing engineering alignment, clarifying assumptions, and requiring verifiable outcomes like failing tests or typechecks.

What are the limitations of test-first planning for ambiguous product work?

Test-first planning for ambiguous product work requires strict guardrails against invented requirements and skipped verification, meaning it cannot proceed without clarified assumptions or explicit questions.

What's the best way to align a team on shared language before implementation?

Aligning a team on shared language involves capturing domain terms, abbreviations, and project-specific meanings early so the team converges on the same understanding before coding.