pr-ready

SkillDev tools

Run a pre-PR readiness check and report READY or NOT READY.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the pr-ready skill

What this skill tells your AI

The instructions your AI receives, as published by flowexec/flow in .claude/skills/pr-ready/SKILL.md and read by ahel’s review.

Check whether the current branch is ready to open a PR. Work through each item and report PASS or FAIL:

  1. No focus markersgrep -rn "FDescribe\|FIt\|FEntry\|FContext\|FWhen" --include="*.go" . Any match is a FAIL — these silently exclude all other tests in the suite.

  2. Validation passes — run the validate executable via mcp__flow__execute (ref: validate). All steps must pass. Use mcp__flow__run_command for the git/grep checks below so they land in flow's history alongside it.

  3. No debug artifacts — grep for fmt.Println, spew.Dump in cmd/, internal/, pkg/. Flag anything that looks like leftover debug output (not legitimate logging).

  4. Commit message formatgit log main..HEAD --oneline. Each commit should be: imperative, lowercase, ≤72 chars (fix: ..., feat: ..., refactor: ...).

  5. No direct edits to generated filesgit diff main...HEAD --name-only should not show changes to types/**/*.go, docs/cli/*.md, or docs/types/*.md in isolation (without a corresponding schema change).

After all checks: report overall READY or NOT READY with a concise summary of what needs fixing. Do not open a PR automatically — let the user decide.

Signals

GitHub stars
136
Forks
4
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
pr-ready
Source
github.com/flowexec/flow