# Release Notes

> Build human-readable release notes from a range of commits or merged PRs

- **Type:** Skill
- **Install:** `agentstack add skill-onlyterp-hermes-optimization-guide-release-notes`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [OnlyTerp](https://agentstack.voostack.com/s/onlyterp)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [OnlyTerp](https://github.com/OnlyTerp)
- **Source:** https://github.com/OnlyTerp/hermes-optimization-guide/tree/main/skills/dev/release-notes

## Install

```sh
agentstack add skill-onlyterp-hermes-optimization-guide-release-notes
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# release-notes — Generate Release Notes

Produce a release-notes document following the "What's New / Improvements / Fixes / Breaking / Acknowledgements" structure used by Hermes, React, VS Code, etc.

## Procedure

1. **Resolve the range:**
   - If `range:` looks like a git range (`X..Y`), use `git log --pretty` to list commits.
   - Otherwise treat it as a GitHub milestone name and pull the closed PRs via `github` MCP.

2. **For each commit/PR, extract:**
   - Type from Conventional Commits prefix (`feat:`, `fix:`, `docs:`, `security:`, `perf:`, `refactor:`, `chore:`)
   - Scope (inside the parentheses)
   - Summary (the first line after the prefix)
   - Body / PR description for context
   - Author + association (CONTRIBUTOR / COLLABORATOR / MEMBER)

3. **Group:**
   - **🚀 What's New** — all `feat:` with scope outside `ci|deps|docs`
   - **⚡ Improvements** — `perf:` and `refactor:`
   - **🐛 Fixes** — `fix:`
   - **🔒 Security** — `security:` + any PR labeled `security` regardless of prefix
   - **💥 Breaking** — any PR labeled `breaking` or any commit with `!:` marker
   - **📚 Docs** — `docs:`
   - **🙏 Acknowledgements** — list of all non-MEMBER authors

4. **Write in plain English.** For each entry, rewrite the conventional-commit summary into a reader-friendly one-liner. Example:
   - Input: `feat(mcp): add http transport with reconnect backoff`
   - Output: `HTTP MCP servers now reconnect automatically with exponential backoff.`

5. **Include PR links** where available: `([#1234](https://github.com/owner/repo/pull/1234))`

6. **Output** as markdown, ready to paste into a GitHub release.

## Example output shape

```markdown
# v1.3.0 — "Thunderbolt"

## 🚀 What's New
- HTTP MCP servers now reconnect automatically with exponential backoff. ([#1234](…))
- Gemini OAuth is now a first-class provider. ([#1270](…))

## ⚡ Improvements
- 40% faster skill load via async frontmatter parsing. ([#1205](…))

## 🐛 Fixes
- Telegram voice transcripts no longer truncate at 60s. ([#1240](…))

## 🔒 Security
- Redact GitHub PATs in log output. ([#1256](…))

## 🙏 Acknowledgements
Thanks to @alice, @bob, @charlie for contributions this release.
```

## Cron wiring

```yaml
- name: weekly-release-preview
  schedule: "0 16 * * 5"           # Fridays 4pm
  task: /release-notes range=origin/main..last-release
  notify: telegram_private
```

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [OnlyTerp](https://github.com/OnlyTerp)
- **Source:** [OnlyTerp/hermes-optimization-guide](https://github.com/OnlyTerp/hermes-optimization-guide)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-onlyterp-hermes-optimization-guide-release-notes
- Seller: https://agentstack.voostack.com/s/onlyterp
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.