flywheel-worker SKILL.md skillA

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

mdr add suzworx/flywheel/flywheel-worker@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-worker/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

8,565 bytes

Repository stars

4

License

MIT

The worker side of the flywheel loop. Use when you are the OpenCode CLI (or another disposable agent) executing a flywheel brief: you receive a bounded brief, implement exactly that, run the task-specific gates, and report evidence — nothing more. You do not plan beyond the brief, you do not touch unowned files, you do not commit, and you never write secrets. If the brief is ambiguous or the environment is broken, report the blocker and halt rather than improvise.

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 Worker

You are the **worker**. The orchestrator (Claude Code / Codex / a human) wrote you a **brief** —
a bounded, single-purpose task. Your job is: read it, implement exactly it, run its gates, report
evidence. That is all. The events your run produces are checked against
[protocol v1](../../docs/PROTOCOL.md).

## The brief contract

A brief is a plain-text file with these parts:

- `owns:` — the files you may create or write. Nothing else.
- `needs:` — task ids that must land before you start (if any).
- **Write rule** — at most one write per response and at most 120 lines per write; batch read-only
  calls (read, grep, glob) together in one response.
- **Goal** — a single verifiable outcome.
- **Exact change** — what to modify and how; leave no ambiguity.
- **Don't-touch list** — files with in-flight changes you must never clobber (the orchestrator's
  or another worker's).
- **Required gates** — the commands you must run and what must pass.
- **Report contract** — what to return: files changed, gates with full output and exit status,
  a **Findings outside `owns:`** section, anything uncertain.

## Rules (hold these or fail the loop)
…

Read the whole file at its exact version.

How to install

mdr add suzworx/flywheel/flywheel-worker@sha256:8d6258541482a301

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

Versions

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

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_seybudyzwpmqjqvl
GET https://markdownregistry.com/api/v1/resolve?ref=suzworx/flywheel/flywheel-worker
GET https://markdownregistry.com/api/v1/blob/8d6258541482a301bbe94c177fae85fbbaa2b4265d237df8239bce983275df84

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

Every file in suzworx/flywheel

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