a-philosophy-of-software-design — Claude Code skill: install
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.
MIT 643 installs ★ 3,328 updated 2026-09-10
npx skills add ciembor/agent-rules-books --skill a-philosophy-of-software-design -a claude-codeWhat a-philosophy-of-software-design does
The skill uses John Ousterhout-inspired design principles to guide code and architecture decisions. It focuses on reducing complexity, shaping module boundaries, and evaluating information hiding and abstraction depth.
Start with a-philosophy-of-software-design.mini.md before making a design or code decision. When its rules do not resolve a particular tradeoff, consult the fuller reference in a-philosophy-of-software-design.md.
The guidance also covers cognitive load and refactoring shallow interfaces. The longer reference is for cases the short rules cannot settle.
What it helps with
- reduce complexity in a module
- define boundaries between modules
- assess abstraction depth
- review an API design
- refactor a shallow interface
Example prompts for the agent
- Review these module boundaries and apply information-hiding principles.
- Assess this API design and suggest a deeper abstraction.
- Help simplify this module and reduce its cognitive load.
How to install a-philosophy-of-software-design
1Skills CLI (Vercel)
npx skills add ciembor/agent-rules-books --skill a-philosophy-of-software-design -a claude-code2Manually: put the files in place
~/.claude/skills/a-philosophy-of-software-design/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/a-philosophy-of-software-design/
1Skills CLI (Vercel)
npx skills add ciembor/agent-rules-books --skill a-philosophy-of-software-design -a codex2Manually: put the files in place
.agents/skills/a-philosophy-of-software-design/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ciembor/agent-rules-books --skill a-philosophy-of-software-design -a cursor2Manually: put the files in place
.cursor/skills/a-philosophy-of-software-design/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ciembor/agent-rules-books a-philosophy-of-software-design2Manually: put the files in place
.github/skills/a-philosophy-of-software-design/SKILL.md1Skills CLI (Vercel)
npx skills add ciembor/agent-rules-books --skill a-philosophy-of-software-design -a gemini-cli2Platform CLI
gemini skills install https://github.com/ciembor/agent-rules-books --path a-philosophy-of-software-designManually: put the files in place
.devin/skills/a-philosophy-of-software-design/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add ciembor/agent-rules-books --skill a-philosophy-of-software-design -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 a-philosophy-of-software-design
How do I install a-philosophy-of-software-design in Claude Code?
Run npx skills add ciembor/agent-rules-books --skill a-philosophy-of-software-design -a claude-code. The skill file is placed at ~/.claude/skills/a-philosophy-of-software-design/SKILL.md.
What does a-philosophy-of-software-design do?
It applies software design principles to code complexity, module boundaries, APIs, and abstractions. It starts with a concise set of rules and uses a longer reference when a design tradeoff needs more detail.
Which files does a-philosophy-of-software-design use?
Read a-philosophy-of-software-design.mini.md first. The fuller guide, a-philosophy-of-software-design.md, covers tradeoffs the short rules do not resolve.
Source text
SKILL.md · MIT
--- name: a-philosophy-of-software-design description: Apply John Ousterhout-inspired software design rules when reducing complexity, designing module boundaries, or reviewing APIs and abstractions. license: MIT --- # A Philosophy of Software Design Skill Use this skill when a task involves module design, API design, information hiding, abstraction depth, cognitive load, or refactoring shallow interfaces. Before making design or code decisions, read and apply [a-philosophy-of-software-design.mini.md](a-philosophy-of-software-design.mini.md). Use [a-philosophy-of-software-design.md](a-philosophy-of-software-design.md) only as a deeper reference when the mini rules are not enough for the current design tradeoff.
© ciembor · MIT · ciembor/agent-rules-books