software-design-philosophy
John Ousterhout's "A Philosophy of Software Design" distilled into a working skill: deep modules, complexity symptoms, red-flag checklists for code reviews and API design.
- What
- John Ousterhout's "A Philosophy of Software Design" distilled into a working skill: deep modules, complexity symptoms, red-flag checklists for code reviews and API design.
- Cost
- Free
- Needs
- none. This is a plain-text knowledge skill, nothing to install or configure.
- Install
- Copy the installer prompt below into your Muse — your agent does the rest.
Curated by Skill Harbor: John Ousterhout's A Philosophy of Software Design, distilled into a working skill for code reviews, architecture discussions, and API design. It covers the three symptoms of complexity (change amplification, cognitive load, unknown unknowns), strategic versus tactical programming, deep versus shallow modules, information hiding and leakage, pulling complexity downward, defining errors out of existence, designing everything twice, and the philosophy of comments and naming, with a red-flags quick reference (shallow module, temporal decomposition, pass-through method, vague names, comment repeats code, and nine more) to run through during reviews. By @hotopla5976, listed here with credit to its creator. Discovered via github.com/topics/ai-skills. Honest caveats: this is a study guide distilled from a published book, use it as a working reference and read the book for the full depth; it is plain text, there is nothing to install beyond reading it. Skill Harbor never reviews the code, review it yourself before use.
Version:
Quick answer
software-design-philosophy is a free Muse skill distilling John Ousterhout's A Philosophy of Software Design into a working skill for code reviews, architecture discussions and API design. It covers the three symptoms of complexity, change amplification, cognitive load and unknown unknowns, strategic versus tactical programming, deep versus shallow modules, and red-flag checklists for reviews.
Install
Copy the install package below, then paste it into Muse🧪 Install ran in our test sandbox · Nov 11, 2026📌 Pinned version: commit c64f2c2Pinned version: install the code at commit c64f2c2b851aee16c58da03ee5b960b8592375cf exactly (Skill Harbor tested this version). Do not substitute a newer version. If this commit is unreachable, stop and tell me. Use "software-design-philosophy" with your Muse. Prerequisites: none. This is a plain-text knowledge skill, nothing to install or configure. 1. Open the skill: https://github.com/hotopla5976/software-design-philosophy-skill and copy the full SKILL.md text. 2. Paste it into a chat with Muse and add: "Use this design philosophy when I ask for code reviews, API design feedback, or refactoring advice. Apply the red-flags checklist to the code I show you." 3. Try it on something real this week: paste a module or a pull request and ask Muse to review it against the deep-modules and red-flags sections. Tip: the "design it twice" habit and the red-flags quick reference are the two highest-leverage parts; ask Muse to run the checklist on your next review. Safety: a skill is plain-text instructions; it runs nothing by itself. Never paste secrets or API keys into it.
Saved to your recent installs. Find it anytime on /connect.
🔒 Security, provenance and what this touches
The install prompt below already includes the vetting steps: your agent follows the community checklist before installing anything with executable code. Want more?
Verification certificate
Dated facts about what was checked for this listing, and how. This is not a safety certification.
- Pinned version
- c64f2c2 · 2026-10-13
- Sandbox install test
- Install ran in our test sandbox · Nov 11, 2026
- Creator identity
- Not verified
- Fingerprint watch
- Last checked · Nov 19, 2026 : no change detected in the files linked by this install prompt
- Install prompt analysis
- 2026-10-13 : No commands, network calls, packages, file writes or API keys detected.
Skill Harbor never reviews the code of a listed skill. These are dated facts about the install prompt and our install test, not a safety certification. Review a skill yourself before you install it. How we verify
Questions
How do I install a skill?
Every product page includes a copy-paste install prompt. Paste it into your Muse and it sets the skill up for you — no manual configuration.
Where does my money go?
Straight to the seller. Skill Harbor never processes payments: checkout happens on the seller’s own page, usually Stripe.
What does the ✓ next to a creator’s name mean?
It means we confirmed the identity of the person behind the listing. It says nothing about the code itself — always check a skill before installing it.