Skip to main content
skill CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next
Open on GitHub

What 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.md first and draft under it.
  • /flow-next:prose Here is my draft summary — tighten it under the contract.
  • Check the prose contract in docs/prose.md before you answer.

How to install flow-next-prose

1Plugin marketplace

/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-next

This 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-code

3Manually: put the files in place

~/.claude/skills/flow-next-prose/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/flow-next-prose/

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

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set70

The whole set →
capture capture synthesizes the active conversation into a flow-next spec at .flow/specs/<spec-id>.md with review checks and overwrite protection. CX Codex +1 ★ 730repo stars tracker-sync tracker-sync projects a flow spec into Linear, GitHub, GitLab, or Jira, then reconciles issue body, status, and comments in both directions. CX Codex +1 ★ 730repo stars flow-next-setup flow-next-setup links a repo to the flow-next plugin: adds versioned docs and config to CLAUDE.md or AGENTS.md. Other agents, such as Codex or Cursor, can then read the same instructions. CX Codex +1 ★ 730repo stars flow The flow command drives a task from idea or bug to ready PR. Works for unattended runs on a ready spec or step-by-step with stops before decisions. CX Codex +1 ★ 730repo stars flow-next flow-next directs AI models to manage fn-N tasks using flowctl instead of markdown TODO lists. CX Codex +1 ★ 730repo stars flow-next-make-pr flow-next-make-pr is a Claude Code skill that builds a briefing from an aid artifact and opens or updates a PR through gh. It detects the spec from the branch and accepts options for draft state, base branch, and dry runs. CX Codex +1 ★ 730repo stars flow-next-worktree-kit flow-next-worktree-kit is a Claude Code skill that creates, switches, and removes git worktrees and copies .env files between them. It supports parallel feature work without switching branches. CX Codex +1 ★ 730repo stars flow-next-land The flow-next-land skill handles feedback and CI checks for a named pull request, then squash-merges it when authorized and ready. Use it when asked to land a specific PR. CX Codex +1 ★ 730repo stars

Project sponsors

Companies that keep this analytics open