Automates HACS integration release workflows.

Install

mkdir -p .claude/skills/release-timsoethout && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/15851" && unzip -o skill.zip -d .claude/skills/release-timsoethout && rm skill.zip

Installs to .claude/skills/release-timsoethout

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Use when managing HACS releases for this integration, including version bumps, tags, beta/pre-release publishing, and release notes.
132 chars✓ has a “when” trigger
Intermediate

Key capabilities

  • Update the semantic version in manifest.json
  • Use `x.x.x-beta` format for beta releases
  • Create a git tag for the new version
  • Publish a GitHub Release for that tag
  • Write release notes summarizing changes

How it works

This skill manages HACS releases by updating the semantic version in the manifest, creating git tags, publishing GitHub Releases, and compiling release notes. It ensures proper versioning and communication for the integration.

Inputs & outputs

You give it
A request to prepare a HACS release for the SEMS integration
You get back
A new HACS release with updated manifest, git tag, GitHub release, and release notes

When to use release

  • Bump version for release
  • Create release tag
  • Write release notes

About this skill

Release Workflow

Use this skill when preparing a HACS release for the SEMS integration.

Steps

  1. Update the semantic version in custom_components/sems/manifest.json.
  2. For beta releases from branches, use the x.x.x-beta version format and mark the GitHub Release as a Pre-release.
  3. Create a git tag for the new version: x.x.x(-beta).
  4. Publish a GitHub Release for that tag. Tags alone are not enough for HACS; the latest release tag is what remote version checks use.
  5. Write release notes that summarize the changes since the previous release, ideally based on commits since the prior tag.

Validation

  • Run the narrowest relevant tests before releasing.
  • Run ruff check and ruff format --check for the touched area if code changed.
  • Confirm the manifest version matches the tag and release metadata.

Notes

  • Keep release notes concise and focused on user-visible changes.
  • For pre-releases, make the beta/pre-release state explicit in both the version and the GitHub Release settings.

When not to use it

  • The task is not related to HACS releases
  • The task is about internal versioning not exposed to HACS

Limitations

  • The skill is for managing HACS releases for this integration
  • Tags alone are not enough for HACS; the latest release tag is what remote version checks use
  • For pre-releases, make the beta/pre-release state explicit in both the version and the GitHub Release settings

How it compares

This workflow automates the specific steps required for HACS releases, including version formatting and GitHub Release creation, providing a structured process compared to manual release management.

Compared to similar skills

release side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
release (this skill)02moNo flagsIntermediate
agent-workflow-automation46moReviewAdvanced
project-os16moReviewIntermediate
project-tooling14moCautionBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

Search skills

Search the agent skills registry