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/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
7,238 bytes
Repository stars
718
License
MIT

Execute a Flow spec or task systematically with git setup, task tracking, quality checks, and commit workflow. Run only by /flow-next:work or when flow-next-flow routes a spec here; any other request to implement, build or work on a spec, Flow-Next named or not, goes to flow-next-flow. Triggers on /flow-next:work with Flow IDs (fn-1-add-oauth, fn-1-add-oauth.2, or legacy fn-1, fn-1.2, fn-1-xxx, fn-1-xxx.2).

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="${DROID_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT}}/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:96fa5abfc439e0d5

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_og6bgn6wod7i6iar.svg)](https://markdownregistry.com/a/art_og6bgn6wod7i6iar)

2 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 7,238 BA view · diff
git:20261031.ad77f162026-10-31 ad77f16 7,503 BA view · diff
git:20261016.2d33e172026-10-16 2d33e17 8,256 BA view · diff
git:20261009.cfe9a742026-10-09 cfe9a74 7,934 BA view · diff
git:20261004.e06ddc02026-10-04 e06ddc0 7,814 BA view · diff
git:20261003.29bbc2e2026-10-03 29bbc2e 7,861 BA view · diff
git:20261001.cba4d0b2026-10-01 cba4d0b 8,173 BA view · diff
git:20261001.cdcb5172026-10-01 cdcb517 8,511 BA view · diff
git:20261001.7d219212026-10-01 7d21921 8,549 BA view · diff
git:20260926.27c89a32026-09-26 27c89a3 14,881 BA view · diff
git:20260914.8126bbb2026-09-14 8126bbb 14,845 BA view · diff
git:20260912.7eeadd72026-09-12 7eeadd7 14,720 BA view · diff
git:20260911.f92da652026-09-11 f92da65 14,690 BA view · diff
git:20260910.9f028092026-09-10 9f02809 14,633 BA view · diff
git:20260905.cfc29f12026-09-05 cfc29f1 14,484 BA view · diff
git:20260904.31bb9f02026-09-04 31bb9f0 14,310 BA view · diff
git:20260901.d8667c92026-09-01 d8667c9 13,528 BA view · diff
git:20260829.a2e1a482026-08-29 a2e1a48 13,113 BA view · diff
git:20260827.cd9664b2026-08-27 cd9664b 12,467 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 (7238 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_og6bgn6wod7i6iar
GET https://markdownregistry.com/api/v1/resolve?ref=gmickel/flow-next/flow-next-work
GET https://markdownregistry.com/api/v1/blob/96fa5abfc439e0d5bd27bda0accb8f98c46eb631e54889ede360a739fab714f5

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/codex/skills/flow-next-work/SKILL.md · Execute a flow-next spec or task with workers, gates and commits. Run when the work command is typed or flow-next-flow…
git:20261031.3796bc0 · audit A · 718 stars

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