Skip to main content
skill CX Codex

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

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-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-next

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

3Manually: put the files in place

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

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

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

Similar skills

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

From the same set70

The whole set →
make-pr This command hands PR preparation to the flow-next-make-pr skill, which renders a PR body and opens it through gh. Choose a draft, base ref, or dry run with flags. CX Codex +1 ★ 730repo stars chart chart turns one oversized or fuzzy idea into a decision map. Each run settles a single decision and leaves a brief you can capture as a task. CX Codex +1 ★ 730repo stars 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 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-prose 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. 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

Project sponsors

Companies that keep this analytics open