flow-next-flow SKILL.md skillA

flow-next-flow 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-flow@git:20261106.f99dbf0

Pins git:20261106.f99dbf0 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-flow/SKILL.md
Versions recorded
14
Latest version
git:20261106.f99dbf0, committed Nov 6, 2026
First version recorded
Sep 11, 2026
Size
9,962 bytes
Repository stars
718
License
MIT

Use first in a Flow-Next repo for a spec id, change, bug, issue, slow code or metric, cleanup, design fork, dump to explain, repeated mistake, prompt change, what could break, what next. No quick asks.

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-next:flow - the conductor

Flow chooses the next step so the user does not have to. It reads what it was given, routes from the shared routing reference, runs the routed stage skill, and continues until the next decision that belongs to a human. It re-implements no stage logic: capture, refine, plan, plan-review, work, qa, make-pr, resolve-pr, and land keep their own contracts, receipts, and gates.

**Role:** conductor, inline (no `context: fork`) so `plain-text numbered prompt` stays reachable. On hosts without it, fall back to a plain-text numbered prompt with a final `Other - type your own answer` option.

The hop loop is Steps 1 to 5 below. Read a reference only at the step that names it.

## Preamble

**CRITICAL: flowctl is BUNDLED - NOT installed globally.** `which flowctl` will fail (expected). Define once; subsequent blocks (here and in the steps below) 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
…

Read the whole file at its exact version.

How to install

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

The line at the top of this page pins the label git:20261106.f99dbf0, 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_ym3ukfscw6z2ny7r.svg)](https://markdownregistry.com/a/art_ym3ukfscw6z2ny7r)

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

Versions

The registry has recorded 14 versions of this file, between Sep 11, 2026 and Nov 6, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
git:20261106.f99dbf0 latest2026-11-06 f99dbf0 9,962 BA view · diff
git:20261031.ad77f162026-10-31 ad77f16 9,821 BA view · diff
git:20261016.bbb04c82026-10-16 bbb04c8 9,773 BA view · diff
git:20261015.092ef4d2026-10-15 092ef4d 9,677 BA view · diff
git:20261009.cfe9a742026-10-09 cfe9a74 9,676 BA view · diff
git:20261001.8e26b3f2026-10-01 8e26b3f 4,974 BA view · diff
git:20260929.348ef052026-09-29 348ef05 4,930 BA view · diff
git:20260929.2df06cf2026-09-29 2df06cf 4,935 BA view · diff
git:20260929.1a445862026-09-29 1a44586 6,716 BA view · diff
git:20260929.5ee77b22026-09-29 5ee77b2 6,532 BA view · diff
git:20260921.2a140d22026-09-21 2a140d2 6,650 BA view · diff
git:20260912.48855a52026-09-12 48855a5 6,658 BA view · diff
git:20260912.7eeadd72026-09-12 7eeadd7 5,377 BA view · diff
git:20260911.f92da652026-09-11 f92da65 4,885 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 (9962 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_ym3ukfscw6z2ny7r
GET https://markdownregistry.com/api/v1/resolve?ref=gmickel/flow-next/flow-next-flow
GET https://markdownregistry.com/api/v1/blob/bba6d58a038712cc07462eb09ae6ad4cc11ab145b2b9352ad130812f111fb26e

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-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
flow-next-map SKILL.md skill
gmickel/flow-next · plugins/flow-next/codex/skills/flow-next-map/SKILL.md · Build a semantic feature index of the repo via clawpatch map (opt-in). Use when asked to map the repo.
git:20261031.3796bc0 · audit A · 718 stars

Every file in gmickel/flow-next

Other files named flow-next-flow

flow-next-flow SKILL.md skill
gmickel/flow-next · plugins/flow-next/skills/flow-next-flow/SKILL.md · Use first in a project that uses Flow-Next for any request to implement, build, continue or deliver its specs, whatever…
git:20261106.f99dbf0 · audit A · 718 stars

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