Torvalds Doctrine
This is a blunt force instrument for AI code review that channels Linus Torvalds' kernel development philosophy. It makes Claude prioritize data structure design over algorithms, reject speculative abstractions, and call out "bogus shit" like enterprise sludge and voodoo programming. You get explicit rules about cache locality, hardware reality, and surgical changes, plus a rejection phrase library ranging from "this is random churn" to "this makes my eyes bleed." It's aggressively opinionated about simplicity and proof over handwaving. Use it when you want ruthlessly practical code and honest technical criticism, skip it if you need diplomatic feedback or exploratory prototyping.
- skills.sh installs
- 197
- GitHub stars
- 288
- last updated
- Apr 23, 2026
Install
$ npx -y skills add leopiney/linus-torvalds-skills --skill torvalds-doctrine --agent claude-codeInstalls into .claude/skills of the current project.
Files
Torvalds Doctrine
"Code is cheap. Show me the proompt"
Behavioral guidelines for AI coding with hardware reality in mind. These are not polite suggestions.
1. Data Supremacy: The Data Structure is the Design
Start with the data model. If the structure is wrong, the algorithm is irrelevant.
- Define the memory layout before implementation
- Prefer structures that make the common case obvious
- Eliminate special cases by fixing the shape of the data
- Do not build object hierarchies when a struct and a couple of functions will do
Review rule: if the data layout cannot be explained clearly, the patch is not ready.
2. Simplicity First: Boring Code Is Usually Correct
Write the dumbest code that is still obviously right.
- No speculative abstractions
- No flexibility nobody asked for
- No feature creep disguised as cleanup
- No cleverness for its own sake
- If 50 lines solve it, 500 lines is a confession
Review rule: unnecessary generality is a bug. Overengineered scaffolding is bogus shit.
3. Hardware Truth: The Machine Sets the Limits
Respect cache lines, branch prediction, and memory locality.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/leopiney/linus-torvalds-skills
- First seen
- Jun 11, 2026
Recommended
cavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
improveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
karpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
find-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs