flow-next-work SKILL.md skillA

flow-next-work from gmickel/flow-next is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add gmickel/flow-next/flow-next-work@git:20261031.3796bc0

Pins git:20261031.3796bc0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
gmickel/flow-next
Path
plugins/flow-next/codex/skills/flow-next-work/SKILL.md
Versions recorded
19
Latest version
git:20261031.3796bc0, committed Oct 31, 2026
First version recorded
Aug 27, 2026
Size
6,980 bytes
Repository stars
718
License
MIT

Execute a flow-next spec or task with workers, gates and commits. Run when the work command is typed or flow-next-flow routes here; plain requests to implement fn-N go to flow-next-flow.

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

# Flow work

Execute a plan systematically. Focus on finishing.

**`.flow/` is the only task tracker.** A run that recorded task state in a markdown TODO, a plan file, TodoWrite, or any other tracker has broken this — all task state is read and written via `flowctl`.

## Preamble

**CRITICAL: flowctl is BUNDLED — NOT installed globally.** `which flowctl` will fail (expected). Define once; subsequent blocks (here and in `phases.md`) use `$FLOWCTL`:

```bash
FLOWCTL="${CODEX_HOME:-$HOME/.codex}/scripts/flowctl"
[ -x "$FLOWCTL" ] || FLOWCTL="<plugin-root>/scripts/flowctl"   # <plugin-root> = the directory two levels above this skill's SKILL.md file (the harness gave you that file's absolute path when the skill loaded); substitute it literally
[ -x "$FLOWCTL" ] || FLOWCTL=".flow/bin/flowctl"
```

**Hard requirements (non-negotiable):**
- **Every completed task passes through `flowctl done` and a verified `done` status.** A task treated as finished while `flowctl show <task>` still reads `todo` or `in_progress` has broken this.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add gmickel/flow-next/flow-next-work@sha256:883170567887b4e8

The line at the top of this page pins the label git:20261031.3796bc0, 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_ief75adkymhqiykh.svg)](https://markdownregistry.com/a/art_ief75adkymhqiykh)

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

Versions

The registry has recorded 19 versions of this file, between Aug 27, 2026 and Oct 31, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20261031.3796bc0 latest2026-10-31 3796bc0 6,980 BA view · diff
git:20261031.ad77f162026-10-31 ad77f16 7,245 BA view · diff
git:20261016.2d33e172026-10-16 2d33e17 7,998 BA view · diff
git:20261009.cfe9a742026-10-09 cfe9a74 7,676 BA view · diff
git:20261004.e06ddc02026-10-04 e06ddc0 7,631 BA view · diff
git:20261003.29bbc2e2026-10-03 29bbc2e 7,678 BA view · diff
git:20261001.cba4d0b2026-10-01 cba4d0b 7,990 BA view · diff
git:20261001.cdcb5172026-10-01 cdcb517 8,328 BA view · diff
git:20261001.7d219212026-10-01 7d21921 8,366 BA view · diff
git:20260926.27c89a32026-09-26 27c89a3 14,681 BA view · diff
git:20260914.8126bbb2026-09-14 8126bbb 14,681 BA view · diff
git:20260912.7eeadd72026-09-12 7eeadd7 14,556 BA view · diff
git:20260911.f92da652026-09-11 f92da65 14,526 BA view · diff
git:20260910.9f028092026-09-10 9f02809 14,469 BA view · diff
git:20260905.cfc29f12026-09-05 cfc29f1 14,320 BA view · diff
git:20260904.31bb9f02026-09-04 31bb9f0 14,146 BA view · diff
git:20260901.d8667c92026-09-01 d8667c9 13,370 BA view · diff
git:20260829.a2e1a482026-08-29 a2e1a48 12,955 BA view · diff
git:20260827.cd9664b2026-08-27 cd9664b 12,309 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 (6980 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

gmickel/flow-next · 718 stars · license MIT · pushed 2026-11-07 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_ief75adkymhqiykh
GET https://markdownregistry.com/api/v1/resolve?ref=gmickel/flow-next/flow-next-work
GET https://markdownregistry.com/api/v1/blob/883170567887b4e84ee7b120dee6882044439bbec386d251aec53c415e4d93d0

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 gmickel/flow-next

AGENTS.md AGENTS.md file
gmickel/flow-next · AGENTS.md
git:20261019.759a805 · audit A · 718 stars
CLAUDE.md CLAUDE.md file
gmickel/flow-next · CLAUDE.md
git:20261019.759a805 · audit A · 718 stars
flow-next-audit SKILL.md skill
gmickel/flow-next · plugins/flow-next/codex/skills/flow-next-audit/SKILL.md · Audit .flow/memory/ entries against current code and keep, update, consolidate, replace, delete, or harden each. Use…
git:20261024.f70767b · audit A · 718 stars
flow-next-capture SKILL.md skill
gmickel/flow-next · plugins/flow-next/codex/skills/flow-next-capture/SKILL.md · Save the current conversation as a source-tagged flow-next spec, then offer review or editing. Use when asked to…
git:20261031.ad77f16 · audit A · 718 stars
flow-next-chart SKILL.md skill
gmickel/flow-next · plugins/flow-next/codex/skills/flow-next-chart/SKILL.md · Decision-map discovery for one oversized unclear idea before capture. Resolve one decision per invocation, brief for…
git:20261031.ad77f16 · audit A · 718 stars
flow-next-deps SKILL.md skill
gmickel/flow-next · plugins/flow-next/codex/skills/flow-next-deps/SKILL.md · Show spec dependency graph and execution order. Use when asking 'what's blocking what', 'execution order', 'dependency…
git:20261106.d27e372 · audit A · 718 stars
flow-next-drive SKILL.md skill
gmickel/flow-next · plugins/flow-next/codex/skills/flow-next-drive/SKILL.md · Drive any UI surface like a real user - a web app, a Chromium-backed desktop app (Electron / WebView2, reached over…
git:20261031.ad77f16 · audit B · 718 stars
flow-next-features SKILL.md skill
gmickel/flow-next · plugins/flow-next/codex/skills/flow-next-features/SKILL.md · Seed or maintain the committed user-POV drive map at .flow/features/ so QA and drive reuse how a user reaches each…
git:20261031.ad77f16 · audit A · 718 stars
flow-next-flow SKILL.md skill
gmickel/flow-next · plugins/flow-next/codex/skills/flow-next-flow/SKILL.md · Use first in a Flow-Next repo for a spec id, change, bug, issue, slow code or metric, cleanup, design fork, dump to…
git:20261106.f99dbf0 · audit A · 718 stars
flow-next-impl-review SKILL.md skill
gmickel/flow-next · plugins/flow-next/codex/skills/flow-next-impl-review/SKILL.md · Carmack-level implementation review of changes via the configured backend. Use when asked to review code or a diff in a…
git:20261031.3796bc0 · audit A · 718 stars
flow-next-land SKILL.md skill
gmickel/flow-next · plugins/flow-next/codex/skills/flow-next-land/SKILL.md · Resolve feedback and CI for one named pull request, then merge when authorized and ready. Emits LAND_VERDICT. Use when…
git:20261015.5029807 · audit A · 718 stars
flow-next-make-pr SKILL.md skill
gmickel/flow-next · plugins/flow-next/codex/skills/flow-next-make-pr/SKILL.md · Open a PR with a cognitive-aid body rendered from flow-next spec state via gh, or a GitLab merge request via glab. Use…
git:20261104.c22c769 · audit A · 718 stars

Every file in gmickel/flow-next

Other files named flow-next-work

flow-next-work SKILL.md skill
gmickel/flow-next · plugins/flow-next/skills/flow-next-work/SKILL.md · Execute a Flow spec or task systematically with git setup, task tracking, quality checks, and commit workflow. Run only…
git:20261031.3796bc0 · audit A · 718 stars

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