- Home
- Skills
- Code Quality & Review
- pr description
pr description
Automate PR descriptions with git diff analysis and platform-specific What/Why/Changes formatting.
$1
Works with the AI Agents you already use
pr description
Example session with this skill installed
Write a PR description for my current branch 'feature/auth-fix' merging into 'main'. It's for GitHub.
- Read your context and instructions
- Compiled the pr description
I have analyzed the changes between main and feature/auth-fix. The PR description has been written to PR_DESCRIPTION.md.
PR_DESCRIPTION.md
Fix session timeout logic in auth middleware
What
This PR corrects a race condition in the authentication middleware that caused sessions to expire prematurely during high-latency requests.
Why
Users were being intermittently logged out when the API response time exceeded 500ms, as the session validator was not awaiting the token refresh pulse. This ensures session persistence across all valid request durations.
Changes
- middleware/auth.ts: Added
awaitto thevalidateSessioncall within the request pipeline. - services/session.ts: Increased the default timeout buffer from 100ms to 1000ms.
- tests/auth.test.ts: Added a new integration test simulating high-latency network conditions.
- Closes #402
Next steps
- Open
PR_DESCRIPTION.mdto review the generated content. - Copy the title below into your GitHub PR title field.
- Paste the content of the file into the PR description box.
Fix session timeout logic in auth middleware
Connects securely to your tools. The creator never sees your data.
About this skill
Writing pull request descriptions is a tedious manual task that often results in vague summaries or inconsistent formatting. This skill automates the analysis of your local or remote branches to produce structured, platform-specific descriptions. It eliminates the guesswork of what changed and why, ensuring every PR follows a professional What/Why/Changes schema.
What it does
- Branch discovery scans your repository for current, local, and remote branches to provide accurate selection options.
- Diff analysis executes
git diffandgit logbetween selected branches to extract the exact scope of work. - Platform formatting tailors the output for GitHub or GitLab, including correct issue linking syntax and terminology.
- Structured output generates a standardized Markdown file containing a concise title and sections for What, Why, and Changes.
- Automatic linking detects issue numbers in branch names or commit messages to include "Closes #123" references automatically.
How it works
- Selection: The agent scans your repo and asks you to select the platform, source branch, and destination branch via multiple-choice.
- Analysis: It runs
git diffwith noise-reduction flags andgit logto parse every modification, addition, and deletion. - Generation: The agent writes the finalized description to a local
PR_DESCRIPTION.mdfile at your repository root. - Finalization: It provides a concise PR title in the imperative mood for easy copy-pasting into your VCS UI.
Frameworks & tools
This skill requires a git environment. It works with any repository hosted on GitHub or GitLab and supports common branch naming conventions like main, develop, and stage.
Why this beats prompting it yourself
Generic prompts often hallucinate changes or miss deleted files in large diffs. This skill uses specific git flags to ignore line-ending noise and enforces a consistent What/Why/Changes structure that remains uniform across your entire team.
Use cases
- Summarizing a complex feature branch with dozens of commits into a readable executive summary.
- Ensuring every PR in a corporate repository meets documentation standards without manual effort.
- Automatically linking relevant Jira or GitHub issues found in your commit history.
- Distinguishing between GitHub and GitLab syntax when working across different client organizations.
Known limitations
Requires a local git repository to function. Does not automatically commit the generated Markdown file or push the PR to the remote server.
Requires local git environment. Does not execute the actual PR creation or commit the description file.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 20 days ago
Requires