The mattpocock/skills repository is a collection of agent skills designed to improve how AI coding assistants like Claude work on real engineering projects. Written primarily in Shell, the repository contains practical workflows and prompts that address common failure modes when using AI for software development. The repository describes itself as containing skills "straight from my .claude directory," representing techniques that creator Matt Pocock uses daily in actual engineering work rather than theoretical approaches.
The most frequently applied issue labels are enhancement, ready-for-human, and wontfix, suggesting an organized approach to issue management and feature development.
The core philosophy behind these skills addresses four major problems in AI-assisted development. The first is misalignment between what developers want and what agents produce. The repository includes skills like /grill-me and /grill-with-docs that prompt agents to ask detailed clarifying questions before beginning work, establishing shared understanding before implementation starts. The second problem is agent verbosity, which the repository solves through building a shared domain language documented in a CONTEXT.md file. This approach reduces the jargon gap between agents and projects, making codebases easier to navigate and reducing token consumption. The third problem is code that doesn't work, addressed through skills like /tdd that implement red-green-refactor loops and /diagnosing-bugs for structured debugging practices. The fourth problem is architectural degradation, where codebases become complex and difficult to change, tackled through /improve-codebase-architecture and /to-prd skills that encourage design thinking throughout development.
The repository organizes skills into two categories: user-invoked skills that developers explicitly call to orchestrate workflows, and model-invoked skills that agents can reach for automatically when tasks fit their purpose. Engineering skills include /ask-matt as a router over other skills, /grill-with-docs for requirements gathering with domain modeling, /triage for issue state management, /to-issues for breaking specifications into vertical slices, and /setup-matt-pocock-skills for initial configuration. The quickstart process involves running a skills.sh installer, selecting desired skills, and configuring issue tracker preferences and triage labels.
The repository is classified across multiple domains including Programming, Web Development, TypeScript, React, JavaScript, Learning Resources, Code Examples, Software Engineering, and Technical Education. The skills are designed to be small, composable, and adaptable to different coding agents and workflows, emphasizing that they work with any model rather than being locked to specific platforms.
