Skip to main content

flow-next-make-pr

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.

Source facts

Repository
gmickel/flow-next
Last source activity
October 25, 2026 at 19:25
Detected SKILL.md language
English
Stars
713
Forks
62

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer
9 files

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
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.
View on GitHub