Agent skill

PR Body Drafter

by Yeachan-Heo in Yeachan-Heo/oh-my-claudecode

Drafts a pull request body from the session's paper trail: a one-line claim with the smallest proving visual, verify evidence, a reversibility note and glossary terms.

MITAuto-check passedDevelopment

Install PR Body Drafter

skills CLI
$ npx skills add Yeachan-Heo/oh-my-claudecode --skill pr -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Yeachan-Heo/oh-my-claudecode pr --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Yeachan-Heo/oh-my-claudecode.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pr .claude/skills/pr && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
pr
GitHub stars
40k
Token cost
~773 tokens
SKILL.md length
373 words
Files
1
Skills in repo
47
Repo updated
First seen
Licence
MIT

At a glance

Drafts a pull request body from the session's paper trail: a one-line claim with the smallest proving visual, verify evidence, a reversibility note and glossary terms.

  • Opening a pull request once the work has been verified
  • SKILL.md covers Template, Sections, Triggers and Output
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Updating a PR description after a material change

What it does

This skill assembles the PR body that a reviewer outside the session will read, using only material already established earlier. The Summary states the change in one sentence and adds the smallest fitting visual: pseudocode for logic, a call tree for control flow, a component tree for UI, a shallow file tree for refactors, a Mermaid diagram for data flow, or a diff shaped like the change.

The Evidence section reuses output from the verify protocol (build, test, lint and functionality checks) as before and after pairs, prefers a screenshot for visual changes, and never re-collects or invents evidence. The Reversibility section runs the diff through three ADR questions: hard to reverse, surprising without context, a real trade-off. It then names the rollback method and ends with the blast radius. The result is a paste-ready body plus pointers to the evidence, ADRs and spec it relies on.

When your agent uses it

  • Opening a pull request once the work has been verified
  • Updating a PR description after a material change
  • Writing a PR description that explains how to roll the change back

Example prompts

  • “Draft the PR body for the checkout refactor using the verify results.”
  • “Write a PR description with a component tree for the new settings page.”
  • “Add a reversibility section saying whether reverting the merge is enough to undo this change.”

Requirements

  • Verify-protocol output (build, test and lint evidence) from the session
  • A CONTEXT.md glossary (optional)

What it can do on your machine

Read from SKILL.md and the folder at commit 454bae0. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

PR Body Drafter loads about 773 tokens when it runs. Until then it costs about 57 tokens; SKILL.md has 373 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~57
When it runs · the whole SKILL.md, loaded when a task matches
~773

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Yeachan-Heo/oh-my-claudecode at commit 454bae0, republished under its MIT licence (© Yeachan-Heo). 373 words, ~773 tokens.

Download SKILL.mdSave it as .claude/skills/pr/SKILL.md (or your agent's skills folder).
name
pr
description
Draft a PR body from OMC's paper trail — the smallest visual that proves the change, evidence consumed from the verify protocol (never re-collected), reversibility from the ADR test on the diff, glossary language throughout.

PR Body

When work lands behind a review, the PR body is the one artifact a reviewer outside the session reads. Everything it needs already exists in the paper trail — this skill assembles it and adds nothing that was not already established. The summary-visual discipline is inspired by show-me (credited in the frontmatter).

Template

markdown
## Summary
<one-line claim, then the smallest visual that proves it>

## Evidence
- **Before:** <output / failing check>
  **After:** <output / passing check>

## Reversibility
<Rollback: cheap via <mechanism> | expensive because <reason>>
<Blast radius: one line>

Sections

Summary

State the change in one sentence, then show the smallest view that makes the point. Match the visual to the change:

  • logic or an algorithm → pseudocode
  • runtime control flow → a call tree
  • UI structure → a component tree
  • file responsibility or a broad refactor → a shallow file tree
  • component interaction or data flow → a Mermaid diagram
  • the delta itself → a diff shaped like the change (component, layout, call tree, or state machine)

Show the whole block only when most of it is new, omitted context would hide ownership, or the reviewer needs a copyable target shape. One visual usually suffices; never all forms.

Evidence

Consume the verify protocol's output — BUILD, TEST, LINT, FUNCTIONALITY evidence, freshness rule inherited. Present before/after pairs: the exact check that failed before and passes after, quoted from the output itself. When the change is visual, prefer a captured screenshot; qa-tester can drive the runtime for one. Never re-collect evidence here and never claim evidence the verify pass did not produce.

Show full SKILL.md (154 more words)Show less
Reversibility

Run the ADR test on the diff itself — the same three questions launch applies to decisions: hard to reverse? surprising without context? the result of a real trade-off? A no on all three is a cheap rollback: say by what mechanism (revert the merge, toggle the flag). Any yes means an expensive rollback: say why. Link the ADR when the change implements or touches one. Close with the blast radius in one line — what else this change can move.

Language

Terms come from CONTEXT.md where a glossary exists. The PR is read outside the session; the glossary is the only vocabulary the reader shares with it.

Triggers

  • launch Phase 5, when the platform reviews through PRs: the completion report carries a PR body drafted by this skill.
  • Any session that opens or materially updates a PR.

Output

  • The PR body, ready to paste
  • The paper-trail pointers it relies on (verify evidence, ADRs, spec)

© Yeachan-Heo, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/pr of Yeachan-Heo/oh-my-claudecode.

Open the folder on GitHubat commit 454bae0

Compare with similar skills

PR Body Drafter next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

PR Body Drafter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
PR Body Drafter this skillYeachan-Heo/oh-my-claudecode40k—~773Automated safety check: PassMIT
Create PRSmana/cloud-native-ref103—~1.2kAutomated safety check: PassApache-2.0
PR Design DocOpenHands/OpenHands90k—~2.4kAutomated safety check: PassMIT
Design Doc MermaidSpillwaveSolutions/design-doc-mermaid1761 repos~5.6kAutomated safety check: PassNone
Eli5coldteadotai/pr-lens1.9k—~2.3kAutomated safety check: PassMIT
PR Lenscoldteadotai/pr-lens1.9k—~398Automated safety check: PassMIT

Similar skills

  • Create PR

    Smana/cloud-native-ref

    Create or update a Pull Request with AI-generated description, mermaid diagram, file walkthrough, and automatic design-doc detection.

    103 GitHub stars~1.2k tokensUpdated today
    DevelopmentAuto-check passed
  • PR Design Doc

    OpenHands/OpenHands

    For a non-trivial pull request, write a self-contained HTML design doc under the temporary .pr/ directory and link a visibility-appropriate preview in the PR description, so maintainers grasp the…

    90k GitHub stars~2.4k tokensUpdated today
    DevelopmentAuto-check passed
  • Design Doc Mermaid

    SpillwaveSolutions/design-doc-mermaid

    Create Mermaid diagrams (flowchart, sequence, class, ER, state, C4, architecture) from text or source code.

    176 GitHub starsUsed in 1 repo~5.6k tokens
    DevelopmentAuto-check passed
  • Eli5

    coldteadotai/pr-lens

    WHAT: Explains a codebase, a folder, a feature, a command or a pull request to someone who knows nothing about it, as a PR Lens canvas whose walkthrough builds the picture one part at a time.

    1.9k GitHub stars~2.3k tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • PR Lens

    coldteadotai/pr-lens

    WHAT: Draws a code change or part of a codebase as an animated architecture or data-flow diagram, on its own or in a pull request.

    1.9k GitHub stars~398 tokensUpdated 5 days ago
    DevelopmentAuto-check passed
  • Open PR

    Kiln-AI/Kiln

    Open a pull request on the Kiln repo for a human to complete.

    5.2k GitHub stars~6.1k tokensUpdated today
    DevelopmentAuto-check passed

More from Yeachan-Heo/oh-my-claudecode

All 47 skills in this repo
  • Ask Advisor Routing

    Yeachan-Heo/oh-my-claudecode

    Sends a question or task to another locally installed agent CLI, such as Codex or Gemini, through omc ask and saves the answer as a file.

    40k GitHub stars~572 tokensUpdated yesterday
    Auto-check passed
  • Ask Navigator

    Yeachan-Heo/oh-my-claudecode

    Charts a foggy effort into a map of decision tickets on the repo's issue tracker and works through them one per session, producing decisions rather than deliverables.

    40k GitHub stars~4.1k tokensUpdated yesterday
    Auto-check passed
  • Self-Improve Evolutionary Loop

    Yeachan-Heo/oh-my-claudecode

    Runs an autonomous improvement loop on a repository: agents propose and execute plans, a tournament picks the winner by benchmark, and each round is recorded and plotted.

    40k GitHub stars~5.3k tokensUpdated yesterday
    Auto-check: warnings
  • Autopilot

    Yeachan-Heo/oh-my-claudecode

    Takes a short product idea through requirements, design, planning, parallel implementation, QA cycles and multi-reviewer validation to produce working code.

    40k GitHub stars~4.4k tokensUpdated yesterday
    Auto-check passed
  • OMC Mode Cancellation

    Yeachan-Heo/oh-my-claudecode

    Detects and gracefully cancels whichever OMC mode, autopilot, ralph, swarm, pipeline, or team, is currently active, then clears its state.

    40k GitHub stars~4.6k tokensUpdated yesterday
    Auto-check passed
  • Hierarchical AGENTS.md Generator

    Yeachan-Heo/oh-my-claudecode

    Maps a codebase directory by directory and writes linked AGENTS.md files, each pointing to its parent, to document what each area contains.

    40k GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed

Works with

Categories

Questions about PR Body Drafter

What does PR Body Drafter do?

Drafts a pull request body from the session's paper trail: a one-line claim with the smallest proving visual, verify evidence, a reversibility note and glossary terms. This skill assembles the PR body that a reviewer outside the session will read, using only material already established earlier. The Summary states the change in one sentence and adds the smallest fitting visual: pseudocode for logic, a call tree for control flow, a component tree for UI, a shallow file tree for refactors, a Mermaid diagram for data flow, or a diff shaped like the change.

When should I use PR Body Drafter?

PR Body Drafter fits situations like: opening a pull request once the work has been verified; updating a PR description after a material change; writing a PR description that explains how to roll the change back.

How do I install PR Body Drafter in Claude Code?

Run `npx skills add Yeachan-Heo/oh-my-claudecode --skill pr -a claude-code`. Or copy the skill folder (skills/pr in Yeachan-Heo/oh-my-claudecode) into .claude/skills/pr in your project. Claude Code loads it when a task matches its description.

How do I install PR Body Drafter in Codex?

Run `npx skills add Yeachan-Heo/oh-my-claudecode --skill pr -a codex`. Or copy the skill folder (skills/pr in Yeachan-Heo/oh-my-claudecode) into .agents/skills/pr in your project. Codex loads it when a task matches its description.

Can I use PR Body Drafter in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Yeachan-Heo/oh-my-claudecode --skill pr -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pr, .gemini/skills/pr, .github/skills/pr and .opencode/skills/pr in your project.

What does PR Body Drafter need to run?

SKILL.md names no scripts, command-line tools or credentials: PR Body Drafter is instructions for the agent only. Our summary lists: Verify-protocol output (build, test and lint evidence) from the session; A CONTEXT.md glossary (optional).

Does PR Body Drafter access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is PR Body Drafter safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does PR Body Drafter use?

PR Body Drafter is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does PR Body Drafter use?

About 773 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to PR Body Drafter?

Skills that share tags, products or a category with PR Body Drafter: Create PR (Smana/cloud-native-ref, 103 stars), PR Design Doc (OpenHands/OpenHands, 90k stars), Design Doc Mermaid (SpillwaveSolutions/design-doc-mermaid, 176 stars) and Eli5 (coldteadotai/pr-lens, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains PR Body Drafter?

Yeachan-Heo (a GitHub user) maintains it in Yeachan-Heo/oh-my-claudecode, which has 39,720 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on October 8, 2026.

Source: Yeachan-Heo/oh-my-claudecode on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.