Stop Guessing What Your AI Agent Will Build: Skills Gives You a Process

You've probably had this experience: you give a coding agent a detailed prompt, it churns for a while, and then presents something that is technically functional but completely misses the point of what you wanted. The agent didn't understand your domain, it used twenty words where one would do, and now you're stuck trying to fix the misalignment after the fact. Matt Pocock's Skills repository is a collection of agent commands designed to fix exactly these failure modes.

Skills is a set of composable, model-agnostic tools that you install directly into coding agents like Claude Code or Codex. They are small, adaptable scripts that enforce a real engineering workflow rather than the "vibe coding" approach that produces shallow results. The project comes from the experience of building real applications, not just prototypes.

What It Does

Skills gives you a set of slash commands that run inside your coding agent. You install them with a single npx command, pick which skills you want, and then run a setup command that configures your agent to understand your project's specific context.

The core commands focus on alignment. The most popular skill is /grill-me, which forces the agent to ask you detailed questions about what you're building before it writes any code. There's also /grill-with-docs, which does the same thing but adds documentation generation. The idea is that you use these skills every time you want to make a change, not just when you remember to.

The setup process also asks about your issue tracker (GitHub, Linear, or local files), what labels you use for triage, and where you want documentation saved. This context gets baked into the agent's behavior so it speaks your project's language from the start.

Skills is built to work with any model and any agent. The installer runs through npm with npx skills@latest add mattpocock/skills, and the setup command /setup-matt-pocock-skills handles the configuration.

Why It's Cool

The value here is in the philosophy behind the tools. Pocock explicitly calls out two common failure modes with AI coding agents, and Skills is designed to counter both of them directly.

• It solves the alignment problem before it happens. The biggest complaint I hear from developers using AI agents is that the output doesn't match intent. Skills forces a "grilling session" upfront, where the agent asks you detailed questions about what you're building. This is borrowed from Pragmatic Programming wisdom: no one knows exactly what they want until they start talking it through. By making this a required step, you avoid the expensive cycle of build, review, reject, rebuild.

• It creates a shared language for your project. Agents that don't unde