Agent-Skills.md

Agent Skills: Release Notes Generation

[Git & Release] Generate professional release notes from git commits between two refs with automated categorization. Use when creating release notes from git history.

UncategorizedID: duc01226/easyplatform/release-notes

Repository

duc01226/easyplatform
duc01226License: MIT
31

Install this agent skill to your local

pnpm dlx add-skill https://github.com/duc01226/EasyPlatform/tree/HEAD/.claude/skills/release-notes

Skill Files

Browse the full folder contents for release-notes.

Download Skill

Loading file tree…

.claude/skills/release-notes/SKILL.md

Skill Metadata

Name
release-notes
Description
"[Git & Release] Generate professional release notes from git commits between two refs with automated categorization. Use when creating release notes from git history."

Release Notes Generation

Generate professional release notes from git commits with automated categorization.

Summary

Goal: Generate professional release notes from git commits between two refs with automated categorization and markdown output.

| Step | Action | Key Notes | |------|--------|-----------| | 1 | Parse commits | parse-commits.cjs <base> <head> -- outputs JSON with type, scope, breaking | | 2 | Categorize | categorize-commits.cjs -- feat/fix/perf/docs = user-facing; test/ci/chore = internal | | 3 | Render markdown | render-template.cjs --version vX.Y.Z --output path |

Key Principles:

  • Generated notes are Draft status -- require human review before publishing
  • Excludes chore(deps):, chore(config):, [skip changelog], [ci skip]
  • Complete pipeline is three piped scripts; see references for advanced features

Invocation

/release-notes [base] [head] [--version vX.Y.Z] [--output path]

Examples:

/release-notes v1.0.0 HEAD --version v1.1.0
/release-notes main feature/new-auth --version v2.0.0-beta

Workflow

Step 1: Parse Commits

node .claude/skills/release-notes/lib/parse-commits.cjs <base> <head> [--with-files]

Output: JSON with hash, type, scope, description, breaking, author, date, files

Step 2: Categorize Commits

node .claude/skills/release-notes/lib/parse-commits.cjs <base> <head> | \
node .claude/skills/release-notes/lib/categorize-commits.cjs

| Type | Category | User-Facing | | --------------------------------------- | ------------ | --------------------- | | feat | features | Yes | | fix | fixes | Yes | | perf | improvements | Yes | | docs | docs | Yes (unless internal) | | refactor | improvements | Technical only | | test, ci, build, chore, style | internal | No |

Excluded: chore(deps):, chore(config):, [skip changelog], [ci skip]

Step 3: Render Markdown

node .claude/skills/release-notes/lib/parse-commits.cjs <base> <head> | \
node .claude/skills/release-notes/lib/categorize-commits.cjs | \
node .claude/skills/release-notes/lib/render-template.cjs --version v1.1.0 --output docs/release-notes/250111-v1.1.0.md

Complete Pipeline

node .claude/skills/release-notes/lib/parse-commits.cjs v1.0.0 HEAD | \
node .claude/skills/release-notes/lib/categorize-commits.cjs | \
node .claude/skills/release-notes/lib/render-template.cjs --version v1.1.0 --output docs/release-notes/250111-v1.1.0.md

Output Structure

# Release Notes: v1.1.0
**Date:** 2025-01-11 | **Version:** v1.1.0 | **Status:** Draft

## Summary
## What's New
## Improvements
## Bug Fixes
## Breaking Changes
## Technical Details (collapsed)
## Contributors

Human Review Gate

Generated notes are Draft status. Review -> Enhance -> Approve -> Publish.

Advanced Features

See references/release-pipeline.md for:

  • Service boundary detection, breaking change analysis
  • PR metadata extraction, contributor statistics
  • Version bumping, quality validation, LLM transforms
  • Full enhanced pipeline, configuration, troubleshooting

Integration

  • /commit - Commit generated notes
  • /changelog-update - Update CHANGELOG.md with new release

IMPORTANT Task Planning Notes

  • Always plan and break many small todo tasks
  • Always add a final review todo task to review the works done at the end to find any fix or enhancement needed