agr-release

Coordinate version bumps, changelog updates, quality checks, and tagging for agr releases.

450|36|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/computerlovetech/agr --skill agr-release
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: agr-release
Source: https://github.com/computerlovetech/agr/tree/main/skills/agr-release
Command: npx skills add https://github.com/computerlovetech/agr --skill agr-release

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes uncertainty and missed steps when cutting a new agr release, ensuring the version bump, changelog, quality checks, tagging, and publish pipeline all align so CI and PyPI publishing succeed.

Core Features & Use Cases

  • Release planning & change scoping: Identifies what changed since the last release tag and reconciles it with the changelog so release notes are accurate.
  • Pre-release quality gate: Runs the same local checks CI will run (linting, formatting verification, tests, and type checks) to prevent avoidable pipeline failures.
  • End-to-end release execution support: Updates pyproject versioning and CHANGELOG.md, creates the correct git tag, and guides monitoring and verification of the publish workflow.

Quick Start

Ask the AI to guide you through creating the next agr release by specifying whether you want a patch, minor, major, or beta release.

Frequently Asked Questions about agr-release

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

FAQPage Schema
How do I automate Python package publishing with git tagging and GitHub Actions?

Automating Python package publishing with git tagging and GitHub Actions requires a tag-driven CI pipeline where a correct vX.Y.Z tag triggers the build and trusted PyPI publication. This workflow coordinates version bumping, changelog updates, and quality checks before pushing the tag to ensure the automated release succeeds.

What do I need to prepare before cutting a new PyPI release from a clean main branch?

Before cutting a PyPI release, you need a clean main-branch state, consistent changelog formatting, and locally passing ruff, pytest, and ty checks. Reconciling changes since the last release tag with the changelog ensures the generated GitHub Release notes are accurate.

How do I update the changelog and bump the version for a new Python package release?

To bump the version and update the changelog for a new release, identify what changed since the last tag, update the pyproject versioning, and format CHANGELOG.md consistently. Specifying a patch, minor, major, or beta release scopes the version bump appropriately.

Why does my GitHub Actions publish workflow fail after creating a git tag?

A GitHub Actions publish workflow often fails after creating a git tag if local pre-release quality gates were skipped. Running the same linting, formatting, tests, and type checks locally before pushing the commit and tag prevents avoidable CI pipeline failures.

Can I trigger a trusted PyPI publication through a CI pipeline without a clean main branch?

Triggering trusted PyPI publication through a CI pipeline requires a clean main-branch state. Committing and pushing a release tag with uncommitted changes or failing local checks misaligns the version bump and quality gates, causing the publish workflow to fail.

What is the best way to monitor a tag-driven GitHub Release and PyPI publishing pipeline?

The best way to monitor a tag-driven GitHub Release and PyPI publishing pipeline is to guide the monitoring and verification of the publish workflow after pushing the confirmed commit and tag. This ensures the CI build succeeds and extracts the correct GitHub Release notes.