Magnus HedemarkandGitHub
1037324c2a
* feat: add programming-principles skill (14 classic software books) - SKILL.md v0.2.0 with cross-cutting principles, task-to-book mapping, and code-assessment workflow - 29 reference files (14 mini + 14 full + assessment methodology) - Agent-agnostic frontmatter (compatibility field, no Hermes-specific metadata) - Wire neckbeard routing table: code review/refactoring/quality assessment - Regenerate Claude marketplace + Codex plugin manifests (97 skills) Source: magnus919/programming-principles (standalone repo, v0.1.1). Local copy was v0.2.0 with code-assessment-workflow.md not yet upstreamed. Standalone repo will be archived with redirect after merge. * fix: satisfy validator — frontmatter fields, skill README, catalog entry - Strip version/author/source from frontmatter (unsupported fields) - Move source attribution into metadata (string-to-string map) - Add programming-principles/README.md with required headings - Add catalog entry to root README.md (alphabetical position) Validator passes locally: 107 canonical skills.
Programming Principles — 14 Classic Software Books
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.
Why Install This Skill
When your agent loads this skill, it gains a shared vocabulary for code quality grounded in established literature rather than vibes. That means:
- Principled code review — findings cite specific books and principles, not just "this looks wrong"
- Task-aware loading — 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)
- Progressive depth — SKILL.md has enough to change decisions; reference files provide per-book depth on demand
- Structured assessment — a reproducible workflow for combining all 14 books against a real repo
What You Get
| Directory | Purpose |
|---|---|
SKILL.md |
Cross-cutting principles by concern, task-to-book mapping, per-book compressed rule cards, compatibility guide |
references/*.mini.md |
14 per-book mini rule sets with triggers, decision rules, and checklists |
references/*.full.md |
14 complete rule catalogs (11–63 KB each) for deep reference or audits |
references/code-assessment-workflow.md |
Structured workflow for combining all books against a real repo |
Triggers
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.
Requirements
Platform-agnostic. Works with any agent that supports the Agent Skills directory format. No external dependencies.
Quick Start
Load SKILL.md for the core principles and task-to-book mapping. When a specific book's guidance is needed, load the corresponding references/<book>.mini.md. For deep audits, load the .full.md variant.