- Home
- Skills
- Technical Documentation
- bix-claude-skills: GitHub PR Description Generator
Works with the AI Agents you already use
bix-claude-skills: GitHub PR Description Generator
Reads a pull request diff, drafts a structured description, and pushes it to GitHub after you approve.
Free
bix-claude-skills: GitHub PR Description Generator
Example session with this skill installed
Run either commands
/github-pr-describe 214
or
Describe PR 214 and push the description when I approve it.
- Read your context and instructions
- Compiled the bix-claude-
I analyzed PR #214 (feature/saved-filters into main, 9 files, 412 lines of diff) and drafted a description. The existing body had one ticket link, which I kept at the top. Nothing has been pushed yet.
Tickets: SHOP-1187
TL;DR
| Area | Files | What Changed |
|---|---|---|
| Order list UI | OrderFilters.tsx, SavedFilterMenu.tsx | Save and reuse filter sets |
| API | filters.controller.ts, filters.service.ts | New saved filter endpoints |
| Database | 20241003_add_saved_filters.sql | New saved_filters table |
| Tests | filters.service.test.ts | Coverage for saved filters |
- Users can save the current order filters under a name and reapply them later.
- The API has new endpoints to list, create and delete saved filters.
- Fixed the date range filter dropping the last day.
Features
Saved filters on the order list - A new menu lets users save the current filters under a name and pick them again. This saves support staff from rebuilding the same filters each day.
- Saved filter endpoints - Added
GET,POSTandDELETE /api/filters. Each user only sees their own filters.
Bug Fixes
Date range ignored the last day - The end date was treated as midnight, so orders placed on that day were left out. It now includes the whole day.
Improvements
Order list UI
Filter bar stays on screen - The filter bar no longer scrolls away on long lists, so filters can be changed without scrolling back up.
Tests
Saved filter service tests - Added tests for creating, listing and deleting filters, and for blocking access to another user's filters.
Next steps
- Reply
Post to run gh pr edit 214 with this text, or
Edit with changes (for example "shorten the Features section").
- After posting, the skill prints the PR URL so you can check the result.
Connects securely to your tools. The creator never sees your data.
About this skill
What it does
- Fetches a PR's metadata and full diff with the
ghCLI. - Groups changes by area and drafts a description from a fixed template.
- Starts with a TL;DR table and 3 to 5 bullets, then adds only the sections that apply (Features, Bug Fixes, Improvements, Refactoring, Documentation, Tests, Dependencies, CI/CD).
- Keeps ticket and issue links from the existing PR body under a
**Tickets:**line. - Shows the full draft and waits for you to choose Post or Edit before touching GitHub.
Problems it solves
- Blank or one-line PR bodies that leave reviewers guessing.
- Long, jargon-heavy descriptions that take two reads to follow.
- Losing ticket links when a PR body is rewritten.
- Large diffs that are slow to summarize by hand.
How it works
- Validate the PR number (asks if missing) and gather metadata and diff as JSON. Stops if the diff is empty.
- Analyze the diff, skipping whitespace-only changes, and group changes by area. Diffs over 5,000 lines go to a sub-agent for a per-file summary.
- Draft the description from the template, with plain, short writing rules and no invented changes.
- Show the draft and ask: Post or Edit. Repeat edits until you approve.
- Run
gh pr editwith exactly the approved text and print the PR URL.
Why install it
- Free and open source (Apache-2.0).
- Consistent PR descriptions across a team.
- Nothing is pushed without your approval.
- Adds no AI attribution or footer to the description.
Requirements
- Claude Code,
ghCLI (authenticated),python3, and a git repo with a GitHub remote.
- Needs
ghinstalled and authenticated, and must run inside a repo with a GitHub remote. - Needs
python3(the script uses it to escape the diff as JSON). - Takes a PR number only. It does not accept URLs or branch names.
- Stops if the PR has no diff.
- Diffs over 5,000 lines are summarized by a sub-agent first, so fine detail may be lost.
- It replaces the whole PR body. Only ticket links found in the old body are carried over.
- The script was written for a Bash environment (macOS or Linux). Windows is not documented.
- The description is only as accurate as the diff. It does not run code or tests.
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
1 use
Times used to date
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 1 month ago
- Free with an Agensi account
Permissions
The skill needs `gh` to read the PR and, after your approval, to update its body. It does not change code, branches, commits, labels or reviews. It does not read credentials or secret files.