prep-pr

Orchestrate TGD audits, documentation checks, roast cycles, and history cleanup for PR refinement.

Updated Feb 20, 2026
One-click install
npx skills add https://github.com/ChrisSteinbach/claude-skills --skill prep-pr
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: prep-pr
Source: https://github.com/ChrisSteinbach/claude-skills/tree/main/prep-pr
Command: npx skills add https://github.com/ChrisSteinbach/claude-skills --skill prep-pr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Iterative PR refinement orchestrates TGD audits, documentation checks, roast cycles, and history cleanup to converge a messy PR into a polished, ready-to-merge state.

Core Features & Use Cases

  • End-to-end PR refinement: performs staged audits (TGD, doc-update, roast) with safety backups and cycle-based execution.
  • Stateful collaboration: persists progress in .prep-pr/state.json and uses a safety branch to protect work.
  • Deterministic sub-agent orchestration: coordinates /tgd-audit, /doc-update, /roast, and /decompose via an Agent tool workflow.

Quick Start

Run the prep-pr workflow on the current feature branch to perform automated TGD audit, doc-update, roast, and history cleanup until convergence.

Frequently Asked Questions about prep-pr

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

FAQPage Schema
How do I automate pull request refinement for complex commits with multiple fixes?▼

Automated pull request refinement orchestrates TGD audits, documentation checks, roast cycles, and history cleanup to converge complex PRs into a polished, ready-to-merge state through iterative cycles.

What is the best way to run automated audits and roast cycles on a messy PR?▼

Running automated audits and roast cycles requires a phase-driven workflow with sub-agent orchestration that coordinates /tgd-audit, /doc-update, and /roast commands while enforcing batch validation after every agent run.

How does state tracking work during iterative PR history cleanup?▼

Iterative PR history cleanup persists progress and cycle state in a .prep-pr/state.json file, using a dedicated safety branch to protect work and ensure accurate state tracking across multiple refinement cycles.

Can I use sub-agent orchestration to decompose and restory a complex pull request?▼

Sub-agent orchestration coordinates /decompose and /restory commands to break down and reconstruct PR history, running deterministically within an Agent tool workflow to ensure safe and accurate history cleanup.

When do I need automated PR triage with safety backups for my workflow?▼

Automated PR triage with safety backups is needed for complex PRs requiring iterative cycles of audits and approvals, ensuring work is protected on a safety branch while converging into a polished state.