> ## Documentation Index
> Fetch the complete documentation index at: https://docs.shipstar.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Announce a release

> Claude Code skill that generates a changelog and release-notes email from your commits, reviews the drafts with you, then publishes and emails subscribers via Shipstar.

`/shipstar:announce-release` turns "we just shipped" into finished release
marketing: your agent generates a public changelog entry and a release-notes
email from the commits you actually pushed, walks the drafts past you, and
only publishes or sends after your explicit approval.

## Install

Via the official Claude Code plugin (bundles the MCP connection):

```
/plugin marketplace add shipstar-ai/shipstar-plugin
/plugin install shipstar@shipstar
```

Or install the skills standalone from your dashboard's Agents page
(`curl -fsSL <APP_URL>/agent-skills/install.sh | sh -s -- <APP_URL>`).

## When to use it

Say any of: "announce my latest release", "we shipped v2.1 — run the release
marketing", "write the changelog for this week and email subscribers".

## What the agent does

1. Calls [`get_project_context`](/mcp/project/get-project-context) to confirm
   GitHub is connected and work out the commit window (since the last
   published changelog, or the range you name).
2. Kicks off [`generate_changelog`](/mcp/generation/generate-changelog) and —
   if mailing lists with active recipients exist —
   [`generate_release_notes_email`](/mcp/generation/generate-release-notes-email),
   passing any audience or scope guidance you gave ("keep it non-technical",
   "only the API repo").
3. Polls [`get_generation_status`](/mcp/lifecycle/get-generation-status),
   then shows you each draft in full and applies your edits with
   [`update_content`](/mcp/lifecycle/update-content).
4. Publishes and sends **only on your explicit confirmation**, via
   [`approve_content`](/mcp/lifecycle/approve-content) /
   [`publish_content`](/mcp/lifecycle/publish-content) and
   [`send_release_email`](/mcp/email/send-release-email).

## Requirements

* Shipstar MCP server connected (see [Set up Shipstar](/mcp/skills/setup-shipstar))
* GitHub connected with at least one tracked repository
* Mailing lists with active recipients, if you want the email half

The full skill definition is plain markdown:
[`SKILL.md`](https://app.shipstar.ai/agent-skills/announce-release/SKILL.md).