{"name":"skills: Essential AI Agent Skills for Real Engineering","description":"skills by Matt Pocock offers a collection of AI agent skills designed to enhance real-world engineering workflows. These skills address common pitfalls in AI-assisted development, promoting better alignment, conciseness, and code quality. Engineers can leverage these tools to build more robust and maintainable applications with their coding agents.","github":"https://github.com/mattpocock/skills","url":"https://osrepos.com/repo/mattpocock-skills","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/mattpocock-skills","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/mattpocock-skills.md","json":"https://osrepos.com/repo/mattpocock-skills.json","topics":["Shell","AI Agents","Software Engineering","Development Tools","Productivity","GitHub","Matt Pocock","Coding Skills"],"keywords":["Shell","AI Agents","Software Engineering","Development Tools","Productivity","GitHub","Matt Pocock","Coding Skills"],"stars":null,"summary":"skills by Matt Pocock offers a collection of AI agent skills designed to enhance real-world engineering workflows. These skills address common pitfalls in AI-assisted development, promoting better alignment, conciseness, and code quality. Engineers can leverage these tools to build more robust and maintainable applications with their coding agents.","content":"## Introduction\n`mattpocock/skills` is a comprehensive GitHub repository curated by Matt Pocock, offering a powerful collection of AI agent skills. Designed for \"Real Engineers,\" these skills aim to elevate the quality and efficiency of AI-assisted software development. They tackle common challenges faced when working with coding agents, ensuring better alignment, clearer communication, and more robust code. This repository is built upon decades of engineering experience, condensed into practical, composable tools.\n\n## Installation\nGetting started with `mattpocock/skills` is quick and straightforward, taking only about 30 seconds.\n1. Run the skills.sh installer:\n   bash\n   npx skills@latest add mattpocock/skills\n   \n2. Pick the skills you want and which coding agents you want to install them on. Make sure you select [`/setup-matt-pocock-skills`](https://github.com/mattpocock/skills/blob/main/skills/engineering/setup-matt-pocock-skills/SKILL.md){:target=\"_blank\"}.\n3. Run `/setup-matt-pocock-skills` in your agent. It will ask you about your issue tracker, triage labels, and where to save documentation.\n4. You are now ready to leverage these powerful skills in your development workflow.\n\n## Examples\nThe repository provides a rich set of skills categorized into Engineering, Productivity, and Misc. Here are some highlights demonstrating their practical application:\n\n*   **[`/grill-me`](https://github.com/mattpocock/skills/blob/main/skills/productivity/grill-me/SKILL.md){:target=\"_blank\"} and [`/grill-with-docs`](https://github.com/mattpocock/skills/blob/main/skills/engineering/grill-with-docs/SKILL.md){:target=\"_blank\"}**: These are crucial for ensuring alignment between you and your agent. They facilitate detailed questioning sessions, helping to clarify requirements and prevent misunderstandings before coding begins. `/grill-with-docs` also aids in building a shared language and documenting decisions.\n*   **Shared Language via `CONTEXT.md`**: A core concept embedded in skills like `/grill-with-docs` is the creation of a shared language. This document helps agents decode project jargon, leading to more concise communication, consistent naming, and reduced token usage. For example, replacing \"There's a problem when a lesson inside a section of a course is made 'real'\" with \"There's a problem with the materialization cascade\" significantly improves clarity and concision.\n*   **[`/tdd`](https://github.com/mattpocock/skills/blob/main/skills/engineering/tdd/SKILL.md){:target=\"_blank\"} and [`/diagnose`](https://github.com/mattpocock/skills/blob/main/skills/engineering/diagnose/SKILL.md){:target=\"_blank\"}**: To combat non-working code, the `/tdd` skill promotes a red-green-refactor loop, guiding the agent to write failing tests first and then fix them. The `/diagnose` skill provides a disciplined loop for tackling hard bugs and performance regressions, following steps like reproduce, minimize, hypothesize, instrument, fix, and regression-test.\n*   **[`/improve-codebase-architecture`](https://github.com/mattpocock/skills/blob/main/skills/engineering/improve-codebase-architecture/SKILL.md){:target=\"_blank\"}**: Addressing the challenge of \"ball of mud\" codebases, this skill helps identify opportunities for architectural improvement, ensuring that your AI-generated code remains maintainable and well-designed. It's recommended to run this periodically to keep the codebase healthy.\n*   Other notable skills include [`/to-issues`](https://github.com/mattpocock/skills/blob/main/skills/engineering/to-issues/SKILL.md){:target=\"_blank\"} for breaking down plans into GitHub issues, [`/to-prd`](https://github.com/mattpocock/skills/blob/main/skills/engineering/to-prd/SKILL.md){:target=\"_blank\"} for generating Product Requirement Documents, and [`/zoom-out`](https://github.com/mattpocock/skills/blob/main/skills/engineering/zoom-out/SKILL.md){:target=\"_blank\"} for gaining broader context on code.\n\n## Why Use\n`mattpocock/skills` exists to address fundamental failure modes in AI-powered development. By integrating these skills, engineers can:\n*   **Improve Alignment**: Bridge the communication gap with AI agents through structured grilling sessions, ensuring the agent truly understands the desired outcome.\n*   **Enhance Conciseness**: Develop a shared language to reduce verbosity, foster consistent understanding, and optimize token usage.\n*   **Ensure Code Quality**: Implement robust feedback loops, including Test-Driven Development (TDD) and disciplined debugging, to consistently produce working and reliable code.\n*   **Maintain Architecture**: Proactively manage software entropy and invest in codebase design, preventing complexity from spiraling out of control and ensuring long-term maintainability.\nThese skills distill decades of engineering wisdom into actionable, repeatable practices, empowering developers to ship higher-quality applications with their AI assistants.\n\n## Links\n*   [GitHub Repository](https://github.com/mattpocock/skills){:target=\"_blank\"}\n*   [Sign Up To The Newsletter](https://www.aihero.dev/s/skills-newsletter){:target=\"_blank\"}","metrics":{"detailViews":18,"githubClicks":7},"dates":{"published":null,"modified":"2026-05-28T00:15:09.000Z"}}