skills.rest
FrogAi
FrogAiCOMMUNITY
Explore all skills by this author →
GitHub

pr-description-writer

Generate PR descriptions from live templates, commits, diffs, and linked tickets.

1|Updated Apr 16, 2026
Search Tags:#pr#description#redaction#ci#diff-analysis#template-detection#ticket-references
One-click install
npx skills add https://github.com/FrogAi/Xenopus --skill pr-description-writer-frogai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pr-description-writer
Source: https://github.com/FrogAi/Xenopus/tree/main/Gemini/Skills/Gemini%203.1%20Pro/pr-description-writer
Command: npx skills add https://github.com/FrogAi/Xenopus --skill pr-description-writer-frogai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Production-grade PR/MR description generator. It reads the repository's active PR template, analyzes every commit, file diff, linked ticket, and CI run, and then produces a description that matches project conventions and reflects the actual changes. It enforces a chain-of-verification and redacts secrets before output.

Core Features & Use Cases

  • Live template detection across supported platforms (GitHub, GitLab, Bitbucket, Azure DevOps) and selection when multiple templates exist.
  • Live commit-style detection to mirror the repo's preferred messaging style.
  • Diff-grounded assertions: every claim is traceable to a specific file/diff hunks or a commit message.
  • Secret redaction as a hard gate to prevent leakage of credentials or keys.
  • Exhaustive coverage of changes: commits, files, diffs, and linked tickets are cited with provenance.
  • Contextual reviewers and CODEOWNERS grounding to surface appropriate reviewers.
  • Supports multiple PR conventions and surfaces breaking-change signals when corroborated.

Quick Start

Draft the PR description before running the PR creation command, and the skill will generate a context-grounded body that matches the detected template.

Frequently Asked Questions about pr-description-writer

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

FAQPage Schema
How do I generate a PR description from a git diff that matches my repository conventions?▼

To generate a PR description from a git diff, the skill detects your repository's live PR template and commit style, then drafts context-grounded text based on actual file changes and linked tickets. It analyzes all commits and diffs to ensure the generated content matches project conventions perfectly.

Does the PR description writer work with GitLab and Bitbucket templates?▼

Yes, the PR description writer works with GitLab and Bitbucket templates, alongside GitHub and Azure DevOps. It performs live template detection across these supported platforms and automatically selects the appropriate format when multiple templates exist in your repository.

Can I automatically redact secrets and credentials in generated pull request descriptions?▼

You can automatically redact secrets and credentials in generated pull request descriptions because the skill enforces secret redaction as a hard gate. It scans the analyzed diffs and commit messages to prevent the leakage of credentials or keys before outputting the final PR text.

How are claims in an automated PR description traced to specific code changes?▼

Claims in an automated PR description are traced to specific code changes through diff-grounded assertions that cite provenance. The skill analyzes every commit, file diff, and linked ticket, ensuring every claim made in the output is directly traceable to a specific file, diff hunk, or ticket reference.

What is the best way to draft PR descriptions that include CI run results and linked issues?▼

The best way to draft PR descriptions with CI run results and linked issues is to use an automated generator that grounds text in actual changes. This skill analyzes your CI runs, linked tickets, and commit history to produce a matching description, surfacing reviewer-relevant context and breaking-change signals.

Does the PR description generator suggest codeowners and appropriate reviewers for the pull request?▼

Yes, the PR description generator suggests appropriate reviewers by grounding its output in your contextual CODEOWNERS file. It analyzes the modified file diffs and surfaces the relevant codeowners directly within the generated PR description to streamline the review process.

Related Skills

Explore More Software Engineering Skills→
kzytateishikzytateishi
5

pr-summary

Generate PR descriptions from Git history and templates.

Community
Advanced
adbertramadbertram

prowler-pr

Create and review Prowler pull requests with gh CLI and CI workflow validation.

Community
Intermediate
DevelopersGlobalDevelopersGlobal
65

ci-cd-pipelines

Automate CI/CD pipelines with quality gates and deployment processes.

Official
Advanced
guan404mingguan404ming
1

dev-pr-summarize

Generate a structured PR changelog from branch commits and diffs.

Community
Intermediate