h4tcher-release-prep

Coordinate hatch3r release versioning, quality gates, and documentation parity checks.

26|4|Updated Feb 27, 2026
One-click install
npx skills add https://github.com/hatch3r/hatch3r --skill h4tcher-release-prep
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: h4tcher-release-prep
Source: https://github.com/hatch3r/hatch3r/tree/main/.claude/skills/h4tcher-release-prep
Command: npx skills add https://github.com/hatch3r/hatch3r --skill h4tcher-release-prep

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents broken hatch3r releases by coordinating versioning, documentation parity, adapter verification, and changelog accuracy into a single reproducible release-prep workflow.

Core Features & Use Cases

  • Version orchestration: Aligns package.json, plugin manifests, lockfile refresh, and inventory/doc drift checks to a single semver source of truth.
  • Quality gates and validation: Runs tests, typecheck, lint, build, and hatch3r validate to ensure the release is production-ready.
  • Release fidelity and reconciliation: Verifies adapter registration/capability completeness, enforces Keep-a-Changelog section formatting, and ensures merged PRs are represented in the changelog (or explicitly classified).
  • Docs and website currency: Builds the Docusaurus website with strict link checking and verifies inventory parity against governance counts and sidebars.

Quick Start

Ask your AI agent to run the full hatch3r release preparation flow and update the release version, run all quality gates, reconcile CHANGELOG.md with merged PRs, and verify website/doc parity.

Frequently Asked Questions about h4tcher-release-prep

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

FAQPage Schema
How do I automate changelog formatting and versioning for npm package releases?

Automate changelog formatting and versioning by orchestrating package.json, plugin manifests, and lockfile refreshes to a single semver source of truth. This enforces Keep-a-Changelog section formatting for reliable CI extraction during npm package releases.

How do I verify adapter registry and capability matrix completeness before a release?

Verify adapter registry completeness by running release fidelity checks that validate adapter registration and capability matrices. This ensures all adapters are properly documented and registered before publishing to npm or creating GitHub release notes.

What is the best way to enforce documentation parity and check for broken links in a Docusaurus build?

Enforce documentation parity by building the Docusaurus website with strict broken-link failure behavior. This verifies inventory parity against governance counts and sidebars, ensuring published docs match repository changes exactly.

How do I reconcile merged PRs with the changelog to prevent missing release notes?

Reconcile merged PRs with the changelog by enforcing release fidelity checks that verify all merged PRs are represented in CHANGELOG.md. Unrepresented PRs must be explicitly classified before the release workflow can proceed.

Can I run lockfile and supply chain auditing alongside CI validation tests?

Yes, you can run lockfile and supply chain auditing alongside CI validation. The release workflow coordinates tests, typecheck, lint, and build processes together to ensure the published package meets strict technical supply chain requirements.

Why do my CI pipelines fail when extracting release notes from an unstructured changelog?

CI pipelines fail extracting release notes when the changelog lacks strict Keep-a-Changelog section formatting. Applying a coordinated release-prep workflow enforces the required formatting structure, enabling reliable automated extraction for GitHub release notes.