{"slug":"programming-principles","title":"programming-principles","summary":"Apply distilled coding principles from 14 classic software books to code review, refactoring, design, and implementation decisions. Do not use for language- or framework-specific tutorials, tool manuals, or tasks already governed by a project's established conventions.","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-09-12T11:14:56.90879Z","repo":{"url":"https://github.com/magnus919/agent-skills","stars":96,"forks":9,"license":"MIT","updatedAt":"2026-09-25T05:53:13Z"},"bodyHtml":"<h1>Programming Principles — 14 Classic Software Books</h1>\n<p>Distilled coding principles from 14 classic software engineering books, organized for agent consumption. Cross-cutting principles by concern, task-to-book mapping, per-book rule sets at two depths, and a structured code-assessment workflow.</p>\n<h2>Why Install This Skill</h2>\n<p>When your agent loads this skill, it gains a <strong>shared vocabulary for code quality</strong> grounded in established literature rather than vibes. That means:</p>\n<ul>\n<li><strong>Principled code review</strong> — findings cite specific books and principles, not just \"this looks wrong\"</li>\n<li><strong>Task-aware loading</strong> — a task-to-book mapping table tells the agent which principles matter for the current work (refactoring? load Refactoring + WELC. architecture? load APoSD + Clean Architecture)</li>\n<li><strong>Progressive depth</strong> — SKILL.md has enough to change decisions; reference files provide per-book depth on demand</li>\n<li><strong>Structured assessment</strong> — a reproducible workflow for combining all 14 books against a real repo</li>\n</ul>\n<h2>What You Get</h2>\n<table>\n<thead>\n<tr>\n<th>Directory</th>\n<th>Purpose</th>\n</tr>\n</thead>\n<tbody>\n<tr>\n<td><code>SKILL.md</code></td>\n<td>Cross-cutting principles by concern, task-to-book mapping, per-book compressed rule cards, compatibility guide</td>\n</tr>\n<tr>\n<td><code>references/*.mini.md</code></td>\n<td>14 per-book mini rule sets with triggers, decision rules, and checklists</td>\n</tr>\n<tr>\n<td><code>references/*.full.md</code></td>\n<td>14 complete rule catalogs (11–63 KB each) for deep reference or audits</td>\n</tr>\n<tr>\n<td><code>references/code-assessment-workflow.md</code></td>\n<td>Structured workflow for combining all books against a real repo</td>\n</tr>\n</tbody>\n</table>\n<h2>Triggers</h2>\n<p>Load this skill for code review, refactoring, implementation quality assessment, architecture decisions, or any coding task where you want principled guidance rather than ad-hoc judgment. Also load when performing a structured code assessment against a repository.</p>\n<h2>Requirements</h2>\n<p>Platform-agnostic. Works with any agent that supports the Agent Skills directory format. No external dependencies.</p>\n<h2>Quick Start</h2>\n<p>Load SKILL.md for the core principles and task-to-book mapping. When a specific book's guidance is needed, load the corresponding <code>references/&lt;book&gt;.mini.md</code>. For deep audits, load the <code>.full.md</code> variant.</p>\n","files":[{"path":"evals/evals.json","sizeBytes":13069,"isText":true},{"path":"README.md","sizeBytes":2151,"isText":true},{"path":"references/a-philosophy-of-software-design.full.md","sizeBytes":13561,"isText":true},{"path":"references/a-philosophy-of-software-design.mini.md","sizeBytes":5774,"isText":true},{"path":"references/clean-architecture.full.md","sizeBytes":17782,"isText":true},{"path":"references/clean-architecture.mini.md","sizeBytes":5486,"isText":true},{"path":"references/clean-code.full.md","sizeBytes":13851,"isText":true},{"path":"references/clean-code.mini.md","sizeBytes":3804,"isText":true},{"path":"references/code-assessment-workflow.md","sizeBytes":4502,"isText":true},{"path":"references/code-complete.full.md","sizeBytes":12407,"isText":true},{"path":"references/code-complete.mini.md","sizeBytes":6717,"isText":true},{"path":"references/designing-data-intensive-apps.full.md","sizeBytes":16084,"isText":true},{"path":"references/designing-data-intensive-apps.mini.md","sizeBytes":6949,"isText":true},{"path":"references/domain-driven-design-distilled.full.md","sizeBytes":11351,"isText":true},{"path":"references/domain-driven-design-distilled.mini.md","sizeBytes":2521,"isText":true},{"path":"references/domain-driven-design.full.md","sizeBytes":42424,"isText":true},{"path":"references/domain-driven-design.mini.md","sizeBytes":3599,"isText":true},{"path":"references/implementing-domain-driven-design.full.md","sizeBytes":12848,"isText":true},{"path":"references/implementing-domain-driven-design.mini.md","sizeBytes":4970,"isText":true},{"path":"references/patterns-of-eaa.full.md","sizeBytes":15501,"isText":true},{"path":"references/patterns-of-eaa.mini.md","sizeBytes":2699,"isText":true},{"path":"references/refactoring.full.md","sizeBytes":17866,"isText":true},{"path":"references/refactoring-guru.full.md","sizeBytes":1101,"isText":true},{"path":"references/refactoring-guru.full-smells-and-priorities.md","sizeBytes":32039,"isText":true},{"path":"references/refactoring-guru.full-technique-playbook-and-safety.md","sizeBytes":31005,"isText":true},{"path":"references/refactoring-guru.mini.md","sizeBytes":2307,"isText":true},{"path":"references/refactoring.mini.md","sizeBytes":2550,"isText":true},{"path":"references/release-it.full.md","sizeBytes":13542,"isText":true},{"path":"references/release-it.mini.md","sizeBytes":2488,"isText":true},{"path":"references/the-pragmatic-programmer.full.md","sizeBytes":13398,"isText":true},{"path":"references/the-pragmatic-programmer.mini.md","sizeBytes":2886,"isText":true},{"path":"references/working-effectively-with-legacy-code.full.md","sizeBytes":13817,"isText":true},{"path":"references/working-effectively-with-legacy-code.mini.md","sizeBytes":2382,"isText":true},{"path":"SKILL.md","sizeBytes":19161,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-12T11:15:30.412026Z","sha256":"FB5612BB4C09CDDB987A7427D483FFDE7B3E6110FB05A76BBCCA0A7D2CF03FF7","sizeBytes":143264},"review":null,"source":{"repositoryUrl":"https://github.com/magnus919/agent-skills","path":"programming-principles","license":"MIT","commit":"1a7d5757db23474b58b4a5588356e09bd0ac5886","subtreeSha":"66C52E854ACF242704ABC563B109DF27B5808A85455F0494D86B7F066937948E","lastSyncedAt":"2026-09-25T06:49:43.852966Z"},"reviewedAt":"2026-09-12T11:16:12.880407Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/magnus919/agent-skills/tree/main/programming-principles"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install magnus919-agent-skills@llmmart"},{"target":"git","command":"git clone https://github.com/magnus919/agent-skills.git"}]}