Aside from the fact that Matt Pocock spends a lot of time with LLMS (only Claude really), he has a hand-wavy approach to engineering in a silo. He then uses that output as a foundation for other tools, while touting them as the best way to do things on youtube. Claude promotes this kind of developer and it's harmful.
Anyone who uses LLMs notices (intrinsically or through investigation) that there are a small number of useful instructions for LLMs, which is distilled from the language.
The prose he writes often has very little utility, wrapped up in a ball of wax. I would at least expect that an engineer would run AI skill files through an impartial LLM to look for cruft.
To each his own, but it seems like all this could be one moderately-sized AGENTS.md/CLAUDE.md, and much of it doesn’t need to be detailed at all.
For example, you could just put “always follow TDD” in there. If you want to be very complete you could add “first write tests and make sure they’re red before continuing to code. Make sure tests are green on completion”.
Skills are useful for calling specific scripts, adding specific data (like branding info) or detailing truly unusual, bespoke workflows (like the use of cutting-edge machine learning algorithms you’ve developed yourself or something). If you’re detailing something like TDD, you’re probably hampering the model by giving it a definition that is less accurate than the one it has learned in training.
If I had a nickel for every dev who has written a "productivity suite" of skills, and shared it with others as if it was a burst of innovation that everyone can benefit from (when it's really extremely specific to that dev and their workflow) ... well I'd have a lot of nickels.
It turns out productivity skill sets for Claude are a bit like opinions and assholes (everyone has one, and ...)
I mean, just to give you an idea of how common this is, my CEO made a suite like this ... although he had the self-awareness to realize what he made was very specific to him.
Agreed. Skills are hardly transferrable unless you are just focusing on globally applicable things like syntax, structure, etc. The most useful skills are things that are not well known and project/ organization specific. The "tribal knowledge" aspect of coding.
Yep. The useful skills are the org/team rules, and those are the ones that never leave someone’s laptop. Then Cursor’s on a different copy than Claude. That’s the actual problem — drift - not another public set of skills. skillrepo.dev is for keeping that set current in your environment.
In my experience, it’s just easier to build it as you go. Every time the bot stumbles, make sure it’s a teachable moment and the lesson is learned. Every once in a while, do some house cleaning.
Trying to start with these preset banks of instructions just never seems like it works out in the long run. It’s also unsettling catching it behaving in an odd way, and realizing that it was taking a cue from instructions you never wrote, but imported from elsewhere. Like playing a game of pretend with someone else’s rules.
Matt Pocock really needs an AI sidekick that tells him what to do and what not to do. And give the AI the ability to electrocute him whenever he tries to overcomplicate things. Of course the device has to be around his groin area.
Aside from the fact that Matt Pocock spends a lot of time with LLMS (only Claude really), he has a hand-wavy approach to engineering in a silo. He then uses that output as a foundation for other tools, while touting them as the best way to do things on youtube. Claude promotes this kind of developer and it's harmful.
Anyone who uses LLMs notices (intrinsically or through investigation) that there are a small number of useful instructions for LLMs, which is distilled from the language.
* Invariants (always/must, never)
* Precedence
* Guidelines/Opportunistic Inspection (softest instruction)
* Patterns
* Concrete commands/actions
- all of which can be mixed and matched.
The prose he writes often has very little utility, wrapped up in a ball of wax. I would at least expect that an engineer would run AI skill files through an impartial LLM to look for cruft.
eg "if this document is for an LLM to consume, is there any noise in the instructions? https://github.com/mattpocock/skills/blob/main/skills/engine..."
To each his own, but it seems like all this could be one moderately-sized AGENTS.md/CLAUDE.md, and much of it doesn’t need to be detailed at all.
For example, you could just put “always follow TDD” in there. If you want to be very complete you could add “first write tests and make sure they’re red before continuing to code. Make sure tests are green on completion”.
Skills are useful for calling specific scripts, adding specific data (like branding info) or detailing truly unusual, bespoke workflows (like the use of cutting-edge machine learning algorithms you’ve developed yourself or something). If you’re detailing something like TDD, you’re probably hampering the model by giving it a definition that is less accurate than the one it has learned in training.
[flagged]
If I had a nickel for every dev who has written a "productivity suite" of skills, and shared it with others as if it was a burst of innovation that everyone can benefit from (when it's really extremely specific to that dev and their workflow) ... well I'd have a lot of nickels.
It turns out productivity skill sets for Claude are a bit like opinions and assholes (everyone has one, and ...)
I mean, just to give you an idea of how common this is, my CEO made a suite like this ... although he had the self-awareness to realize what he made was very specific to him.
Exposure is still valuable. Eventually you recognise a nice... ahem... opinion... just by looking at it.
You are entirely correct. Matt Pocock is still a nice guy with reasonable opinions and shares a lot with us.
I've personally learned from reading his skills.
Agreed. Skills are hardly transferrable unless you are just focusing on globally applicable things like syntax, structure, etc. The most useful skills are things that are not well known and project/ organization specific. The "tribal knowledge" aspect of coding.
Yep. The useful skills are the org/team rules, and those are the ones that never leave someone’s laptop. Then Cursor’s on a different copy than Claude. That’s the actual problem — drift - not another public set of skills. skillrepo.dev is for keeping that set current in your environment.
I have one I started back in October last year and been improving since. Also a python docs cli to manage agent state in markdown locally.
I love reading them to see if theres a way mine could be improved, what topics they hit on, how they approach different problems.
https://github.com/ArtRichards/agent-playbook-suite
https://artrichards.github.io/agent-playbook-suite/blog/
https://github.com/ArtRichards/docs-cli
In my experience, it’s just easier to build it as you go. Every time the bot stumbles, make sure it’s a teachable moment and the lesson is learned. Every once in a while, do some house cleaning.
Trying to start with these preset banks of instructions just never seems like it works out in the long run. It’s also unsettling catching it behaving in an odd way, and realizing that it was taking a cue from instructions you never wrote, but imported from elsewhere. Like playing a game of pretend with someone else’s rules.
The second skill has this before/after example:
> BEFORE: "There's a problem when a lesson inside a section of a course is made 'real' (i.e. given a spot in the file system)"
> AFTER: "There's a problem with the materialization cascade"
It claims the second is easier reading. Is it just me, or does anyone else prefer the first?
It makes sense if you look at the file[1] he's taking about. It's explicitly declaring jargon so you don't need to redescribe $THING every time.
https://github.com/mattpocock/course-video-manager/blob/076a...
Matt Pocock really needs an AI sidekick that tells him what to do and what not to do. And give the AI the ability to electrocute him whenever he tries to overcomplicate things. Of course the device has to be around his groin area.
Christ, this is exhausting.
Do Real Engineers use AI agents ?