hotplex-release

Automate HotPlex releases with version bumps, changelogs, and unified component versions.

47|15|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/hrygo/hotplex --skill hotplex-release
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hotplex-release
Source: https://github.com/hrygo/hotplex/tree/main/.agents/skills/hotplex-release
Command: npx skills add https://github.com/hrygo/hotplex --skill hotplex-release

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

HotPlex release preparation and publishing involves many error-prone, repetitive steps (version bump, changelog quality, tag/release creation, and cross-component version consistency), and this Skill ensures a consistent, auditable workflow on both main and feature branches.

Core Features & Use Cases

  • Version determination & guardrails: Reads the current HotPlex version, computes the next semver (patch/minor/major), and enforces the rule that tags and GitHub Releases must only be created on main.
  • Change collection & categorized Changelog: Collects commits since the last release tag, groups changes into user-relevant sections, and writes CHANGELOG.md following Keep a Changelog with a clear, user-facing Summary.
  • Version unification across the whole project: Updates Go gateway version references, WebChat UI version, SDK example versions, Dockerfile labels, and validates that versions match before publishing.
  • Release orchestration: On main, creates an annotated tag, pushes to trigger CI builds, replaces auto-generated release notes with the full extracted changelog content, and verifies artifacts and post-release correctness.

Example use case: you need to publish v1.2.1 with a patch release, ensuring the changelog Summary and categorized Added/Changed/Fixed sections are correct and that every component (gateway, UI, SDK examples, Docker label) reports the same version.

Quick Start

Ask the assistant to prepare a HotPlex patch release to v1.2.1 on your current branch, ensuring it updates CHANGELOG and unifies versions, and if you are on main then it should proceed to tag, publish, and verify artifacts.

Frequently Asked Questions about hotplex-release

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

FAQPage Schema
How do I automate changelog generation and semver version bumping for a GitHub release?

To unify component versions for a release, you update Go gateway references, WebChat UI, SDK examples, and Dockerfile labels, then validate that all components report the same semantic version before publishing to ensure cross-repository consistency.

Can I publish a GitHub release with a new Git tag from a feature branch?

You can prepare release artifacts on a feature branch, but strict branch guardrails enforce that creating Git tags and publishing GitHub Releases must only occur on the main branch to maintain deterministic CI builds and release correctness.

How do I format a Keep a Changelog file from conventional commits for a patch release?

After publishing a release, you trigger CI builds by pushing the annotated tag, replace auto-generated GitHub release notes with the full extracted changelog content, and verify post-release artifacts to ensure deterministic workflow correctness across all unified components.

What's the best way to ensure CI-triggered artifact verification after a semantic version release?

The best way to ensure CI-triggered artifact verification is to push an annotated Git tag to trigger CI builds, replace auto-generated release notes with extracted changelog content, and validate post-release artifact correctness across all project components.

Does this release workflow support both feature branch preparation and main branch publishing?

Yes, the release workflow supports preparing version bumps and changelogs on feature branches, while enforcing strict guardrails so that actual tag creation, GitHub release publishing, and CI artifact verification only happen on the main branch.