sending-pull-request

Prepare branches, write PR titles and bodies, and publish GitHub pull requests with verified evidence.

Updated Aug 6, 2026
One-click install
npx skills add https://github.com/wkentaro/skills --skill sending-pull-request-wkentaro
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: sending-pull-request
Source: https://github.com/wkentaro/skills/tree/main/skills/in-progress/sending-pull-request
Command: npx skills add https://github.com/wkentaro/skills --skill sending-pull-request-wkentaro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing pull request descriptions and managing the PR lifecycle manually is error-prone: bodies recap what the diff already shows, branches end up misnamed, evidence screenshots get committed or lost, and PRs go ready before their evidence is verified. This Skill standardizes the entire send-for-review workflow from branch naming to readiness gating. ## Core Features & Use Cases - Conventional branch and title management: Moves work onto a <type>/<short-kebab-description> branch without losing commits, and writes Conventional Commit titles under 70 characters. - Necessity-tested PR bodies: Writes descriptions that lead with why the change exists, surface non-obvious decisions with safety resolutions, and cut anything the diff already explains. - Evidence workflow with readiness gating: Assesses screenshots, recordings, or before/after CLI text on every PR, delegates media capture to the before-and-after skill, verifies rendered results, and only marks the PR ready when evidence is verified or intentionally skipped. - Use Case: You finished a CLI bug fix on the default branch. The Skill moves the commits to a fix/count-output branch, drafts a concise PR body with labeled before/after command output, creates a draft PR via gh, verifies the evidence renders, and marks it ready. ## Quick Start Send my current work for review as a pull request with appropriate evidence.

Frequently Asked Questions about sending-pull-request

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

FAQPage Schema
How do I write a good pull request description?▼

Lead with why the change exists rather than what it does, since the diff already shows the what. Cut anything a reviewer can learn from a 30-second diff scan, and surface non-obvious decisions each with an explicit safety resolution. Keep mechanical changes to a few sentences.

How do I create a GitHub pull request from the command line?▼

Push your branch with tracking, then use the gh CLI to create a draft PR with a body file and assignee. This Skill creates drafts first, verifies evidence, and only marks the PR ready with gh pr ready once evidence is confirmed.

Should pull request descriptions include screenshots or recordings?▼

Include the smallest evidence that proves behavior beyond the diff: screenshots for appearance, recordings for interaction, or before/after text for CLI changes. If evidence adds nothing beyond the diff and tests, intentionally skip it rather than capturing artificial media.

What happens if a PR evidence upload fails partway through?▼

Fetch the PR body to see what actually landed, then retry only the missing attachments with gh pr edit --attach, preserving successful upload URLs. If recovery fails, leave the PR as a draft and report the URL, missing evidence, and blocker.

Can I use this to only draft PR copy without publishing?▼

Yes. A copy-only request returns the title and body text without touching the repository or forge. Supplied evidence is formatted directly and unverified evidence is marked pending, with no capture, upload, or branch changes.