mcpField
P
pr-writing

pr-writing

github.com/darknesskillerDevelopment0113 installsUpdated 3w ago
Repository

About pr-writing

pr-writing is a skill for drafting pull request titles and bodies from a repository’s local context. It guides developers through profile selection, evidence-based claims, and applicable PR sections.

Key features

  1. 01Repository helper script
  2. 02Profile-aware PR drafts
  3. 03Ticket-based title rules
  4. 04Description and test sections
  5. 05Unknowns labeled, not invented

Use cases

  1. 01Drafting a PR from branch changes
  2. 02Preparing frontend PRs with screenshots
  3. 03Writing ticket-linked PR titles

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/darknesskiller/skills --skill pr-writing

After installing, type/pr-writingin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

agents/
openai.yaml
scripts/
pr_writer.py
test_cli.py

Details

From the project README

PR Writing

The helper script lives at scripts/pr_writer.py relative to this skill's directory (the harness resolves it). Run it from the user's repo with the script's absolute or skill-relative path:

python3 <skill-dir>/scripts/pr_writer.py

Steps

  1. Run helper or inspect branch. Done when source, target, commits, changed files known.
  2. Detect profile or accept --profile. Draft with Description, Test Plan, Test Result, Links. Add Screenshot only for frontend.
  3. Compose title. feat adds behavior, fix repairs, refactor restructures. Ticket in branch or commits: <feat|fix|refactor> [TICKET-123]: concise description. No ticket: <feat|fix|refactor> (feature-name): concise description.
  4. Every claim must be supported by local context. Unknowns labeled, not invented.

Completion: title follows the ticket rule, body has applicable headings, profile matches repo, unknowns labeled.

Commands

draft --repo-dir . [--target main] [--format toon] [--profile frontend]

Profiles

SignalProfile
React, Next, Vue, Nuxt, Svelte, Angular, Astro, Preact, React Nativefrontend
Flutter pubspec.yamlfrontend
Dart pubspec.yamldart
go.modgo
Nonegeneric

Comments

Markdown supported