flywheel-operator SKILL.md skillA

flywheel-operator 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-operator@v0.78.1 # x-release-please-version

Pins v0.78.1 # 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-operator/SKILL.md
Versions recorded
40
Latest version
v0.78.1 # x-release-please-version, committed Oct 17, 2026
First version recorded
Sep 24, 2026
Size
54,998 bytes
Repository stars
4
License
MIT

Operate the flywheel framework from any role — human or agent. Use when you want to install flywheel into a repo, validate it is healthy, understand its state, or drive the loop (plan/brief/dispatch/review/correct-or-land) as an operator rather than as a worker. The CLI implements the whole loop except creating and resuming tasks: init, config, log, state, run (through the opencode, claude or sim adapter), validate, inspect, verify, factory, staff, cost, stats, next, status, handoff, trace…

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 Operator

Flywheel is a durable orchestrator-to-worker loop. **Any agent — or a human — can drive it.** The
CLI is the deterministic substrate; the skills are the judgment layer. You are the operator: you
decide what runs, who runs it, and whether it landed. The command table below implements
[protocol v1](../../docs/PROTOCOL.md).

## What the CLI implements today

The table below lists every command `flywheel help` prints, kept in sync with the registry (a doc
test fails the build if a command is missing here). Only `flywheel plan`, `retry` and `artifacts`
are not built yet; the rest of this skill's manual workflow explains what to do until those three
land.

| Command | Status | What it does |
| --- | --- | --- |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add suzworx/flywheel/flywheel-operator@sha256:4cd627779b1e174c

The line at the top of this page pins the label v0.78.1 # 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_xlb2ahl3vhtpda7h.svg)](https://markdownregistry.com/a/art_xlb2ahl3vhtpda7h)

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

Versions

The registry has recorded 40 versions of this file, between Sep 24, 2026 and Oct 17, 2026, more than one a day.

versioncommittedcommitsizeaudit
v0.78.1 # x-release-please-version latest2026-10-17 18f11aa 54,998 BA view · diff
v0.78.0 # x-release-please-version2026-10-16 170760a 54,998 BA view · diff
v0.77.0 # x-release-please-version2026-10-16 0c611f8 54,998 BA view · diff
v0.77.0 # x-release-please-version2026-10-16 22cdd99 54,445 BA view · diff
v0.76.0 # x-release-please-version2026-10-16 cbfb474 54,445 BA view · diff
v0.73.0 # x-release-please-version2026-10-08 5ec749e 53,522 BA view · diff
v0.72.0 # x-release-please-version2026-10-08 8b9d83c 53,522 BA view · diff
v0.72.0 # x-release-please-version2026-10-08 735340d 52,626 BA view · diff
v0.71.4 # x-release-please-version2026-10-08 174e7cf 52,626 BA view · diff
v0.71.4 # x-release-please-version2026-10-08 c7c7aa2 52,314 BA view · diff
v0.70.0 # x-release-please-version2026-10-06 f2fa9f7 52,314 BA view · diff
v0.69.0 # x-release-please-version2026-10-06 6e3d508 52,314 BA view · diff
v0.68.2 # x-release-please-version2026-10-06 05677a5 52,314 BA view · diff
v0.68.1 # x-release-please-version2026-10-06 484b8f8 52,314 BA view · diff
v0.68.0 # x-release-please-version2026-10-04 a99104b 52,314 BA view · diff
v0.67.0 # x-release-please-version2026-10-02 298bd9f 52,314 BA view · diff
v0.66.0 # x-release-please-version2026-10-02 ba8989f 52,314 BA view · diff
v0.66.0 # x-release-please-version2026-10-02 d32ea39 51,590 BA view · diff
v0.65.1 # x-release-please-version2026-10-02 5a6771e 51,590 BA view · diff
v0.65.1 # x-release-please-version2026-10-02 14403ba 51,059 BA view · diff
v0.62.0 # x-release-please-version2026-10-01 9865879 50,100 BA view · diff
v0.61.1 # x-release-please-version2026-10-01 c9f9bf9 50,100 BA view · diff
v0.61.0 # x-release-please-version2026-10-01 55d9c72 50,100 BA view · diff
v0.60.0 # x-release-please-version2026-10-01 4f56f20 50,100 BA view · diff
v0.60.0 # x-release-please-version2026-10-01 b6a16fe 50,042 BA view · diff
v0.47.0 # x-release-please-version2026-09-29 ccd74d7 49,098 BA view · diff
v0.46.0 # x-release-please-version2026-09-29 2e121aa 49,098 BA view · diff
v0.46.0 # x-release-please-version2026-09-29 5e887e1 48,870 BA view · diff
v0.45.0 # x-release-please-version2026-09-29 4aff4c2 48,870 BA view · diff
v0.44.0 # x-release-please-version2026-09-29 c6d5880 48,870 BA view · diff
v0.36.0 # x-release-please-version2026-09-27 6d39170 46,790 BA view · diff
v0.35.0 # x-release-please-version2026-09-27 154e556 46,790 BA view · diff
v0.35.0 # x-release-please-version2026-09-27 4ef1088 46,192 BA view · diff
v0.35.0 # x-release-please-version2026-09-27 06cb911 45,973 BA view · diff
v0.35.0 # x-release-please-version2026-09-27 d0e2c44 45,153 BA view · diff
v0.19.0 # x-release-please-version2026-09-25 d8649fb 32,941 BA view · diff
v0.19.0 # x-release-please-version2026-09-25 4540e01 32,445 BA view · diff
v0.18.2 # x-release-please-version2026-09-24 f2dea2a 32,445 BA view · diff
v0.18.2 # x-release-please-version2026-09-24 6cef732 31,861 BA view · diff
v0.18.2 # x-release-please-version2026-09-24 b8c38bb 30,923 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 (54998 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_xlb2ahl3vhtpda7h
GET https://markdownregistry.com/api/v1/resolve?ref=suzworx/flywheel/flywheel-operator
GET https://markdownregistry.com/api/v1/blob/4cd627779b1e174cf90d5990f21d93970cabed5e9e6a1d2e6c96716518c12d45

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-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-reviewer SKILL.md skill
suzworx/flywheel · skills/flywheel-reviewer/SKILL.md · Review a finished flywheel unit's diff as an independent agent. Use when `flywheel review <task> --agent` hands you a…
v0.19.0 # 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.