How does this skill improve my development workflow?

It streamlines PR creation with checklists and CLI command examples, reduces back-and-forth during code reviews by improving clarity, and ultimately helps get your code approved and merged faster.

What key capabilities does it provide?

It enforces structural rules like dependency callouts and screen recordings for UI changes, provides a tutorial-style format for validation steps, and defines clear anti-patterns, such as avoiding jargon and overly long descriptions.

What does the PR Description Writing skill do?

This skill guides you to write clear, concise, and user-centric pull request descriptions. It provides a structured process and a 'Voice Guide' focused on respecting reviewer time and making validation easy.

When should I use this skill?

You should use this skill every time you create or update a pull request using Claude. It's especially valuable for PRs with UI changes (which require screen recordings), complex logic, or dependencies on other PRs.

PR Description Writing

Name: PR Description Writing
Author: ooloth

byooloth

•

Collaboration Tools

Guides the creation of clear, concise, and user-centric pull request descriptions.

Standardizes the process of writing pull request descriptions to respect reviewer time and improve clarity. This skill provides a comprehensive voice guide, structural requirements, language rules, and common anti-patterns. It emphasizes a user-centric framing, showing changes through screen recordings, and providing practical, tutorial-style validation steps. Use this skill to ensure all pull requests are easy to understand, review, and validate, integrating seamlessly with existing project templates and the `gh` command-line tool.

Key Features

01Enforces structural requirements like dependency callouts and mandatory screen recordings for UI changes.

0217 GitHub stars

03Promotes a narrative, tutorial-style format for validation steps (e.g., 'Expect to see...').

04Provides a clear list of anti-patterns, such as avoiding technical jargon and overly long descriptions.

05Defines a 'Voice Guide' focused on user-centricity and respect for reviewer time.

06Includes a step-by-step workflow from gathering changes to creating a draft PR via CLI commands.

Use Cases

01Drafting a new pull request for a feature or bug fix.

02Updating the description of an existing pull request to improve clarity.

03Onboarding new developers to a team's pull request standards.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ooloth/dotfiles writing-pr-descriptions

For use in Claude.ai and ChatGPT

Download Skill