release-notes-writer

name	release-notes-writer
kind	skill
description	Generates structured release notes from git commit history, PR titles, and linked issues. Supports Conventional Commits and custom formats.
tags	["release","ci","documentation","changelog"]
version	0.1.0
author	agentverse-ci
license	MIT

Release Notes Writer

Automatically generates well-formatted release notes from commit history, pull request metadata, and issue trackers — ready for GitHub Releases, CHANGELOG.md, or Slack notifications.

When to use this skill

• On every git tag push to auto-generate and post GitHub Release notes
• Weekly digest of merged PRs to a team Slack channel
• Maintaining a CHANGELOG.md that follows Keep a Changelog conventions

Inputs

{
  "repo": "org/repo",
  "from_ref": "v1.2.0",
  "to_ref":   "v1.3.0",
  "format":   "markdown",
  "sections": ["breaking", "features", "fixes", "deps", "chores"],
  "include_authors": true,
  "issue_tracker": "github"
}

Field	Required	Description
repo	✓	GitHub owner/repo slug
from_ref	✓	Start tag, branch, or commit SHA
to_ref	✗	End ref (defaults to HEAD)
format	✗	markdown (default), json, slack
sections	✗	Which categories to emit
include_authors	✗	Attribute changes to PR authors
issue_tracker	✗	github or jira for issue link resolution

Conventional Commit mapping

Prefix	Section
feat: / feat!:	Features / Breaking Changes
fix:	Bug Fixes
deps: / chore:	Maintenance
docs:	Documentation
perf:	Performance

Output (markdown)

## What's Changed in v1.3.0

### 🚀 Features
- Add skill import from GitHub repository URL (#142) @loonghao
- Support `github_repo` source type for directory-based skills (#138) @loonghao

### 🐛 Bug Fixes
- Fix `SourceType::GitHub` serialised as `git_hub` instead of `github` (#145)

### 📦 Dependencies
- Bump `zip` to 2.4.2
- Bump `axum` to 0.8.8

**Full Changelog**: https://github.com/org/repo/compare/v1.2.0...v1.3.0

CI integration (GitHub Actions)

on:
  push:
    tags: ['v*']

jobs:
  release:
    steps:
      - name: Generate Release Notes
        uses: agentverse/run-skill@v1
        with:
          skill: agentverse-ci/release-notes-writer
          inputs: |
            repo: ${{ github.repository }}
            from_ref: ${{ github.event.before }}
            to_ref:   ${{ github.ref_name }}
            format: markdown
        env:
          AGENTVERSE_TOKEN: ${{ secrets.AGENTVERSE_TOKEN }}
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

      - name: Create GitHub Release
        uses: softprops/action-gh-release@v2
        with:
          body: ${{ steps.generate.outputs.notes }}

Notes

• Breaking changes (commits with ! suffix or BREAKING CHANGE: footer) are always promoted to a dedicated section regardless of sections config.
• For Jira integration, provide JIRA_BASE_URL and JIRA_TOKEN as environment variables.