Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ciembor/agent-rules-books --skill the-pragmatic-programmer -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/the-pragmatic-programmer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/the-pragmatic-programmer/

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

Similar skills

All skills for Code review and refactoring →

From the same set14

The whole set →
clean-architecture This Claude Code skill applies clean architecture principles to decisions about separating business policy from implementation details. It activates for work on dependency direction, use cases, and application boundaries. CX Codex +1 645installs a-philosophy-of-software-design The a-philosophy-of-software-design Claude Code skill applies software design principles to complexity, module boundaries, APIs, and abstractions. It activates during design reviews or refactoring of shallow interfaces. CX Codex +1 643installs code-complete The code-complete Claude Code skill applies software construction rules to routines, classes, control flow, defensive code, and tests. It activates for implementation and design tasks. CX Codex +1 611installs release-it The release-it Claude Code skill applies production reliability rules to failure handling, timeouts and retries. It activates on tasks involving integration failures, deployment or operational readiness. CX Codex +1 607installs working-effectively-with-legacy-code working-effectively-with-legacy-code — a skill for Claude Code and Codex that enforces Michael Feathers' legacy code techniques. Activates during risky refactoring, missing test coverage, and dependency breaking. CX Codex +1 602installs refactoring-guru refactoring-guru — a skill for Claude Code helps diagnose code smells and choose focused refactoring techniques. The agent applies its rules to code changes while preserving behavior. CX Codex +1 598installs designing-data-intensive-applications designing-data-intensive-applications — a skill for Claude Code that applies Martin Kleppmann-inspired data-system rules when designing scalable architectures. CX Codex +1 598installs domain-driven-design-distilled domain-driven-design-distilled — a skill for Claude Code that integrates lightweight Domain-Driven Design (DDD) rules into the development workflow. It assists in modeling domains and contexts without excess ceremony. CX Codex +1 593installs

Project sponsors

Companies that keep this analytics open