flow-next SKILL.md skillA

flow-next 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@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/skills/flow-next/SKILL.md
Versions recorded
10
Latest version
git:20261106.f99dbf0, committed Nov 6, 2026
First version recorded
Jul 2, 2026
Size
6,287 bytes
Repository stars
718
License
MIT

Manage .flow/ tasks and specs. Triggers: 'show me my tasks', 'list specs', 'what tasks are there', 'add a task', 'create task', 'what's ready', 'task status', 'show fn-1-add-oauth'. NOT for /flow-next:plan or /flow-next:work.

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 Task Management

Quick task operations in `.flow/`. To build or plan a feature use `/flow-next:flow`; it picks the route.

## Preamble

**CRITICAL: flowctl is BUNDLED — NOT installed globally.** `which flowctl` will fail (expected). Define once; subsequent blocks 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"
```

**Discover all commands/options:**
```bash
$FLOWCTL --help
$FLOWCTL <command> --help   # e.g., $FLOWCTL task --help
```

## Quick Reference

```bash
# Check if .flow exists
$FLOWCTL detect --json

# Initialize (if needed)
$FLOWCTL init --json

# List everything (specs + tasks grouped)
$FLOWCTL list --json

# List all specs
$FLOWCTL specs --json

# List all tasks (or filter by spec/status)
$FLOWCTL tasks --json
$FLOWCTL tasks --spec fn-1-add-oauth --json
$FLOWCTL tasks --status todo --json

# View spec with all tasks
…

Read the whole file at its exact version.

How to install

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

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

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

Versions

The registry has recorded 10 versions of this file, between Jul 2, 2026 and Nov 6, 2026, about one every 14 days.

versioncommittedcommitsizeaudit
git:20261106.f99dbf0 latest2026-11-06 f99dbf0 6,287 BA view · diff
git:20261005.550bd0e2026-10-05 550bd0e 6,286 BA view · diff
git:20261001.63957f42026-10-01 63957f4 5,955 BA view · diff
git:20260926.27c89a32026-09-26 27c89a3 6,765 BA view · diff
git:20260926.e5535832026-09-26 e553583 6,373 BA view · diff
git:20260828.53a25842026-08-28 53a2584 6,125 BA view · diff
git:20260815.bfe5cd92026-08-15 bfe5cd9 5,990 BA view · diff
git:20260809.35b00bc2026-08-09 35b00bc 5,755 BA view · diff
git:20260809.dc3051b2026-08-09 dc3051b 5,319 BA view · diff
git:20260702.08ade802026-07-02 08ade80 4,410 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 (6287 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_n5zbls4rpc6k2ijw
GET https://markdownregistry.com/api/v1/resolve?ref=gmickel/flow-next/flow-next
GET https://markdownregistry.com/api/v1/blob/83ac3774f0bebe57cb5438089a6fefecee066c702ec32dfc68820ba1bb543938

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

flow-next SKILL.md skill
gmickel/flow-next · plugins/flow-next/codex/skills/flow-next/SKILL.md · Manage .flow/ tasks and specs. Use for show or list tasks, task status, what is ready, show fn-N. NOT for building or…
git:20261106.f99dbf0 · audit A · 718 stars

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