common-store-changelog
Installation
SKILL.md
Store Changelog Standard
Priority: P1
Always-Apply Rules
- Character limits: App Store ≤ 4000 chars. Google Play ≤ 500 chars — validate before output.
- Benefit language: Write what user gains, not what code changed. "Faster checkout" not "refactored cart service".
- Bullet-only format: One sentence per bullet. No paragraphs. No headers inside notes.
- Drop internal commits: Exclude
chore,refactor,ci,build,test, dependency bumps, and config changes — no user impact. - Deduplicate: Merge commits touching same feature into one bullet.
Workflow
- Collect: Run
git log <last-tag>..HEAD --oneline(or use provided commit list). If no tag exists, use full history. - Triage: Scan commits and touched files. Group by theme:
New,Improved,Fixed. Drop internal-only. - Draft — App Store: Write 5–10 benefit-focused bullets. Optional
What's New in [Version]header. - Draft — Google Play: Compress App Store draft to ≤ 500 chars. Prioritise top 3–5 user-facing changes.
- Validate: Count characters per store. Check every bullet maps to real commit. Remove jargon.