skilld
All skills
dimillian avatar

/app-store-changelog

@3db84e6 official
by Thomas Ricouarddimillian/skills4k stars
206

Create user-facing App Store release notes by collecting and summarizing all user-impacting changes since the last git tag (or a specified ref). Use when asked to generate a comprehensive release changelog, App Store "What's New" text, or release notes based on git history or tags.

Ask your Agent

Use this Skill: https://skilld.dev/gh/dimillian/skills/app-store-changelog

This session only. Nothing lands on disk.

SKILL.md

≈76 tokens always: the name and description. ≈660 when used: this file. ≈467 more on demand in 2 files.

App Store Changelog

Overview

Generate a comprehensive, user-facing changelog from git history since the last tag, then translate commits into clear App Store release notes.

Workflow

1) Collect changes

  • Run scripts/collect_release_changes.sh from the repo root to gather commits and touched files.
  • If needed, pass a specific tag or ref: scripts/collect_release_changes.sh v1.2.3 HEAD.
  • If no tags exist, the script falls back to full history.

2) Triage for user impact

  • Scan commits and files to identify user-visible changes.
  • Group changes by theme (New, Improved, Fixed) and deduplicate overlaps.
  • Drop internal-only work (build scripts, refactors, dependency bumps, CI).

3) Draft App Store notes

  • Write short, benefit-focused bullets for each user-facing change.
  • Use clear verbs and plain language; avoid internal jargon.
  • Prefer 5 to 10 bullets unless the user requests a different length.

4) Validate

  • Ensure every bullet maps back to a real change in the range.
  • Check for duplicates and overly technical wording.
  • Ask for clarification if any change is ambiguous or possibly internal-only.

Commit-to-Bullet Examples

The following shows how raw commits are translated into App Store bullets:

Raw commit message App Store bullet
fix(auth): resolve token refresh race condition on iOS 17 • Fixed a login issue that could leave some users unexpectedly signed out.
feat(search): add voice input to search bar • Search your library hands-free with the new voice input option.
perf(timeline): lazy-load images to reduce scroll jank • Scrolling through your timeline is now smoother and faster.

Internal-only commits that are dropped (no user impact):

  • chore: upgrade fastlane to 2.219
  • refactor(network): extract URLSession wrapper into module
  • ci: add nightly build job

Example Output

What's New in Version 3.4

• Search your library hands-free with the new voice input option.
• Scrolling through your timeline is now smoother and faster.
• Fixed a login issue that could leave some users unexpectedly signed out.
• Added dark-mode support to the settings screen.
• Improved load times when opening large photo albums.

Output Format

  • Title (optional): "What's New" or product name + version.
  • Bullet list only; one sentence per bullet.
  • Stick to storefront limits if the user provides one.

Resources

  • scripts/collect_release_changes.sh: Collect commits and touched files since last tag.
  • references/release-notes-guidelines.md: Language, filtering, and QA rules for App Store notes.

Source: SKILL.md on GitHub

Third-party checks

1 warning16d5 checks · Risk SAFE
  • Gen Agent Trust Hub16d

    The skill is safe for its intended use, but it is susceptible to indirect prompt injection. A malicious contributor could craft git commit messages containing instructions that might trick the AI into generating biased or incorrect release notes.

  • Socket16d

    No alerts

  • Snyk16d

    Risk: LOW · No issues

  • Runlayer6mo

    3/4 files flagged

  • ZeroLeaks5mo

    Score: 93/100 · 2 sections analyzed

Provenance

Signed by skilld at 3db84e6. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 months ago.

Dormantupdated 7 months ago

Topics

  • Git/VCS
  • changelog
  • release-notes
  • app-store
  • ios
  • versioning
  • commit-history

README badge

README badge for dimillian/skills/app-store-changelog

What it does

Generates user-facing App Store release notes by extracting commits since the last git tag and filtering for user-visible changes. Groups changes by theme (New, Improved, Fixed) and translates them into clear, benefit-focused bullets suitable for storefront submission.

Generated from the current SKILL.md.

Frequently asked

Does this skill work with monorepos or multi-target apps?
The skill collects all commits in the specified git range and touched files. You can filter the output manually or pass specific refs to `collect_release_changes.sh`, but the skill does not have built-in filtering for monorepo paths or per-target changelogs.
What if the repo has no git tags?
The `collect_release_changes.sh` script falls back to full git history if no tags exist. You can also specify a custom ref or tag range to narrow the scope.
Does this generate changelogs for internal release notes or only App Store?
The skill is designed for user-facing App Store release notes. It filters out internal-only changes (build scripts, refactors, CI), but you can adapt the output format for other storefront or internal documentation needs.
How does the skill decide what counts as user-impacting?
The skill scans commit messages and touched files to identify user-visible changes, then groups them by theme (New, Improved, Fixed) and drops commits marked as chore, refactor, or CI. Ambiguous changes are flagged for manual clarification.

Generated from the current SKILL.md. These answers refresh after source changes.