AIHero
    Free

    Series · 25 lessons

    AI Skills for Real Engineers

    A practical skill system for engineers who want to use AI without giving up their standards.

    Matt Pocock
    Matt Pocock

    These are the agent skills I lean on every day. They live in my ~/.claude directory and ship as a public repo so anyone can install them, fork them, or open a PR with their own.

    What's a skill?

    A skill is a focused, repeatable workflow an agent can run. It bundles a clear instruction set, the inputs it needs, and the outputs you should expect. Skills live as small markdown files that any Claude-compatible agent picks up.

    The point isn't to wrap the agent in scaffolding. It's to write down the exact moves I'd make for a given problem so the agent runs them the same way I would, every time.

    Install

    One command pulls the whole catalog into your global skills directory:

    npx skills add mattpocock/skills -y -g

    Drop -g to install into the current project only. Once installed, any agent that reads ~/.claude/skills (Claude Code is the obvious one) can pick a skill from the catalog and run it.

    You can also install individual skills if you don't want the whole set. Browse the source for slugs: github.com/mattpocock/skills.

    How I use them

    Each skill below is a workflow I reach for in a specific moment: a vague spec to interrogate, a domain to model, a PRD to write, a backlog to break down, a feature to test-drive. They aren't "AI productivity hacks." They're how I keep my taste and standards intact while the agent does the work.

    Open source

    The catalog lives at github.com/mattpocock/skills. If you've shaped a skill that's earned its place in your workflow, share it.

    25 lessons, in order

    1. Getting Started

    2. 01

      The /setup-matt-pocock-skills Skill

      Set up one repo so the other skills know how it works.
    3. 02

      The /ask-matt Skill

      Find out which skill to use for the situation you are in.
    4. The Main Flow

    5. 03

      The /grill-with-docs Skill

      Get interviewed about a plan, and record the decisions.
    6. 04

      The /to-spec Skill

      Turn an agreed conversation into a written spec.
    7. 05

      The /to-tickets Skill

      Split a spec into small tickets an agent can build.
    8. 06

      The /implement Skill

      Build a finished spec into code, test-first.
    9. 07

      The /code-review Skill

      Review a diff against your standards and against the spec.
    10. Shaping

    11. 08

      The /wayfinder Skill

      Chart a large effort as a map of decisions, and settle them.
    12. 09

      The /prototype Skill

      Answer a design question with code you then delete.
    13. 10

      The /research Skill

      Get a cited answer, read from primary sources.
    14. Upkeep

    15. 11

      The /improve-codebase-architecture Skill

      Find the modules worth refactoring, as a visual report.
    16. 12

      The /diagnosing-bugs Skill

      Diagnose a hard bug, starting from a repro that fails.
    17. 13

      The /resolving-merge-conflicts Skill

      Finish a merge or rebase conflict, hunk by hunk.
    18. 14

      The /triage Skill

      Sort raw issues into work someone can pick up.
    19. 15

      The /wizard Skill

      Generate a script that walks a human through setup.
    20. Productivity Skills

    21. 16

      The /grill-me Skill

      Align on an idea before committing to it.
    22. 17

      The /handoff Skill

      Write up a long session so another agent can continue it.
    23. 18

      The /to-questionnaire Skill

      Turn open questions into a doc someone else fills in.
    24. 19

      The /teach Skill

      Learn a topic across many sessions that build on each other.
    25. 20

      The /wait-what Skill

      Ask the agent to say that again, in plain English.
    26. 21

      The /writing-for-agents Skill

      How to write skills and other documents agents read.
    27. Reference Skills

    28. 22

      The /codebase-design Skill

      The vocabulary for designing deep modules.
    29. 23

      The /domain-modeling Skill

      Sharpen the words a project uses, and write them down.
    30. 24

      The /grilling Skill

      The interview other skills run to stress-test a plan.
    31. 25

      The /tdd Skill

      The rules of the red-green-refactor loop.

    After this series

    Put it to work with the skills

    Free, open-source skills that turn these fundamentals into a real engineering workflow with your agent.

    Browse the skills