engineering-judgment SKILL.md skillA

engineering-judgment from nateslabach/skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add nateslabach/skills/engineering-judgment@git:20260521.a303943

Pins git:20260521.a303943 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
nateslabach/skills
Path
skills/engineering-judgment/SKILL.md
Versions recorded
1
Latest version
git:20260521.a303943, committed May 21, 2026
Size
1,895 bytes
Repository stars
6
License
MIT

Applies Chesterton's Fence, Occam's Razor, the Peter Principle, and Dunning-Kruger to technical decisions. Use before refactoring, architectural changes, or any task where changing existing behavior carries risk or requires judgment about what the user actually needs.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# engineering-judgment

Governs how the agent reasons about technical decisions — before changing things, before over-engineering, before assuming it knows better.

## The Laws

- **Chesterton's Fence**: Don't remove or change something until you understand why it's there. Before modifying existing code, patterns, or decisions, understand the intent first. Ask if unclear.
- **Occam's Razor**: The simplest explanation is usually correct. If a simple approach works, use it. Complexity is a cost, not a feature.
- **Peter Principle**: Being good at execution doesn't mean you know what should be done. Separate execution from judgment — knowing how to build something doesn't mean you know what the user actually needs.
- **Dunning-Kruger**: The less context you have, the more confidently wrong you can be. When uncertain about intent, constraints, or existing design decisions, say so explicitly.

## When to Use

- Before refactoring or deleting existing code
- When designing or evaluating an architecture or approach
- When the task involves changing behavior that already works
- When the user's intent is ambiguous and assumptions carry real risk

## Operating Rules
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add nateslabach/skills/engineering-judgment@sha256:09abdda1227910c9

The line at the top of this page pins the label git:20260521.a303943, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_om3lss3aatg63dz7.svg)](https://markdownregistry.com/a/art_om3lss3aatg63dz7)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on May 21, 2026.

versioncommittedcommitsizeaudit
git:20260521.a303943 latest2026-05-21 a303943 1,895 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (1895 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

nateslabach/skills · 6 stars · license MIT · pushed 2026-09-29 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_om3lss3aatg63dz7
GET https://markdownregistry.com/api/v1/resolve?ref=nateslabach/skills/engineering-judgment
GET https://markdownregistry.com/api/v1/blob/09abdda1227910c9f53ec3fa98da1f6eda1d08d9fb55edcaa48ed487c77bd925

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from nateslabach/skills

adhd SKILL.md skill
nateslabach/skills · skills/adhd/SKILL.md · Formats output for ADHD-friendly action — lead with the next step, number tasks, restate state, cut fluff. Use when…
git:20260721.2cfc3e2 · audit A · 6 stars
adversarial-challenge SKILL.md skill
nateslabach/skills · skills/adversarial-challenge/SKILL.md · Devil's-advocate attack on AI workflow designs — threat model, assumption challenges, code critiques, and hypothetical…
git:20260929.63848e3 · audit A · 6 stars
ai-systems-review SKILL.md skill
nateslabach/skills · skills/ai-systems-review/SKILL.md · Hostile self-review of recently written AI workflow code that then applies fixes (agents, tools, chat context…
git:20260929.63848e3 · audit A · 6 stars
asd-ste100 SKILL.md skill
nateslabach/skills · skills/asd-ste100/SKILL.md · Writes in ASD-STE100 simplified technical English — short sentences, plain words, active voice. Use when the user wants…
git:20260809.77317a6 · audit A · 6 stars
branding SKILL.md skill
nateslabach/skills · skills/branding/SKILL.md · Builds personal brand assets using Seth Godin's frameworks: signature symbol, slogan, surprise (Purple Cow), salient…
git:20260929.8a870a5 · audit A · 6 stars
brutal-truth SKILL.md skill
nateslabach/skills · skills/brutal-truth/SKILL.md · Disables the AI's default hedging, diplomatic softening, and social-nicety layers to deliver cold, unfiltered…
git:20260526.1202fa7 · audit A · 6 stars
code-review SKILL.md skill
nateslabach/skills · skills/code-review/SKILL.md · Structured 3-phase peer review of a diff or PR — intent, issues by severity, then pointed merge-readiness questions and…
git:20260929.63848e3 · audit A · 6 stars
create-issue SKILL.md skill
nateslabach/skills · skills/create-issue/SKILL.md · Craft a single, high-quality GitHub issue from a developer's description of a bug, unexpected behavior, or desired…
git:20260721.0a6edff · audit A · 6 stars
css-reset SKILL.md skill
nateslabach/skills · skills/css-reset/SKILL.md · Applies a modern CSS reset covering box-sizing, margin removal, text rendering, media defaults, and root stacking…
git:20260521.8e57b08 · audit A · 6 stars
deep-research SKILL.md skill
nateslabach/skills · skills/deep-research/SKILL.md · Produces thorough, multi-source cited research reports from web and news without paid APIs. Use when the user asks for…
git:20260929.8a870a5 · audit A · 6 stars
depth-ui SKILL.md skill
nateslabach/skills · skills/depth-ui/SKILL.md · Applies depth-driven layered color and shadow principles to elevate average UI into polished, readable interfaces for…
git:20260521.adcc0c6 · audit A · 6 stars
human-writing SKILL.md skill
nateslabach/skills · skills/human-writing/SKILL.md · Strips AI fingerprints from written text by enforcing banned vocabulary, forbidden sentence structures, and authentic…
git:20260521.d1d9510 · audit A · 6 stars

Every file in nateslabach/skills

Browse by kind, by grade A, or by owner.