release-publish

Automate AIDD Python package release preparation, publishing, verification, and recording.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/GrinRus/ai_driven_dev_v2 --skill release-publish-grinrus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-publish
Source: https://github.com/GrinRus/ai_driven_dev_v2/tree/main/.agents/skills/release-publish
Command: npx skills add https://github.com/GrinRus/ai_driven_dev_v2 --skill release-publish-grinrus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the error-prone, manual work of cutting, publishing, and verifying AIDD Python package releases, which requires strict adherence to governance rules, multi-tool install verification, and accurate evidence recording to avoid invalid or unreproducible releases.

Core Features & Use Cases

  • End-to-End Release Orchestration: Automates the full AIDD package release workflow from creating the release/v<version> branch to post-release version bump and PR creation, ensuring no required steps are missed.
  • Built-In Governance Guardrails: Enforces critical safety rules like preventing duplicate version publishes, validating tag/branch SHA matches, and blocking direct tag-push publishing to avoid accidental or invalid releases.
  • Multi-Path Install Verification: Automatically verifies package availability and installability via PyPI, pipx, and uv tool after publication, ensuring all supported installation methods work for end users.
  • Use Case: A maintainer cutting a new AIDD prerelease can use this Skill to complete the entire release process without missing required validation steps, evidence recording, or post-release follow-up tasks, reducing human error and ensuring compliance with the project's release policy.

Quick Start

Use the release-publish skill to cut and verify a new prerelease for the current AIDD project version, including all required governance checks and installation evidence recording.

Frequently Asked Questions about release-publish

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

FAQPage Schema
How do I automate Python packaging and GitHub release publication to avoid manual errors?

Automating Python packaging and GitHub release publication requires orchestrating branch creation, tag validation, and post-release version bumping. This Skill enforces release governance by validating tag and branch SHA matches to prevent accidental or invalid releases.

What is the best way to verify PyPI package installability using pipx and uv tool?

Verifying PyPI package installability with pipx and uv tool involves checking multi-path installation success after publication. This Skill automatically performs these checks to ensure all supported installation methods work for end users.

How does release governance validation prevent duplicate version publishes on GitHub?

Release governance validation prevents duplicate version publishes by enforcing strict gate checks before cutting a release. This Skill blocks direct tag-push publishing and validates tag and branch SHA matches to eliminate unreproducible releases.

How do I create a release branch and run a deterministic dry-run validation for Python packages?

Creating a release branch and running deterministic dry-run validation requires automated end-to-end orchestration from branch creation to publication. This Skill automates the full workflow including dry-run validation, GitHub Release publication, and post-release version bump PR creation.

Can I record durable release evidence in project documentation after publishing to PyPI?

Recording durable release evidence in project documentation after publishing to PyPI requires capturing installation verification results. This Skill automatically records PyPI, pipx, and uv tool installability checks as evidence in project documentation.

Why does direct tag-push publishing get blocked during GitHub release automation?

Direct tag-push publishing gets blocked during GitHub release automation to enforce release governance rules and prevent invalid releases. This Skill enforces strict release gates by validating tag and branch SHA matches before allowing publication.