ready-for-review

Runs quality gates, review loops, and PR handoff for completed branches.

10|Updated May 12, 2026
One-click install
npx skills add https://github.com/sandsower/beislid --skill ready-for-review-sandsower
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ready-for-review
Source: https://github.com/sandsower/beislid/tree/main/skills/ready-for-review
Command: npx skills add https://github.com/sandsower/beislid --skill ready-for-review-sandsower

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finishing a coding task involves many error-prone steps: running quality gates, checking branch freshness, reviewing the diff, and creating a pull request. This Skill orchestrates that entire finalization workflow so nothing is skipped and every side effect requires explicit approval. ## Core Features & Use Cases - Phased PR handoff pipeline: Detects ticket and branch state, runs configured quality gates with proof tracking, performs code review with severity-based finding handling, and creates the PR only after explicit title/body approval. - Fast-path and existing-PR modes: Small low-risk diffs get parallel-safe gates and combined review; branches with an existing PR skip review and submission phases entirely. - Policy-gated side effects: Every push, PR creation, autofix commit, and label change passes through an action-policy check with user approval gates, plus optional run-ledger and session-memory recording. - Use Case: After finishing a feature branch, ask the agent to prepare it for review; it merges a stale base if needed, runs tests and lint gates, reviews the full diff, drafts the PR title and body, and creates the PR only after you approve. ## Quick Start Ask the agent to run ready-for-review on my current branch so it runs the gates, reviews the diff, and prepares the pull request for my approval.

Frequently Asked Questions about ready-for-review

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

FAQPage Schema
How do I prepare a branch for pull request review with an AI agent?▼

Invoke the ready-for-review skill on your feature branch. It detects the ticket and base branch, runs configured quality gates, reviews the full diff, drafts the PR title and body, and creates the PR only after your explicit approval.

What happens when a pull request already exists for my branch?▼

The skill enters existing-PR fast path: it runs the quality gates, pushes updates, applies any required reviewer opt-in label, and reports the PR URL. It skips the review and submission phases entirely.

Does ready-for-review work without a workflow.md config file?▼

No. The skill hard-fails if .beislid/workflow.md is missing or has an unsupported version marker. You must run the setup flow first to create a valid v1 workflow configuration.

Can the skill push code or create a PR without my approval?▼

No. All side effects including pushes, PR creation, autofix commits, and label changes pass through an action-policy check and require explicit user approval unless a workflow approval gate is explicitly set to auto.

When should I not use the ready-for-review skill?▼

Do not use it for mid-implementation commits, experimental branches without tickets, or unfinished work. It is designed only for work that is complete and ready for PR review handoff.