Skip to main content
skill CX Codex

flow-next-make-pr · gmickel, codex — Claude Code skill: open a PR from spec state

flow-next-make-pr opens a pull request through gh, with the briefing body rendered by flowctl from the flow-next spec state. Fits repos where PRs are expected to follow a spec.

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-make-pr does

The skill opens a pull request with gh. The briefing body is built by flowctl, which checks the aid object, stores it, and renders the result from the spec state. There is no extra confirmation step: the call itself clears the push and the PR.

flowctl is looked up at ${CODEX_HOME:-$HOME/.codex}/scripts/flowctl, then in the plugin's scripts/ folder, then at .flow/bin/flowctl; the first executable wins. Nothing assumes a global install, so a repo missing all three has no way to run. The positional token is SPEC_ID. Flags: --draft and --ready, --base <ref>, --memory, --update, --dry-run. That last one previews the whole run and skips repo writes, pushes, and PR edits.

Missing details are asked for in plain text, as a numbered list ending with a write-your-own option. PRs come up ready for review; draft only with --draft or while items stay open. No merging happens here.

What it helps with

  • open a PR whose body comes from the spec state
  • preview a PR run without pushing or writing
  • refresh an existing open PR after the spec changes
  • open a draft PR while some items are still open
  • write run memory alongside the PR

Example prompts for the agent

  • Open a PR for spec SPEC-12
  • Make a draft PR for SPEC-7 based on main
  • Update the open PR from the spec and write run memory

How to install flow-next-make-pr

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-make-pr -a claude-code

3Manually: put the files in place

~/.claude/skills/flow-next-make-pr/SKILL.md

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

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about flow-next-make-pr

How do I install flow-next-make-pr in Claude Code?

Through the plugin marketplace: run /plugin marketplace add gmickel/flow-next, then /plugin install flow-next@flow-next. The skill ships with the flow-next plugin.

What does flow-next-make-pr do?

It opens a pull request with gh, and flowctl renders the briefing body from the spec state. Calling the skill is also the go-ahead for the push and the PR.

Can I use it in Claude Code?

Yes, install it there with npx skills add gmickel/flow-next --skill flow-next-make-pr -a codex.

Source text

SKILL.md · MIT
---
name: flow-next-make-pr
description: Open a PR with a cognitive-aid body rendered from flow-next spec state via gh. Use whenever asked to make or open a PR in a flow-next repo.
user-invocable: false
allowed-tools: Read, Bash, Grep, Glob, Write, Edit, Task
---
# /flow-next:make-pr

The host authors one grounded aid object; flowctl validates, stores and renders the briefing. Read
[workflow.md](workflow.md), then its reached references. No extra model call or hand-assembled sections.
Invocation authorizes push and PR creation; `--dry-run` previews without repository writes, push, PR edits
or memory writes.

Read [working-rules.md](../../references/working-rules.md) first unless you already have this run; it holds for every step of this skill.

Define `FLOWCTL` from `${CODEX_HOME:-$HOME/.codex}/scripts/flowctl`, then
`<plugin-root>/scripts/flowctl` (two levels above this SKILL.md), then `.flow/bin/flowctl`, choosing the first
executable. Never assume a global install. Parse `$ARGUMENTS`: the positional token is `SPEC_ID`; reject
unknown flags and missing base values. Carry these values between prompt turns:

| Argument | Variable / effect |
| --- | --- |
| `--draft`, `--ready` | `DRAFT_FORCE=draft|ready`; default `auto`; last wins, note conflicts |
| `--base <ref>` or `--base=<ref>` | `BASE_REF`; default empty |
| `--memory` | `WRITE_MEMORY=1`; default 0 |
| `--dry-run` | `DRY_RUN=1`; default 0 |
| `--update` | `UPDATE_MODE=1`; default 0; refresh an existing open PR |
| `mode:autonomous` or `FLOW_AUTONOMOUS=1` | `AUTONOMOUS=1`; default 0 |

**Ask the user via plain text.** Render the options below as a numbered list `1.` … `N.`, followed by a final option `N+1. Other — type your own answer`. Print the question, then the numbered list, then **stop and wait for the user's next message before continuing**. Parse the reply as: a bare number `1`–`N+1` → that option; the literal text of an option label → that option; free text after `Other` → custom answer.

Keep this skill inline so `plain-text numbered prompt` remains available. Ask only for missing information, with a
recommended option; use a numbered prompt if the tool is unavailable. `NEED_INPUT:` means ask
outside Bash and rerun with the answer. Autonomous gaps hard-error instead. PRs open ready unless `--draft` or open items (rules in
create-and-finalize); a branch without a spec takes workflow.md's no-spec path. Never merge here. Evidence, paths and requirement attribution must be grounded in the export
and receipts, with unknowns explicit rather than invented.

© Gordon Mickel · MIT · gmickel/flow-next

Similar skills

All skills for Git and GitHub →

flow-next-make-pr by other authors comes first.

flow-next-make-pr Gordon Mickel 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 make-pr prathamdby make-pr publishes committed changes and creates or updates a pull request. It fits workflows that need branch checks and a post-operation state check. CX Codex +1 721installs make-repo-contribution official github The make-repo-contribution skill checks repository rules before issues, branches, commits, or pull requests, then guides the contribution workflow. CX Codex +1 11,073installs make-pr-easy-to-review cursor The make-pr-easy-to-review skill prepares pull requests for review by cleaning noisy history, refining the PR description, and adding reviewer guidance without changing code behavior. CX Codex +1 3,400installs pr-flow modelcontextprotocol pr-flow walks a task from issue to pull request and closes it after merge: branch, DCO signoff, pre-push gate, Copilot review. CX Codex +1 ★ 92,149repo stars git-flow-manager davila7 git-flow-manager — a Claude subagent that creates Git Flow branches, merges them, tags releases and opens pull requests. Useful when the branching scheme is strict but nobody follows it by hand. CX Codex 3,127installs printing-press-publish mvanhorn The printing-press-publish skill for Claude Code publishes a generated CLI from a local library to printing-press-library. It opens or updates the related pull request. CX Codex +1 7,200installs

From the same set70

The whole set →
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 uninstall uninstall removes flow-next from your repository. It cleans docs markers and generates safe terminal commands for deleting project files. CX Codex +1 ★ 730repo stars refine refine is a Claude Code command that asks one focused round of questions about a spec, task, or file, or researches related documentation. CX Codex +1 ★ 730repo stars workflow-scout workflow-scout scans repository CI/CD configs, PR and issue templates, automated review bots, and release tooling for readiness checks. CX Codex ★ 730repo stars tooling-scout tooling-scout scans projects for linters, formatters, type checkers and hooks. It is invoked by /flow-next:prime and should not be called directly. CX Codex ★ 730repo stars

Project sponsors

Companies that keep this analytics open