write-release-note

Generate structured release notes from branch story frontmatter to Markdown.

1|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/qmu/workaholic --skill write-release-note
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-release-note
Source: https://github.com/qmu/workaholic/tree/main/plugins/core/skills/write-release-note
Command: npx skills add https://github.com/qmu/workaholic --skill write-release-note

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the creation of release notes by synthesizing the branch story and associated metadata into a concise, user-facing document, reducing manual drafting time.

Core Features & Use Cases

  • Structured release notes with Summary, Key Changes, Metrics, and Links.
  • Automatic extraction of tickets_completed, commits, and duration_hours from the story frontmatter.
  • Outputs to .workaholic/release-notes/<branch-name>.md for easy publishing to GitHub Releases.

Quick Start

Invoke the write-release-note skill to generate a release note for the current branch story and save it to .workaholic/release-notes/<branch-name>.md.

Frequently Asked Questions about write-release-note

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

FAQPage Schema
How do I generate release notes from a branch story automatically?

To generate release notes from a branch story, this skill extracts summaries, commits, and ticket metadata into a structured document. It reads story frontmatter and outputs the result to .workaholic/release-notes/<branch-name>.md.

What is the best way to automate GitHub release notes from commits and tickets?

Automating GitHub release notes is done by synthesizing branch story metadata like tickets_completed and commits into a concise document. The output includes a Summary, Key Changes, Metrics, and Links for easy publishing.

Does generating a change-log require specific frontmatter fields in the story?

Generating a change-log requires specific story frontmatter fields. The skill reads tickets_completed, commits, and duration_hours to extract the necessary highlights and metrics for the release document.

Can I output structured release notes directly to a file path for GitHub Releases?

You can output structured release notes directly to a file path for GitHub Releases. The skill writes the generated document to .workaholic/release-notes/<branch-name>.md using a defined content structure.

What sections are included when generating release notes from branch stories?

When generating release notes from branch stories, the document includes specific sections. The structured output contains a Summary, Key Changes, Metrics, and Links to target features, fixes, and related work.