asc-whats-new-writer

Generate localized App Store What's New release notes from git log or free text.

70|4|Updated Jul 22, 2025
One-click install
npx skills add https://github.com/AlexW00/Zettel --skill asc-whats-new-writer-alexw00
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: asc-whats-new-writer
Source: https://github.com/AlexW00/Zettel/tree/main/.agents/skills/asc-whats-new-writer
Command: npx skills add https://github.com/AlexW00/Zettel --skill asc-whats-new-writer-alexw00

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Writing engaging, localized App Store release notes for every locale is repetitive and easy to get wrong — most teams ship generic "bug fixes and improvements" text that wastes the conversion opportunity of the 170-character visible window. ## Core Features & Use Cases - Flexible Input Parsing: Accepts git log output since the last tag, rough bullet points, or conversational free text, and structures changes into New, Improved, and Fixed sections. - Localized Drafting: Translates approved notes into all existing locales with formal register, cultural adaptation, and locale-specific keyword echo from canonical metadata files. - Review and Upload Workflow: Presents a per-locale summary table with character counts, waits for approval, then uploads via the asc CLI with partial-failure handling. - Use Case: After merging a release branch, run the skill to turn commits since the last tag into polished en-US release notes, auto-localize them into German, French, and Japanese, and push everything to App Store Connect in one flow. ## Quick Start Generate App Store What's New notes from the commits since my last git tag and localize them into all existing locales under ./metadata.

Frequently Asked Questions about asc-whats-new-writer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I write App Store release notes from git commits?▼

Provide git log output since the last tag, and the skill filters out merge commits, dependency bumps, and CI noise, then groups user-facing changes into New, Improved, and Fixed sections. It drafts benefit-focused copy with a strong first 170 characters before localizing.

How do I localize App Store What's New text into multiple languages?▼

The skill enumerates existing locales from JSON files under metadata/version/{latest}/ and translates the approved primary-locale draft into each one. It uses formal register, adapts idioms culturally, and echoes locale-specific keywords from each locale's metadata file.

What is the character limit for App Store What's New and promotional text?▼

What's New allows up to 4,000 characters, but the skill targets 500-1500 in the primary locale to leave room for 30-40% expansion in translation. Promotional text is limited to 170 characters and can be updated without a new app submission.

Does What's New text affect App Store search ranking?▼

No, What's New is not indexed for App Store search, so the skill writes purely for conversion rather than SEO. Keywords are echoed naturally only to reassure users they found the right app, never stuffed.

Can I upload release notes to App Store Connect without a new submission?▼

What's New requires a new version submission, but promotional text is the only metadata field updatable without one. The skill uploads via asc apps info edit per locale or asc metadata push for bulk canonical metadata updates.