| name | update-store-release-notes |
| description | Update and localize FeedFlow release notes when the user provides platform-specific changelog copy. Use for Android Google Play, iOS App Store, macOS App Store, and Windows Microsoft Store release-note updates, including requests to translate notes for every configured store locale. |
Update FeedFlow Store Release Notes
Use the user-provided copy as the source of truth. Preserve platform-specific wording; do not force one platform's copy onto another.
Workflow
- Inspect the target artifacts, locale set, and current working-tree status before editing.
- Replace the English source and translate it for every configured target locale. Do not invent feature claims or omit user-supplied bullets.
- Keep the writing short, user-facing, and benefit-led. Preserve bullet formatting when supplied.
- Validate the exact artifact format and limits. Run
git diff --check. Run the smallest relevant build or validation only when the changed artifact requires it.
Respect a user request to translate store copy even if general project localization guidance normally delegates translations.
Android: Google Play
-
Write production notes to androidApp/src/googlePlay/play/release-notes/<locale>/production.txt.
-
en-US/production.txt is the English source. Every existing locale directory is a target; create production.txt in empty locale directories.
-
Keep each note at or below 500 characters: wc -m androidApp/src/googlePlay/play/release-notes/*/production.txt.
-
Do not edit alpha.txt unless the user explicitly requests alpha-track notes.
-
Return Android notes in chat as one XML-like block per locale when requested. Use the exact folder name as the tag, keep en-US first, then list the remaining configured locales in alphabetical order:
<en-US>
• English release note
</en-US>
<bg>
• Bulgarian release note
</bg>
iOS and macOS: App Store Connect
- Treat iOS and macOS as separate products: accept and maintain separate platform copy.
- Inspect App Store Connect first to discover the version and its actual localization set. Use
asc to pull the relevant version localizations, update each locale's whatsNew, then pull/validate again to confirm the remote result.
- Use
en-US as the source locale and translate only into locales exposed for that specific product/version. Do not create an App Store task for a locale App Store Connect does not support.
- Use the platform's field limits reported by
asc; shorten translations as needed while retaining all material points.
- Never upload or submit a build as part of a text-only release-note request unless the user explicitly asks.
Windows: Microsoft Store
- Update
assets/storecopy/microsoft-store-release-notes.json.
- Keep the top-level
notes object. Each locale value is an array of non-empty bullet strings; pcenter joins the array with CRLF, which is what the Store renders as line breaks.
- Match every Partner Center listing locale. A Store locale missing from this file is a hard failure at publish time rather than an empty changelog in that language; a locale present here that the Store does not have is only a warning. Matching is case-insensitive. Discover the live set with
pcenter locales list rather than assuming a static list.
- Validate the JSON before finishing, for example with
jq empty assets/storecopy/microsoft-store-release-notes.json.
- This skill's output is the file, nothing more. Writing it is the whole job — the release workflow reads it at release time. Do not publish or commit the Microsoft Store submission unless the user explicitly asks.
Final Report
State the platforms and locale count updated, list any unavailable or unsupported locales, and report the validations actually run.
