flow-next-prose — Claude Code skill: what it does, how to install
flow-next-prose — a skill for Claude and Codex that makes the agent read the prose contract in docs/prose.md before a long reply and draft under rules 1–10.
MIT ★ 730 updated 2026-10-29
/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-nextWhat flow-next-prose does
The skill fires when the agent starts a long answer: a review walkthrough, a report, a summary. Before the first draft it reads the prose contract in docs/prose.md, resolved from the location of SKILL.md itself, and then writes under rules 1–10 as it goes.
Its only tool is Read. Quoted material, code and command output stay as they are, and the user's own wording is not restyled. Rule 8 relaxes for replies so the answer comes first. Rule 10 on honesty stays in force.
You can also call it directly: /flow-next:prose with a draft as the argument, and that draft gets rewritten under the contract. If docs/prose.md is missing next to SKILL.md, the skill skips the contract and does not block the reply. With no file there, it gives you nothing.
What it helps with
- keep a long agent answer inside the prose contract from the first draft
- tighten an existing draft through
/flow-next:prose - stop reports that bury the answer under a warm-up
- keep quoted code and command output verbatim
- hold review walkthroughs to the same rules as other write-ups
Example prompts for the agent
- Write up the review walkthrough, but read
docs/prose.mdfirst and draft under it. - /flow-next:prose Here is my draft summary — tighten it under the contract.
- Check the prose contract in
docs/prose.mdbefore you answer.
How to install flow-next-prose
1Plugin marketplace
/plugin marketplace add gmickel/flow-next/plugin install flow-next@flow-nextThis installs the whole flow-next plugin with all its skills
2Skills CLI (Vercel)
npx skills add gmickel/flow-next --skill flow-next-prose -a claude-code3Manually: put the files in place
~/.claude/skills/flow-next-prose/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/flow-next-prose/
1Skills CLI (Vercel)
npx skills add gmickel/flow-next --skill flow-next-prose -a codex2Manually: put the files in place
.agents/skills/flow-next-prose/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gmickel/flow-next --skill flow-next-prose -a cursor2Manually: put the files in place
.cursor/skills/flow-next-prose/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gmickel/flow-next plugins/flow-next/skills/flow-next-prose2Manually: put the files in place
.github/skills/flow-next-prose/SKILL.md1Skills CLI (Vercel)
npx skills add gmickel/flow-next --skill flow-next-prose -a gemini-cli2Platform CLI
gemini skills install https://github.com/gmickel/flow-next --path plugins/flow-next/skills/flow-next-proseManually: put the files in place
.devin/skills/flow-next-prose/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about flow-next-prose
How do I install flow-next-prose in Claude Code?
Run /plugin marketplace add gmickel/flow-next, then /plugin install flow-next@flow-next.
What does flow-next-prose do?
It makes the agent read the prose contract in docs/prose.md before drafting a substantial reply and write under rules 1–10 from the first draft. Short conversational turns are out of scope.
Does it work when the contract file is missing?
Yes. The skill skips the doc and never blocks the reply, so the answer goes out without the contract applied.
Source text
SKILL.md · MIT
--- name: flow-next-prose description: "Use while drafting any substantial reply, report, review walkthrough, or summary for the user - read the artifact prose contract before writing, not after, and draft under its rules. Do not use for short conversational turns, tool-call narration, the visual digest, or output that lands in a file, PR, or tracker (those artifact surfaces carry their own pointers). Also invocable directly as /flow-next:prose [draft]." user-invocable: false allowed-tools: Read --- # Flow Prose Ambient triggering is host-discretionary on every host: the host matches this skill's description at the moment the agent begins drafting a substantial reply. The agent reads the prose contract at [docs/prose.md](../../docs/prose.md), resolved relative to this SKILL.md file's own location. If the doc is absent, the skill proceeds without it and never blocks the reply. The agent applies the contract's rules 1-10 at draft time and writes the reply under them from the first draft. The reply-dormant parts of the doc are the precedence section's dedup-marker and projection bullets, which stay idle for replies. Rule 8 (user-outcome-first ordering) softens to lead with the answer. Rule 10 (honesty) stays fully active. The agent never rewrites quoted material, code, or command output, and never restyles the user's words where they are being quoted back. A draft the user hands the skill as the `/flow-next:prose <draft>` argument is submitted for tightening, so the agent rewrites it under the contract. Pass the identity (the path above). Never copy rule text from the doc into this skill.
© Gordon Mickel · MIT · gmickel/flow-next