releasing

Cut and publish project releases from validated change sets.

4|1|Updated Nov 1, 2025
One-click install
npx skills add https://github.com/xtrm-dev/specialists --skill releasing-xtrm-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: releasing
Source: https://github.com/xtrm-dev/specialists/tree/main/config/skills/releasing
Command: npx skills add https://github.com/xtrm-dev/specialists --skill releasing-xtrm-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the manual friction of cutting a release by coordinating version bumps, changelog updates, build regeneration, tagging, pushing, and optional GitHub publication in one controlled flow.

Core Features & Use Cases

  • Release Orchestration: Guides an end-to-end release from the latest semver tag or an explicit version target.
  • Changelog Synthesis: Drafts release notes from recent xt reports and keeps the scope limited to the approved release files.
  • Validation and Safety: Verifies the resulting diff, enforces strict file boundaries, and checks that the tag and push completed successfully.
  • Use Case: A maintainer wants to ship v2.4.1 after a week of changes and needs the changelog, package version, dist output, and Git tag updated together without touching source files.

Quick Start

Ask the assistant to cut the next release for the project, using the latest tag as the base and returning the final version, commit, tag, and push status.

Frequently Asked Questions about releasing

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

FAQPage Schema
How do I automate git tagging and changelog updates for a package release?

Automating git tagging and changelog updates involves coordinating version bumps in package.json, drafting changelog entries, regenerating builds, tagging, and pushing in one controlled release flow. This ensures all release files are updated together without manual friction.

What is the best way to cut a semver release from a validated change set?

Cutting a semver release from a validated change set applies a strict release scope over CHANGELOG.md, package.json, and dist/. It verifies the final diff, version tag, and push status to ensure only approved files are modified during the release process.

Does this release orchestration process modify source files during a version bump?

No, the release orchestration process enforces strict file boundaries and does not modify source files. It limits its scope to CHANGELOG.md, package.json, and dist/, ensuring the release only touches approved output and metadata files.

Can I publish a GitHub release and push git tags simultaneously?

Yes, you can publish an optional GitHub release and push git tags simultaneously. The release flow handles version bumping, changelog drafting, tagging, and pushing, while verifying that the tag and push operations completed successfully.

How do I draft release notes from recent git reports before tagging?

Drafting release notes from recent reports synthesizes changelog entries from recent activity before applying the version bump. This keeps the release scope limited to approved files while preparing the documentation for the final tag and push.

What are the limitations of enforcing strict release file boundaries?

Enforcing strict release file boundaries limits modifications to CHANGELOG.md, package.json, and dist/. This means any source code changes or unapproved file modifications must be handled separately before the release orchestration begins.