formal-review SKILL.md skillA

formal-review from jongwony/epistemic-protocols is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jongwony/epistemic-protocols/formal-review@git:20261004.2323a31

Pins git:20261004.2323a31 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jongwony/epistemic-protocols
Path
.claude/skills/formal-review/SKILL.md
Versions recorded
8
Latest version
git:20261004.2323a31, committed Oct 4, 2026
First version recorded
Jul 21, 2026
Size
14,137 bytes
Repository stars
173
License
MIT

This skill should be used when the user asks to "formal review", "formal lens review", or invokes /formal-review. A fixed-lens PR review for this repository's formally-structured protocol changes: it pins a Category Theory / Type Theory / Operational Semantics lens panel over only the files changed in a PR, analyzes each lens in isolation, adversarially cross-verifies the findings, and posts the survivors as a single consolidated PR comment. Project-local contributor tooling.

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

# Formal Lens Review

A one-pass review of a PR diff through a **fixed formal lens panel** — Category Theory ∥ Type Theory ∥ Operational Semantics — posted back to the PR as a single consolidated comment for human reviewers. The panel is **pinned** at definition time rather than derived from the diff, so a formally-structured protocol change gets a meticulous, complete formal review on the same three axes every run.

## Why this is a project skill

The formal triple (morphism coherence, type soundness, evaluation-order consistency) is **this repository's** standing review axis — protocol `SKILL.md` files carry category-theoretic formal blocks, `TYPES` / `PHASE TRANSITIONS`, and operational-semantics state machines. Pinning all three here guarantees the formal partial review is exhaustive every run. The fixed panel is therefore project-specific and belongs in the project skill layer. This skill is self-contained — it names its own lenses and describes its own isolated-then-adversarial substrate, with no plugin dependency.

## Caller Signature

```
/formal-review [scope?]
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jongwony/epistemic-protocols/formal-review@sha256:f2334cebea0196bf

The line at the top of this page pins the label git:20261004.2323a31, 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_7bkis75o4ldly5ze.svg)](https://markdownregistry.com/a/art_7bkis75o4ldly5ze)

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

Versions

The registry has recorded 8 versions of this file, between Jul 21, 2026 and Oct 4, 2026, about one every 11 days.

versioncommittedcommitsizeaudit
git:20261004.2323a31 latest2026-10-04 2323a31 14,137 BA view · diff
git:20260925.d1471a92026-09-25 d1471a9 14,098 BA view · diff
git:20260925.27d5e912026-09-25 27d5e91 14,398 BA view · diff
git:20260906.53a61f02026-09-06 53a61f0 14,374 BA view · diff
git:20260905.f7e52392026-09-05 f7e5239 14,109 BA view · diff
git:20260905.71f24112026-09-05 71f2411 14,672 BA view · diff
git:20260904.37d8b942026-09-04 37d8b94 15,013 BA view · diff
git:20260721.4d801e22026-07-21 4d801e2 14,966 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 (14137 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

jongwony/epistemic-protocols · 173 stars · license MIT · pushed 2026-10-31 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7bkis75o4ldly5ze
GET https://markdownregistry.com/api/v1/resolve?ref=jongwony/epistemic-protocols/formal-review
GET https://markdownregistry.com/api/v1/blob/f2334cebea0196bfec7ed9371aee035b0af6ac86fa79ffe0581ccb1e6aa3cbc4

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 jongwony/epistemic-protocols

AGENTS.md@.claude/principles AGENTS.md file
jongwony/epistemic-protocols · .claude/principles/AGENTS.md
git:20261004.309cd39 · audit A · 173 stars
CLAUDE.md@.claude/principles CLAUDE.md file
jongwony/epistemic-protocols · .claude/principles/CLAUDE.md
git:20260804.5f2d14a · audit B · 173 stars
encapsulation SKILL.md skill
jongwony/epistemic-protocols · .claude/skills/encapsulation/SKILL.md · This skill should be used when the user asks to "audit plugin encapsulation", "check self-containment semantics", "find…
git:20260812.1f50d34 · audit A · 173 stars
outcome SKILL.md skill
jongwony/epistemic-protocols · .claude/skills/outcome/SKILL.md · This skill should be used when the user asks to "run the outcome eval", "paired bare vs protocol", "which decisions did…
git:20261015.46b405a · audit A · 173 stars
realize SKILL.md skill
jongwony/epistemic-protocols · .claude/skills/realize/SKILL.md · This skill should be used when the user asks to "run the eval", "test whether the protocol actually works at runtime"…
git:20261015.46b405a · audit A · 173 stars
rederive SKILL.md skill
jongwony/epistemic-protocols · .claude/skills/rederive/SKILL.md · This skill should be used when a contributor names a skill whose Lean contract is to be re-derived — a core protocol…
git:20261023.f0629d4 · audit A · 173 stars
release SKILL.md skill
jongwony/epistemic-protocols · .claude/skills/release/SKILL.md · Release for this repo — CalVer tag + narrative prepend.
git:20261015.ef40fb2 · audit A · 173 stars
verify SKILL.md skill
jongwony/epistemic-protocols · .claude/skills/verify/SKILL.md · This skill should be used when the user asks to "verify protocols", "check consistency before commit", "validate…
git:20261014.426da72 · audit A · 173 stars
AGENTS.md AGENTS.md file
jongwony/epistemic-protocols · AGENTS.md
git:20261015.65e963f · audit A · 173 stars
CLAUDE.md CLAUDE.md file
jongwony/epistemic-protocols · CLAUDE.md
git:20260515.f43f2ee · audit B · 173 stars
AGENTS.md@aitesis AGENTS.md file
jongwony/epistemic-protocols · aitesis/AGENTS.md
git:20260927.c7b710c · audit A · 173 stars
inquire SKILL.md skill
jongwony/epistemic-protocols · aitesis/skills/inquire/SKILL.md · A task rests on missing context or unchecked assumptions: the user can then recognize what was settled and from where…
git:20261027.faa8382 · audit A · 173 stars

Every file in jongwony/epistemic-protocols

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