flow-next-setup — Claude Code skill to wire flow-next into a repo
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.
MIT ★ 730 updated 2026-10-29
/plugin marketplace add gmickel/flow-next
/plugin install flow-next@flow-nextWhat flow-next-setup does
This skill connects a repository to the flow-next plugin. It inserts a versioned snippet into the project instruction file, along with a commented model-routing example. Once added, agents like Codex or Cursor pick up the same rules from CLAUDE.md or AGENTS.md.
Installation follows a fixed order. First read working-rules.md, unless this is a re-run; its guidance applies to every step of the skill. Then go through workflow.md step by step. Nothing is copied into the repo, so plugin updates never force a re-run on any host.
The whole thing is optional. Standard plugin usage works without local setup. Re-running is safe, but only needed when the snippet schema bumps or configuration and seeds change.
What it helps with
- let Codex and Cursor read instructions from CLAUDE.md or AGENTS.md
- connect a repo to the flow-next plugin
- set up the flowctl CLI locally
- add a commented model-routing example to the project instruction file
Example prompts for the agent
- Wire this repo to flow-next
- Run /flow-next:setup and follow the steps
- Add flow-next instructions to AGENTS.md
How to install flow-next-setup
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-setup -a claude-code3Manually: put the files in place
~/.claude/skills/flow-next-setup/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/flow-next-setup/
1Skills CLI (Vercel)
npx skills add gmickel/flow-next --skill flow-next-setup -a codex2Manually: put the files in place
.agents/skills/flow-next-setup/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gmickel/flow-next --skill flow-next-setup -a cursor2Manually: put the files in place
.cursor/skills/flow-next-setup/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gmickel/flow-next plugins/flow-next/skills/flow-next-setup2Manually: put the files in place
.github/skills/flow-next-setup/SKILL.md1Skills CLI (Vercel)
npx skills add gmickel/flow-next --skill flow-next-setup -a gemini-cli2Platform CLI
gemini skills install https://github.com/gmickel/flow-next --path plugins/flow-next/skills/flow-next-setupManually: put the files in place
.devin/skills/flow-next-setup/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-setup
How do I install flow-next-setup in Claude Code?
Add the marketplace first: /plugin marketplace add gmickel/flow-next. Then install the plugin: /plugin install flow-next@flow-next. After that, run npx skills add gmickel/flow-next --skill flow-next-setup -a claude-code. The skill file lands at ~/.claude/skills/flow-next-setup/SKILL.md.
What does flow-next-setup do?
It adds a versioned docs snippet and flow-next configuration to CLAUDE.md or AGENTS.md. It also proposes a commented model-routing example in the project instruction file.
Do I need the local setup?
No. flow-next works through the plugin without it. The skill matters only when you want other agents, such as Codex or Cursor, to read the project instructions.
Source text
SKILL.md · MIT
--- name: flow-next-setup description: Optional local install of flowctl CLI and CLAUDE.md/AGENTS.md instructions, plus a commented model-routing example proposed into the project instruction file. Use when user runs /flow-next:setup. user-invocable: false --- # Flow-Next Setup (Optional) Wire this repo to the plugin: the versioned docs snippet plus flow-next configuration. **Fully optional** - flow-next works without this via the plugin. ## Benefits - Other AI agents (Codex, Cursor, etc.) can read instructions from CLAUDE.md/AGENTS.md Read [working-rules.md](../../references/working-rules.md) first unless you already have this run; it holds for every step of this skill. ## Workflow Read [workflow.md](workflow.md) and follow each step in order. ## Notes - **Fully optional** - standard plugin usage works without local setup - Copies nothing into the repo - plugin updates need no per-repo re-run, on any host - Safe to re-run - needed only when the snippet schema bumps or configuration/seeds change
© Gordon Mickel · MIT · gmickel/flow-next