qmd-release

Automate QMD release workflows with version cutting, changelog validation, and hook installation.

Updated Jan 23, 2026
One-click install
npx skills add https://github.com/paradox123/shared-ai-docs --skill qmd-release
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: qmd-release
Source: https://github.com/paradox123/shared-ai-docs/tree/main/skills-repo/skills/qmd-release
Command: npx skills add https://github.com/paradox123/shared-ai-docs --skill qmd-release

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the QMD release workflow by cutting a version, validating the changelog, and ensuring management of release hooks.

Core Features & Use Cases

  • Cut a release version and tag it in the QMD repository.
  • Validate and update the Unreleased changelog content.
  • Install and verify pre-push hooks to guard the release process.

Quick Start

Run the release command with a version string (e.g., /release 1.0.0) to start the QMD release workflow.

Frequently Asked Questions about qmd-release

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

FAQPage Schema
How do I automate a version release and changelog validation in my git repository?

To automate a version release and changelog validation, you can trigger a workflow that cuts a version tag, validates the Unreleased changelog content, and installs pre-push hooks to guard the release process before any pushes occur.

What is the best way to cut a release version while ensuring CI workflows are triggered safely?

The best way to cut a release version safely is to use an automated workflow that validates the changelog, installs git-hooks, and enforces review gates and guarded pushes so that CI workflows are only triggered after successful validation.

How do pre-push hooks work to guard the release process during version cutting?

Pre-push hooks guard the release process by installing and verifying validation checks before any code is pushed, ensuring that version cutting and changelog updates are reviewed and confirmed before triggering CI workflows.

Can I use this automated release workflow outside of the QMD repository?

No, this automated release workflow applies strictly within the QMD repository and only activates when you explicitly request a QMD release, ensuring guarded pushes and CI workflows are contained to that specific project.

Why does my release workflow require explicit validation before triggering CI?

Your release workflow requires explicit validation before triggering CI to ensure the changelog is updated and pre-push hooks are verified, creating a review gate that prevents unvalidated or incomplete version cuts from being pushed.

Do I need to manually update the changelog before cutting a release version?

You do not need to manually update the changelog before cutting a release version, because the workflow validates and updates the Unreleased changelog content automatically as part of the release process.