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.