first-principles-review SKILL.md skillA

first-principles-review from sno-ai/sno-station-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add sno-ai/sno-station-skills/first-principles-review@git:20261001.8e39faf

Pins git:20261001.8e39faf in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
sno-ai/sno-station-skills
Path
skills/J-peer-review-and-audit/first-principles-review/skill/SKILL.md
Versions recorded
1
Latest version
git:20261001.8e39faf, committed Oct 1, 2026
Size
6,012 bytes
Repository stars
481
License
Apache-2.0

MANUAL-ONLY: challenge a product idea, design, PRD, or architecture from first principles. Use only when the user names this skill. Research first, then write a local review and PRD handoff.

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

# First-Principles Reviewer

Run before a proposal hardens into requirements or source code. The owner is whoever owns the
work and decides what it should be; often that is the user. A PRD is a product requirements
document. Judge the problem framing,
constraints, and solution shape. Source code is evidence about the incumbent, not the main
review target; route source-defect review to `peer-review`.

## Invocation Gate

Proceed only when the human explicitly invokes this skill (`$first-principles-review` or
`/first-principles-review`) or names it in the current request. Do not infer invocation from the presence of a PRD or design.

## Workflow

1. **Freeze the boundary.** Identify the input, record its hash when it is a file, choose a
   local report path, and do not modify the reviewed input. Use
   `reports/<input-stem>-first-principles-review.md` unless the human names another path.
   Use a distinct report filename when the default already exists. If a named input is
   missing or unreadable, locate the canonical artifact, repair access within authority,
   and continue the review. Work on independent evidence meanwhile; ask only for an
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add sno-ai/sno-station-skills/first-principles-review@sha256:dacce3f6c385cfda

The line at the top of this page pins the label git:20261001.8e39faf, 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_wydukctj4wplq36q.svg)](https://markdownregistry.com/a/art_wydukctj4wplq36q)

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

Versions

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

versioncommittedcommitsizeaudit
git:20261001.8e39faf latest2026-10-01 8e39faf 6,012 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 (6012 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

sno-ai/sno-station-skills · 481 stars · license Apache-2.0 · pushed 2026-10-20 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_wydukctj4wplq36q
GET https://markdownregistry.com/api/v1/resolve?ref=sno-ai/sno-station-skills/first-principles-review
GET https://markdownregistry.com/api/v1/blob/dacce3f6c385cfda32d64afde606fbc095c2e63ce5f570e51acf3d8023bd7b2e

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 sno-ai/sno-station-skills

AGENTS.md AGENTS.md file
sno-ai/sno-station-skills · AGENTS.md
git:20261008.302514f · audit A · 481 stars
CLAUDE.md CLAUDE.md file
sno-ai/sno-station-skills · CLAUDE.md
git:20261008.302514f · audit B · 481 stars
agentic-time-estimate SKILL.md skill
sno-ai/sno-station-skills · skills/H-reporting-and-visibility/agentic-time-estimate/skill/SKILL.md · Answer how long agent work will take, how much longer active work needs, or what clock time applies. Estimate full…
git:20261007.9784a78 · audit A · 481 stars
away-brief SKILL.md skill
sno-ai/sno-station-skills · skills/H-reporting-and-visibility/away-brief/skill/SKILL.md · Give the owner one page when they come back from sleep, a meeting or a long run: what got done, what is stuck, what…
git:20261007.9784a78 · audit A · 481 stars
catch-report SKILL.md skill
sno-ai/sno-station-skills · skills/H-reporting-and-visibility/catch-report/skill/SKILL.md · Report how many problems the two brains found: mutual review (the other model checks the work, from the peer-review…
git:20261013.fdbd8e1 · audit A · 481 stars
agentic-walkthrough SKILL.md skill
sno-ai/sno-station-skills · skills/J-peer-review-and-audit/agentic-walkthrough/skill/SKILL.md · Prove that a reported run caused its intended real effect. Walk the executor path from entry to effect, capture one…
git:20261001.8e39faf · audit A · 481 stars
e2e-environment-preflight SKILL.md skill
sno-ai/sno-station-skills · skills/J-peer-review-and-audit/e2e/skills/e2e-environment-preflight/SKILL.md · Check external services, hosts, browser sessions, model endpoints, and agents before an end-to-end run. MANUAL-ONLY…
git:20261001.8e39faf · audit A · 481 stars
e2e-red-triage SKILL.md skill
sno-ai/sno-station-skills · skills/J-peer-review-and-audit/e2e/skills/e2e-red-triage/SKILL.md · Classify one unexpected end-to-end test failure as a product defect or an environment fault needing a new preflight…
git:20261001.8e39faf · audit A · 481 stars
less-is-more SKILL.md skill
sno-ai/sno-station-skills · skills/J-peer-review-and-audit/less-is-more/skill/SKILL.md · Write the least code that works, and cut what an AI agent over-built. Use on any coding task: write, fix, refactor, or…
git:20261001.8e39faf · audit A · 481 stars
owner-intent-audit SKILL.md skill
sno-ai/sno-station-skills · skills/J-peer-review-and-audit/owner-intent-audit/skill/SKILL.md · Check agent-produced plans, tests, or code against the owner's actual intent. Find missing meaning, unrequested work…
git:20261001.8e39faf · audit A · 481 stars
peer-review SKILL.md skill
sno-ai/sno-station-skills · skills/J-peer-review-and-audit/peer-review/skill/SKILL.md · Adversarial review and fix loop for code, specs, plans, and migration manifests.
git:20261013.fdbd8e1 · audit A · 481 stars
medic SKILL.md skill
sno-ai/sno-station-skills · skills/M-build-and-rollout/medic/skill/SKILL.md · Check that this machine's agent team can work and say what is wrong in plain lines: tools installed, core skills…
git:20261007.9784a78 · audit A · 481 stars

Every file in sno-ai/sno-station-skills

Other files named first-principles-review

first-principles-review SKILL.md skill
ganyuanran/aegis · skills/first-principles-review/SKILL.md · Use when asked for first-principles or Occam's-razor review, or when high-risk decisions involve competing constraints…
git:20261020.2ff21fc · audit A · 1,371 stars

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