# Release Notes

> Write release notes for different audiences. Use when shipping a release and need to communicate changes to end users, enterprise customers, or internal teams.

- **Type:** Skill
- **Install:** `agentstack add skill-uthumany-uthy-legacy-os-release-notes`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [uthumany](https://agentstack.voostack.com/s/uthumany)
- **Installs:** 0
- **Category:** [Communication](https://agentstack.voostack.com/c/communication)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [uthumany](https://github.com/uthumany)
- **Source:** https://github.com/uthumany/uthy-legacy-os/tree/main/skills/shipping/release-notes
- **Website:** https://uthumany.github.io/uthy-legacy-os/

## Install

```sh
agentstack add skill-uthumany-uthy-legacy-os-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

## Overview

Release notes are your product's public diary. Well-written notes inform users, build trust, and highlight the value of what you shipped. This skill covers writing for different audiences: end users, enterprise buyers, and internal teams.

## When to Use

- You're shipping a new version of your product
- You want to communicate changes to users
- You need enterprise-grade release notes for compliance
- Don't use for: internal build descriptions (use commit messages), marketing announcements (use blog posts)

## Instructions

### 1. Segment Your Audience

**End Users** (in-app or email):
- Focus on what's NEW and what's BETTER
- Use benefit-oriented language ("Now you can...")
- Screenshots and GIFs > text
- Friendly, conversational tone

**Enterprise / Admin** (admin dashboard):
- Include all changes (even minor ones)
- Add upgrade, migration, or configuration notes
- Document API changes, deprecations
- Professional, informative tone

**Internal / Engineering** (Slack, mailing list):
- Include technical details, gotchas
- Migration instructions, config changes
- Known issues and workarounds
- Honest, direct tone

### 2. Structure Each Entry

```
## [Version Number] - [Date]

### 🚀 New Features
- [Headline what's new] — [1-2 sentences on value]

### 🔧 Improvements
- [What changed and why it's better]

### 🐛 Bug Fixes
- [Problem] — [Fix] — [Effect]

### ⚠️ Known Issues
- [Issue] — [Workaround]

### 📦 Technical Notes (enterprise only)
- [Upgrade notes, config changes, API changes]
```

### 3. Writing Guidelines

- **Start with the most important change** — Users scan, they don't read
- **Use active voice** — "You can now..." not "An option to... has been added"
- **Specify who benefits** — "Team admins can now..." not "Improved admin panel"
- **Link to docs** — For complicated features, link to full documentation
- **Acknowledge contributions** — Thank beta testers, early adopters, or contributors

## Sample Output

```
## v2.4.0 - June 4, 2026

### 🚀 New Features
- **Async team updates** — Share status updates without scheduling a meeting. Team members can post text, links, and screenshots that compile into a daily digest.
- **AI status summaries** — One-click summary of the week's updates (Enterprise feature)

### 🔧 Improvements
- **Faster search** — Results now load 3x faster with indexed search
- **Simplified onboarding** — New users can invite their team in 2 clicks instead of 5

### 🐛 Bug Fixes
- Fixed: Calendar sync showing incorrect timezone on Safari
- Fixed: Notification preferences not saving for team members with dots in email

### ⚠️ Known Issues
- Team dashboard may appear empty for accounts with 50+ projects. Refresh to reload.
```

## Source & license

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

- **Author:** [uthumany](https://github.com/uthumany)
- **Source:** [uthumany/uthy-legacy-os](https://github.com/uthumany/uthy-legacy-os)
- **License:** MIT
- **Homepage:** https://uthumany.github.io/uthy-legacy-os/

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-uthumany-uthy-legacy-os-release-notes
- Seller: https://agentstack.voostack.com/s/uthumany
- 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%.