happier-release-notes

Generate Happier release-note story decks and release JSON from git diffs.

1.4k|122|Updated Dec 16, 2025
One-click install
npx skills add https://github.com/happier-dev/happier --skill happier-release-notes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: happier-release-notes
Source: https://github.com/happier-dev/happier/tree/main/skills/happier-release-notes
Command: npx skills add https://github.com/happier-dev/happier --skill happier-release-notes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It turns raw release inputs (final copy, git diffs, commits, or tags) into polished, user-facing Happier release-note story decks that are ready to publish and correctly wired with translations and bundled assets.

Core Features & Use Cases

  • Curate release-note story decks: Produce structured release-note markdown plus a short StoryDeck card set (list/image/video) aligned to the app’s card contract and limits.
  • Author and publish ready content: Create or update apps/ui/release-notes/releases/<releaseId>.json with consistent translation keys and validated asset references.
  • Analyze changes from git: Cluster commits by user-facing outcomes, filter out non-user-visible changes, and propose content before writing release JSON.
  • Prepare offline-safe media: Organize image cards and video posters for bundled use, and stage heavier/optional media under the release assets boundary.
  • Validate and generate UI-ready outputs: Run the release-note parsing pipeline and confirm changes land only in the expected generated manifests.

Quick Start

Use the skill to analyze a requested git range or tag difference and generate a proposed set of detailed release notes plus a short StoryDeck for the next Happier release, then bake the approved version into the UI release JSON.

Frequently Asked Questions about happier-release-notes

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

FAQPage Schema
How do I generate user-facing release notes from git commit history?

To generate release notes from git commit history, the skill clusters commits by user-facing outcomes and filters out non-user-visible changes. It then proposes structured markdown content and a StoryDeck card set before baking the approved version into a release JSON manifest.

How do I create StoryDeck cards for a UI changelog?

Creating StoryDeck cards for a UI changelog involves producing a short list, image, and video card set aligned to the app’s card contract limits. The skill drafts this content directly from final author input or parsed git tag diffs.

Can I validate translation keys and asset references in release markdown?

Yes, you can validate translation keys and asset references in release markdown. The skill runs a release-note parsing pipeline that confirms all references are correctly wired and ensures changes land only in expected generated manifests.

What is the best way to bundle offline-safe image and video posters for release assets?

The best way to bundle offline-safe media is to organize image cards and video posters for bundled use while staging heavier optional media under a release assets boundary. This ensures the UI deck loads correctly without external network dependencies.

Does this release-note generation method work with tag diffs and final author copy?

Yes, this release-note generation method works with both tag diffs and final author copy. It accepts raw release inputs from final copy, git diffs, commits, or tags and turns them into polished, publish-ready markdown and JSON outputs.

When should I not use automated git analysis for release notes?

You should not rely solely on automated git analysis for release notes when your commits lack descriptive user-facing context. In those cases, provide final author copy directly so the skill can curate accurate StoryDeck content without misleading generated outcomes.