review-readiness

Check PR merge readiness against per-branch review and CI evidence.

12.6k|1.5k|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/nearai/ironclaw --skill review-readiness-nearai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-readiness
Source: https://github.com/nearai/ironclaw/tree/main/skills/review-readiness
Command: npx skills add https://github.com/nearai/ironclaw --skill review-readiness-nearai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents premature merges by giving a clear, evidence-based dashboard for whether required reviews (code, tests, security, QA, linting) are complete for each PR branch.

Core Features & Use Cases

  • PR readiness tracking per branch: Maintains a per-branch readiness record in projects/<owner>-<repo>/readiness/<branch-slug>.md.
  • Merge gating with explicit verdicts: Produces READY / ALMOST READY / NOT READY / BLOCKED based on checklist completion, CI status, and unresolved findings.
  • Evidence logging and guidance: Captures review results, scores, and missing items, and tells users what to run next (for example security review or QA review).

Quick Start

Ask whether the pull request is ready to merge and the assistant will load or create the readiness dashboard for that branch, then report the verdict and any missing reviews.

Frequently Asked Questions about review-readiness

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check if a PR is ready to merge based on CI status and code review evidence?

PR merge readiness is checked by evaluating completed reviews and CI status against a per-branch readiness record. The system loads or creates a readiness dashboard for the branch and reports a merge verdict along with any missing reviews.

What is the best way to track QA and security review checklists for a pull request?

Tracking QA and security review checklists involves maintaining a per-branch readiness file that captures review results, scores, and unresolved findings. This record updates checklist statuses dynamically based on review outcomes and CI state.

How does merge gating work for engineering processes with multiple required reviews?

Merge gating applies explicit verdicts to pull requests by checking checklist completion, CI status, and unresolved findings. It produces statuses like READY, ALMOST READY, NOT READY, or BLOCKED to prevent premature merges.

Can I generate a morning brief that includes PR merge readiness notes for my team?

Morning brief readiness notes are generated by reading the per-branch readiness record and presenting a structured readiness dashboard. This dashboard provides the current merge verdict and highlights any missing code, security, or QA reviews.

How do I know which missing code review or security review is blocking my PR from merging?

Missing reviews blocking a merge are identified by evaluating the per-branch readiness checklist against completed CI evidence. The dashboard captures missing items and provides guidance on what to run next, such as a security or QA review.

Does PR readiness tracking require any external dependencies or continuous integration tools?

PR readiness tracking does not require external dependencies. It operates by reading or creating readiness files within the project directory and updating checklist statuses based on the CI state and review outcomes you provide.