hos-gh-release-note

Write and publish GitHub release notes with structured sections and dependency tables.

32|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/openreachtech/hora-skills-ort-support --skill hos-gh-release-note-openreachtech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hos-gh-release-note
Source: https://github.com/openreachtech/hora-skills-ort-support/tree/main/kit/skills/hos-gh-release-note
Command: npx skills add https://github.com/openreachtech/hora-skills-ort-support --skill hos-gh-release-note-openreachtech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Writing a release note that tells users what changed, what could break, and what they must do is tedious and inconsistent. This Skill produces a standardized GitHub release note for a tag — with ordered ## sections, dependency tables per package.json field, and a compare link — and sends it via the gh CLI after confirmation. ## Core Features & Use Cases - Structured release body: Generates # What's Changed with ordered sections (Kicked Out, Deprecated, New Features, Security, Bug Fixes, Requirements, Supply Chain, Dependencies, CI) chosen by whether the tag is a new major. - Dependency tables: Builds one table per manifest field (dependencies:, devDependencies:, overrides:) with semver-step ordering, (kicked) markers for removals, and advisory notes. - Safe publishing via gh: Creates releases as drafts, shows the full body for confirmation before sending, and saves the previous body before replacing it. - Use Case: After tagging v2.0.0, ask for a release note; the Skill diffs against the previous tag, drafts the note with breaking changes and dependency moves, and publishes it as a draft release once you confirm. ## Quick Start Write a release note for the latest tag in this repository and create it as a draft release on GitHub.

Frequently Asked Questions about hos-gh-release-note

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

FAQPage Schema
How do I write a GitHub release note for a new tag?

Provide the tag and the Skill diffs it against the previous tag found via git tag --sort=v:refname. It drafts a body with What's Changed sections and a compare link, shows it for confirmation, then sends it with gh release create or gh release edit.

What sections should a release note include?

A new major leads with Kicked Out, Deprecated, and New Features; other releases lead with Security. Bug Fixes, Requirements, Supply Chain, Dependencies, and CI follow when they have content, and empty sections are omitted entirely.

Does this work without the GitHub CLI installed?

Yes. If gh is missing or not authenticated, the Skill says which is the case and stops at producing the release note text. The note's structure, ordering, and language are identical whether it is sent or pasted by hand.

How are dependency changes shown in a release note?

Each package.json field gets its own table with columns for package name, old version, new version, semver step, and note. Rows sort Major to Patch, additions and removals have an empty semver cell, and overrides get a third table with resolved versions.

Can it edit an already published GitHub release?

Yes, via gh release edit with --notes-file, without dropping the release to draft. The current body is saved to a file first because GitHub keeps no history of replaced release bodies.

Why are releases created as drafts by default?

Every release created by the Skill uses gh release create --draft because deciding readiness to publish is a human judgement. The draft flag is only removed when explicitly requested, using gh release edit --draft=false.