pr-plain-english-rewrite

Rewrites verbose PR titles, bodies, and RFCs into plain engineer-readable prose.

Updated May 18, 2026
One-click install
npx skills add https://github.com/blalor/pi-dot-dev --skill pr-plain-english-rewrite-blalor
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-plain-english-rewrite
Source: https://github.com/blalor/pi-dot-dev/tree/main/agent/skills/pr-plain-english-rewrite
Command: npx skills add https://github.com/blalor/pi-dot-dev --skill pr-plain-english-rewrite-blalor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? PR descriptions often contain jargon, abstract architecture language, and unexplained local context that block reviewers from understanding what changes, what applies on merge, and what decisions remain. This Skill rewrites that content into concrete prose a reviewer can act on in 30 seconds. ## Core Features & Use Cases - Structured PR rewrite: Produces a conventional-commit-style title plus a body with Why, What changes, What applies on merge, non-goals, and reviewer focus sections. - Jargon translation: Replaces abstract phrases like "governance model" or "landing spot" with concrete statements naming files, resources, flags, and behaviors. - Risk callouts: Forces explicit bullets for migrations, dependency changes, permission changes, destructive operations, feature flags, and config default changes. - Use Case: You inherit a PR body full of phrases like "establishes a three-tier governance model." Run this Skill to get a rewrite that says exactly which Terraform resources merge, which are disabled, and what reviewers should verify. ## Quick Start Rewrite this PR title and body into plain English so a reviewer can tell what changes, what applies on merge, and what to check.

Frequently Asked Questions about pr-plain-english-rewrite

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

FAQPage Schema
How do I rewrite a confusing PR description for reviewers?▼

Provide the existing PR title, body, and diff summary, then apply the rewrite rules: state what changes, what applies on merge, and what reviewers should check. The output uses a structured body with Why, What changes, non-goals, and reviewer focus sections.

What makes a good PR title for code review?▼

A good PR title uses imperative mood like add, fix, or remove, names the changed thing rather than the internal journey, and follows the repo's convention such as type(scope): subject. Avoid vague titles like cleanup, improvements, or follow-up.

Can this rewrite PR comments and RFC summaries too?▼

Yes, the same rewrite rules apply to PR comments, RFC summaries, design docs, and internal notes. For paste-ready PR comments, the outer suggested-body wrapper is omitted while keeping the same plain-English content.

What risks must a PR description call out explicitly?▼

The rewrite requires explicit bullets for database migrations, new or changed dependencies, auth or permission changes, public API or schema changes, destructive operations, feature flag changes, and configuration default changes. These must not be buried in prose.

When should I not use plain-English PR rewriting?▼

Avoid it when the repo already uses specific terms as exact product or domain vocabulary, since cutting them would lose meaning. It also does not replace technical accuracy; necessary technical terms are kept and defined once rather than removed.