edkuksa/skills
1
0
Fork 0
mirror of https://github.com/mattpocock/skills.git synced 2026-05-01 06:23:52 +07:00
Code Issues Packages Projects Releases Wiki Activity

Fix grammatical errors and enhance clarity in README section on agent skills

Browse Source
This commit is contained in:
Matt Pocock
2026-04-28 10:55:14 +01:00
parent 1eed8a689b
commit c21cf6ec93
1 changed files with 9 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+9 -1
View File
@@ -26,7 +26,11 @@ npx skills@latest add mattpocock/skills
I built these skills as a way to fix common failure modes I see with Claude Code, Codex, and other coding agents. I built these skills as a way to fix common failure modes I see with Claude Code, Codex, and other coding agents.
### #1: The Agent Didn't Do What I Wanted ### #1: The Agent Didn't Do What I Want
> "No-one knows exactly what they want"
>
> David Thomas & Andrew Hunt, [The Pragmatic Programmer](https://www.amazon.co.uk/Pragmatic-Programmer-Anniversary-Journey-Mastery/dp/B0833F1T3V)
**The Problem**. The most common failure mode in software development is misalignment. You think the dev knows what you want. Then you see what they've built - and you realize it didn't understand you at all. **The Problem**. The most common failure mode in software development is misalignment. You think the dev knows what you want. Then you see what they've built - and you realize it didn't understand you at all.
@@ -41,6 +45,10 @@ These are my most popular skills. They help you align with the agent before you
### #2: The Agent Is Way Too Verbose ### #2: The Agent Is Way Too Verbose
> With a ubiquitous language, conversations among developers and expressions of the code are all derived from the same domain model.
>
> Eric Evans, [Domain-Driven-Design](https://www.amazon.co.uk/Domain-Driven-Design-Tackling-Complexity-Software/dp/0321125215)
**The Problem**: At the start of a project, devs and the people they're building the software for (the domain experts) are usually speaking different languages. **The Problem**: At the start of a project, devs and the people they're building the software for (the domain experts) are usually speaking different languages.
The domain experts are speaking their language, and the devs are trying to translate it into code. They're often talking past each other. The domain experts are speaking their language, and the devs are trying to translate it into code. They're often talking past each other.