More screenshots

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIMuseMuseDotsDots+21 more

    pr Release Workflow

    2

    Write PR descriptions that reviewers actually read, generate release notes from merged PRs (not memory), maintain a changelog that stays in sync, and apply semantic versioning consistently.

    Free

    3 uses5.0 (1 review)
    pr-release-workflow

    pr-release-workflow

    Example session with this skill installed

    Write a PR description for my payment retry branch.

    • Read your context and instructions
    • Compiled the pr-release-workflow
    ## What
    Retries failed webhook deliveries up to 3 times with exponential backoff instead of dropping them after the first failure.
    
    ## Why
    Closes #482. Customers reported missed fulfillment events when Stripe's webhook endpoint briefly returned 502s (~0.4% of deliveries over the last 30 days).
    
    ## How
    - Adds `retryWebhook()` with backoff 1s → 4s → 16s and jitter
    - Marks delivery `failed` only after the 3rd attempt returns non-2xx
    - Persists attempt count on `webhook_deliveries.attempts` for observability
    
    ## Testing
    - [x] Unit: backoff sequence, jitter bounds, non-2xx classification (429 treated as retryable)
    - [x] Integration: simulated 502-then-200 sequence delivers exactly once
    - [ ] Manual: staged run against Stripe test-mode events
    
    ## Evidence
    Before: 99.6% delivery success (last 30d, staging logs)
    After (chaos test, 100 forced 502s):
    

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Write PR descriptions that reviewers actually read, generate release notes from merged PRs (not memory), maintain a changelog that stays in sync, and apply semantic versioning consistently.

    The Problem**

    Your PR description says "fix bug in payment flow." Your release notes say "misc updates and improvements." Your CHANGELOG.md hasn't been updated since v0.8.3. Your team decides version numbers by gut feeling — "this feels like a minor" — and occasionally ships a "patch" that breaks the API. The root cause: writing the PR description, release notes, changelog entry, and version number as separate, disconnected tasks means they're never consistent. The PR is written at PR time (vague), the release notes are written at release time (from memory), and the changelog is written never.

    What You Get

    • PR description template — structured format with What/Why/How/Testing/Evidence/Checklist sections, enforced Conventional Commits title convention (feat(scope): imperative summary), and anti-pattern detection ("Update files per review comments" flagged as unhelpful)
    • Release notes from PR data — gathers merged PRs via gh pr list, groups by impact (Highlights → Features → Bug Fixes → Breaking Changes), rewrites commit messages into user-facing sentences, and links every entry to its PR number
    • Changelog integration — maintains CHANGELOG.md in Keep a Changelog format with [Unreleased] section that PRs add to during development, then rename to version+date at release time, with fixed vocabulary (Added/Changed/Deprecated/Removed/Fixed/Security)
    • Semantic versioning decisions — reads the merged PR list and applies the rule: breaking change → MAJOR, new feature → MINOR, bug fix/perf → PATCH, with explicit reasoning documented next to the tag
    • Release checklist — 7-point verification: CI green on main AND release commit, version bumped everywhere (with grep for stragglers), CHANGELOG entry present with real date, no leftover [Unreleased] content, tag points at correct commit, docs updated, migration notes present for breaking changes

    Why This Beats Prompting It Yourself

    When you ask an agent to "write release notes," it guesses what was in the release based on commit messages — inventing features that were cut, missing breaking changes, and using developer jargon instead of user-facing language. This skill enforces a ground-truth workflow: gather PR data from GitHub (gh pr list --state merged), cross-check against git log, rewrite into impact statements, and link every entry to a real PR number. Release notes are never written from memory — they're derived from the actual merged PRs.

    Example Session

    You: Write a PR description for my payment retry branch.

    Agent:

    ## What
    Retries failed webhook deliveries up to 3 times with exponential backoff instead of dropping them after the first failure.
    
    ## Why
    Closes #482. Customers reported missed fulfillment events when Stripe's webhook endpoint briefly returned 502s (~0.4% of deliveries over the last 30 days).
    
    ## How
    - Adds `retryWebhook()` with backoff 1s → 4s → 16s and jitter
    - Marks delivery `failed` only after the 3rd attempt returns non-2xx
    - Persists attempt count on `webhook_deliveries.attempts` for observability
    
    ## Testing
    - [x] Unit: backoff sequence, jitter bounds, non-2xx classification (429 treated as retryable)
    - [x] Integration: simulated 502-then-200 sequence delivers exactly once
    - [ ] Manual: staged run against Stripe test-mode events
    
    ## Evidence
    Before: 99.6% delivery success (last 30d, staging logs)
    After (chaos test, 100 forced 502s): 100% success, p95 delivery latency +2.1s on retried events
    

    Use Cases

    • Writing PR descriptions for a team that uses AI agents to generate most of the code
    • Generating release notes for a monthly release from 15+ merged PRs
    • Maintaining a CHANGELOG.md that stays in sync with actual releases
    • Deciding the next version number based on what actually shipped (not gut feeling)
    • Running a release checklist that catches the 7 most common pre-release mistakes

    Known Limitations

    The workflow assumes Conventional Commits convention for PR titles — if the team doesn't use it, the release notes grouping (Features/Bug Fixes/Breaking Changes) won't work correctly. Pre-1.0 projects need an explicit versioning policy documented in the changelog header to avoid surprises. The release checklist requires gh CLI and GitHub repository access for PR data gathering.


    Tags: git github releases changelog semver conventional-commits developer-experience

    Version: 1.0.0

    The workflow assumes Conventional Commits convention for PR titles — if the team doesn't use it, the release notes grouping (Features/Bug Fixes/Breaking Changes) won't work correctly. Pre-1.0 projects need an explicit versioning policy documented in the changelog header to avoid surprises. The release checklist requires gh CLI and GitHub repository access for PR data gathering. --- Tags: `gi

    How to use

    1. 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. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before any payment.

    Reviews

    5.0
    1 review
    5
    1
    4
    0
    3
    0
    2
    0
    1
    0

    This skill has been used 3 times.

    Trust & safety

    Security scan

    Security scan passed 1 month ago

    • Free with an Agensi account

    Requires

    Git

    Permissions

    Terminal / Shell

    File Scopes

    CHANGELOG.md
    package.json
    pyproject.toml
    .github/pull_request_template.md

    Runs read-only git commands (git describe, git log, git shortlog) to gather release inputs and edits your changelog and version files only when you ask for a release; no network calls of its own.

    Listed2 months ago
    Updated1 month ago

    What's inside

    Frequently Asked Questions

    It makes the agent build PR descriptions and release notes from real git history (last tag, commits since, merged PRs) instead of from memory, using a fixed What / Why / How / Testing / Evidence / Checklist PR template.

    Yes. It follows the Keep a Changelog format: it keeps an [Unreleased] section and moves entries under a dated version heading when you cut a release.

    It applies semantic versioning rules to the commits since the last tag: breaking changes bump major, features bump minor, fixes bump patch, and it shows its reasoning so you can override it.

    No network access is required for the core workflow; it runs git commands locally. Listing merged PRs with titles and numbers uses the GitHub CLI if you have it installed and authenticated.

    It is an instruction skill (SKILL.md) with a worked PR example, a worked release-notes example and a changelog example. It ships no executable scripts.

    New in Testing & Debugging