# Asc Whats New Writer

Generate engaging, localized App Store release notes (What's New) from git log, bullet...

- Repository: https://github.com/rorkai/app-store-connect-cli-skills (1119 stars)
- Category: Mobile
- License: MIT
- Last updated: 2026-10-26
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add rorkai/app-store-connect-cli-skills --skill asc-whats-new-writer -g -a claude-code -y`
Codex: `npx skills add rorkai/app-store-connect-cli-skills --skill asc-whats-new-writer -g -a codex -y`
Cursor: `npx skills add rorkai/app-store-connect-cli-skills --skill asc-whats-new-writer -g -a cursor -y`
Gemini CLI: `npx skills add rorkai/app-store-connect-cli-skills --skill asc-whats-new-writer -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add rorkai/app-store-connect-cli-skills`

## Description

Generate engaging, localized App Store release notes (What's New) from git log, bullet points, or free text using canonical metadata under `./metadata`. Optionally pairs with promotional text updates.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# asc What's New Writer

Generate engaging, localized release notes from flexible input. Optionally pair with promotional text updates.

## Preconditions

- Metadata pulled locally into canonical files via `asc metadata pull --app "APP_ID" --version "1.2.3" --dir "./metadata"`. OR: user provides keywords manually.
- Auth configured for upload (`asc auth login` or `ASC_*` env vars).
- The **primary locale** is `en-US` unless the user specifies otherwise.

## Before You Start

1. Read `references/release_notes_guidelines.md` for tone, structure, and examples.
2. Identify the **latest version directory** under `metadata/version/` (highest semver). Use this for all metadata reads.
3. Enumerate **existing locales** by listing the JSON files in that version directory.

## Phase 1: Gather Input

Accept one of three input modes (auto-detect):

### Git Log

Parse commits since the last tag:

```bash
# Find latest tag
git describe --tags --abbrev=0

# List commits since that tag
git log $(git describe --tags --abbrev=0)..HEAD --oneline --no-merges
```

Filter out noise: merge commits, dependency bumps, CI changes, formatting-only commits. Extract user-facing changes.

### Bullet Points

User provides rough bullets like:
- "improved search"
- "fixed crash on launch"
- "added sleep timer"

### Free Text

User describes changes conversationally:
> "We made search faster, fixed that annoying crash when you open the app, and added a sleep timer feature"

The skill extracts and structures the changes from the text.

### No Input Provided

Prompt the user: "What changed in this release? You can paste git log output, bullet points, or just describe the changes."

## Phase 2: Draft Notes (Primary Locale)

### Step 1: Classify Changes

Group changes into sections per the guidelines:
- **New**, new features or capabilities
- **Improved**, enhancements to existing features
- **Fixed**, bug fixes users would notice

Omit empty sections. If all changes are fixes, only show "Fixed."

The rest: https://github.com/rorkai/app-store-connect-cli-skills/blob/HEAD/skills/asc-whats-new-writer/SKILL.md