Does this skill require the GitHub CLI?

Yes, this skill utilizes the GitHub CLI (gh) to fetch PR metadata, view diffs, and update the pull request description directly from the command line.

Can I use my own PR template?

The skill is designed to read a standard template from a specific path ({SKILLBASE}/references/pr_description_template.md), allowing you to maintain consistency across your project.

How does it handle plan deviations?

The skill looks for plan files in your task directory and uses a specialized implementation-reviewer agent to compare the actual code changes against the intended plan, highlighting any discrepancies.

Does it support project management tools like Linear?

Yes, it can automatically extract ticket IDs from branch names and fetch corresponding Linear ticket URLs to include in the PR header.

Automated PR Description Generator

Name: Automated PR Description Generator
Author: mshuffett

bymshuffett

0•

Collaboration Tools

Generates comprehensive, template-based pull request descriptions by analyzing code diffs and implementation plans.

This skill automates the process of writing detailed pull request descriptions by integrating directly with GitHub and project management tools. It performs deep analysis of code changes, identifies deviations from original implementation plans using a specialized reviewer agent, and generates rich markdown documentation complete with permalinks and verification steps. Designed for teams using structured task directories, it ensures every PR is informative, consistent, and context-aware without requiring manual user input.

Key Features

01Automated deviation analysis between implementation and original plan files

02Linear ticket integration for seamless project tracking and linking

03Deep diff analysis with rich file-level and line-level permalinks

040 GitHub stars

05Automated GitHub PR body updates via GitHub CLI integration

06Enforcement of standardized documentation templates across the repository

Use Cases

01Generating detailed documentation for complex feature branches automatically

02Auditing code changes against pre-defined plans before submission

03Standardizing PR quality and consistency across a distributed development team

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mshuffett/dotfiles describe-pr

For use in Claude.ai and ChatGPT

Download Skill