release

Cut versioned git releases with quality gates and annotated tags.

121|2|Updated Apr 24, 2026
One-click install
npx skills add https://github.com/AgentSystemLabs/core --skill release-agentsystemlabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release
Source: https://github.com/AgentSystemLabs/core/tree/main/plugins/agentsystem-core/skills/release
Command: npx skills add https://github.com/AgentSystemLabs/core --skill release-agentsystemlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Release management is error-prone: teams often bump versions, forget required quality gates, produce inconsistent release notes, or tag code that is not actually ready to ship.

Core Features & Use Cases

  • Phased, shippability-first release flow: performs a preflight (clean tree, correct branch, identifiable tags), then a mandatory quality gate against the release range before it computes and applies the next version.
  • Mode-based risk control: supports mode=fast|balanced|production, where production runs the full check-pr-readiness gauntlet against the range being released.
  • Accurate release notes from real commits: generates annotated-tag notes from commits since the last tag (grouped when conventional commits are detected).
  • Publishing safety guardrails: creates the local commit and annotated tag, then stops before any push until the user explicitly authorizes publishing.
  • Smart manifest handling across project types: updates version in package.json, pyproject.toml, Cargo.toml, VERSION files, and Claude Code plugin marketplaces with diff-driven per-plugin bump rules.

Quick Start

Tell your agent to run a production release by having it execute /release (and optionally /release patch or /release major if you need a specific semver bump).

Frequently Asked Questions about release

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

FAQPage Schema
How do I automate git tagging and release notes generation from commits?

To automate git tagging and release notes generation, the Skill creates annotated vX.Y.Z tags and groups commits since the last tag into accurate notes, especially when conventional commits are detected. It requires a clean working tree preflight before applying any version bump.

Does this release workflow support versioning for Python, Rust, and Node projects?

Yes, the release workflow supports versioning across Node, Python, Rust, plain VERSION files, and Claude Code plugin marketplaces. It performs deterministic manifest and lockfile updates by detecting and bumping the correct project manifest format automatically.

What is the best way to ensure shippability before cutting a production release?

The best way to ensure shippability is using the production mode quality gate, which runs the full check-pr-readiness gauntlet against the specific release range. This verifies code quality before computing and applying the next semver version.

How do I compute the next semver version when bumping a project manifest?

To compute the next semver version, the Skill analyzes commits and applies mode-based risk control to determine the correct bump. You can explicitly request a patch or major bump, or let it detect the appropriate semantic version automatically.

Can I control when the annotated git tag gets pushed to the remote repository?

Yes, you can control when the annotated git tag gets pushed because the Skill creates the local commit and tag, then stops before any push. It requires explicit user authorization before publishing the tag to the remote repository.

Why do I need a clean working tree before starting the versioning process?

You need a clean working tree before starting the versioning process to prevent shipping uncommitted or untested changes. The preflight check ensures the branch is correct and the repository state is identifiable before applying quality gates.