flywheel-reviewer SKILL.md skillA

flywheel-reviewer from suzworx/flywheel is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add suzworx/flywheel/flywheel-reviewer@v0.19.0 # x-release-please-version

Pins v0.19.0 # x-release-please-version in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
suzworx/flywheel
Path
skills/flywheel-reviewer/SKILL.md
Versions recorded
6
Latest version
v0.19.0 # x-release-please-version, committed Sep 27, 2026
First version recorded
Sep 25, 2026
Size
12,168 bytes
Repository stars
4
License
MIT

Review a finished flywheel unit's diff as an independent agent. Use when `flywheel review <task> --agent` hands you a unit: read the brief and every correction delta after it (in order, a later one overriding an earlier one), the gate readings, the diff from the dispatch base and the files around it, and report concrete defects as findings with a failure scenario, a file, a real line and a fix hint. You never edit, never run git writes, never review your own work and never pass a unit. Prefer…

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

# Flywheel Reviewer

## Your station

You are the **reviewer**: a second pair of eyes between the gauges and QC. The worker built the
unit, `flywheel validate` measured it; you read what the gauges cannot. Your instructions are the
reviewer prompt the framework embeds (`internal/flywheel/review_prompt.md`) — this skill agrees
with it. The model is [`../flywheel/references/factory.md`](../flywheel/references/factory.md), and
your findings are checked against [protocol v1](../../docs/PROTOCOL.md) (rules `review` and
`panel` at inspect, R1 and P1 at verify).

## You do

- Read the whole unit before you judge a line of it.
- Report every concrete defect you can tie to a line, one finding per defect.
- Close a round with one fenced json findings block, and nothing after it.

What you never do is listed under [You never](#you-never), below the contract.

## What you review

1. **The brief**: what the unit was asked to do, its `owns:` and its `gate:` lines.
2. **The gate readings**: what the factory already measured on the tree. Do not repeat them; a
   green gate is a claim about what the gate checks, nothing more.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add suzworx/flywheel/flywheel-reviewer@sha256:46447c087a33782a

The line at the top of this page pins the label v0.19.0 # x-release-please-version, 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_fazdajmbj3itz2bn.svg)](https://markdownregistry.com/a/art_fazdajmbj3itz2bn)

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

Versions

The registry has recorded 6 versions of this file, between Sep 25, 2026 and Sep 27, 2026, more than one a day.

versioncommittedcommitsizeaudit
v0.19.0 # x-release-please-version latest2026-09-27 69cae49 12,168 BA view · diff
v0.19.0 # x-release-please-version2026-09-26 4184c50 11,987 BA view · diff
v0.19.0 # x-release-please-version2026-09-26 71159e2 11,899 BA view · diff
v0.19.0 # x-release-please-version2026-09-25 0d52a39 11,622 BA view · diff
v0.19.0 # x-release-please-version2026-09-25 f25dcfa 11,443 BA view · diff
v0.19.0 # x-release-please-version2026-09-25 6715577 10,117 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 (12168 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

suzworx/flywheel · 4 stars · license MIT · pushed 2026-10-17 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fazdajmbj3itz2bn
GET https://markdownregistry.com/api/v1/resolve?ref=suzworx/flywheel/flywheel-reviewer
GET https://markdownregistry.com/api/v1/blob/46447c087a33782a9b5283c523435a34c3c8ce77e60e8261648d566330d5632d

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 suzworx/flywheel

AGENTS.md AGENTS.md file
suzworx/flywheel · AGENTS.md
git:20260927.56723df · audit A · 4 stars
CLAUDE.md CLAUDE.md file
suzworx/flywheel · CLAUDE.md
git:20260913.23d712c · audit B · 4 stars
llms.txt@docs llms.txt file
suzworx/flywheel · docs/llms.txt
git:20260929.dae4faa · audit A · 4 stars
flywheel-auditor SKILL.md skill
suzworx/flywheel · skills/flywheel-auditor/SKILL.md · Independently audit flywheel's records. Use when a first article is due, a sample of the line is being checked, or the…
v0.78.1 # x-release-please-version · audit A · 4 stars
flywheel-foreman SKILL.md skill
suzworx/flywheel · skills/flywheel-foreman/SKILL.md · Run a line of OpenCode workers. Use when work orders are ready and someone must dispatch them, watch run states, apply…
v0.78.1 # x-release-please-version · audit A · 4 stars
flywheel-inspector SKILL.md skill
suzworx/flywheel · skills/flywheel-inspector/SKILL.md · QC-inspect finished flywheel units. Use when a work order has run and reported done: verify the unit against its work…
v0.78.1 # x-release-please-version · audit A · 4 stars
flywheel-operator SKILL.md skill
suzworx/flywheel · skills/flywheel-operator/SKILL.md · Operate the flywheel framework from any role — human or agent. Use when you want to install flywheel into a repo…
v0.78.1 # x-release-please-version · audit A · 4 stars
flywheel-planner SKILL.md skill
suzworx/flywheel · skills/flywheel-planner/SKILL.md · Plan flywheel work orders. Use when a spec or goal must become bounded, single-purpose tasks with…
v0.78.1 # x-release-please-version · audit A · 4 stars
flywheel-steward SKILL.md skill
suzworx/flywheel · skills/flywheel-steward/SKILL.md · Turn flywheel signals and nonconformances into learnings. Use when signals are untriaged, nonconformances have been…
v0.78.1 # x-release-please-version · audit A · 4 stars
flywheel-worker SKILL.md skill
suzworx/flywheel · skills/flywheel-worker/SKILL.md · The worker side of the flywheel loop. Use when you are the OpenCode CLI (or another disposable agent) executing a…
v0.78.1 # x-release-please-version · audit A · 4 stars
flywheel SKILL.md skill
suzworx/flywheel · skills/flywheel/SKILL.md · Drive a durable orchestrator-to-worker implementation loop. Codex or Claude Code act as the orchestrator (plan, brief…
v0.78.1 # x-release-please-version · audit A · 4 stars

Every file in suzworx/flywheel

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