the-pragmatic-programmer — Claude Code skill: how to install
the-pragmatic-programmer — a skill for Claude Code and Codex applying Hunt and Thomas-inspired engineering guidelines. Triggers during architecture decisions, automation work, and code refactoring.
MIT 603 installs ★ 3,328 updated 2026-09-10
npx skills add ciembor/agent-rules-books --skill the-pragmatic-programmer -a claude-codeWhat the-pragmatic-programmer does
The skill guides the assistant toward pragmatic engineering judgment, emphasizing orthogonality, knowledge-level DRY, and rapid feedback loops. It structures how the model evaluates technical tradeoffs.
Guidance relies on two reference levels. The agent consults the-pragmatic-programmer.mini.md first, opening the-pragmatic-programmer.md only when mini rules fall short for a complex design decision. Distributed under the MIT license.
What it helps with
- evaluate architectural tradeoffs against orthogonality principles
- eliminate knowledge duplication across modules
- structure rapid feedback cycles during prototyping
- review code adaptability before implementation
Example prompts for the agent
- Review this module design following the-pragmatic-programmer guidelines
- Check our domain logic for knowledge-level DRY violations
- Help make an engineering tradeoff using the-pragmatic-programmer rules
How to install the-pragmatic-programmer
1Skills CLI (Vercel)
npx skills add ciembor/agent-rules-books --skill the-pragmatic-programmer -a claude-code2Manually: put the files in place
~/.claude/skills/the-pragmatic-programmer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/the-pragmatic-programmer/
1Skills CLI (Vercel)
npx skills add ciembor/agent-rules-books --skill the-pragmatic-programmer -a codex2Manually: put the files in place
.agents/skills/the-pragmatic-programmer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ciembor/agent-rules-books --skill the-pragmatic-programmer -a cursor2Manually: put the files in place
.cursor/skills/the-pragmatic-programmer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ciembor/agent-rules-books the-pragmatic-programmer2Manually: put the files in place
.github/skills/the-pragmatic-programmer/SKILL.md1Skills CLI (Vercel)
npx skills add ciembor/agent-rules-books --skill the-pragmatic-programmer -a gemini-cli2Platform CLI
gemini skills install https://github.com/ciembor/agent-rules-books --path the-pragmatic-programmerManually: put the files in place
.devin/skills/the-pragmatic-programmer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ciembor/agent-rules-books --skill the-pragmatic-programmer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about the-pragmatic-programmer
How to install the-pragmatic-programmer in Claude Code?
Run npx skills add ciembor/agent-rules-books --skill the-pragmatic-programmer -a claude-code. The file is stored at ~/.claude/skills/the-pragmatic-programmer/SKILL.md.
What does the-pragmatic-programmer do?
It equips the agent with Hunt and Thomas pragmatic programming rules to improve design decisions, automation, and system adaptability.
How does the-pragmatic-programmer structure its rules?
The assistant inspects the-pragmatic-programmer.mini.md first and references the full the-pragmatic-programmer.md only for intricate tradeoffs.
Source text
SKILL.md · MIT
--- name: the-pragmatic-programmer description: Apply Hunt and Thomas-inspired pragmatic programming rules when improving engineering judgment, feedback loops, DRY knowledge, orthogonality, automation, or adaptability. license: MIT --- # The Pragmatic Programmer Skill Use this skill when a task involves pragmatic engineering judgment, responsibility, DRY at the knowledge level, orthogonality, automation, prototyping, fast feedback, or adaptable design. Before making design or code decisions, read and apply [the-pragmatic-programmer.mini.md](the-pragmatic-programmer.mini.md). Use [the-pragmatic-programmer.md](the-pragmatic-programmer.md) only as a deeper reference when the mini rules are not enough for the current engineering tradeoff.
© ciembor · MIT · ciembor/agent-rules-books