About

Imported from terminalskills/skills (skills/app-store-changelog/SKILL.md). Install upstream with npx skills add terminalskills/skills --skill app-store-changelog. Copyright stays with the author (MIT).

App Store Changelog

Name: app-store-changelog
Author: terminalskills

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.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/terminalskills-skills-app-store-changelog/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

terminalskills-skills-app-store-changelog.ocm.jsonjson

{
  "ocm": "1",
  "id": "terminalskills-skills-app-store-changelog",
  "kind": "skill",
  "name": "app-store-changelog",
  "description": "Generate App Store release notes from git history. Use when: creating release changelogs, App Store 'What's New' text, or summarizing changes since last tag.",
  "publisher": "terminalskills",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "app-store",
      "changelog",
      "release-notes",
      "ios",
      "android",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Generate App Store release notes from git history. Use when: creating release changelogs, App Store 'What's New' text, or summarizing changes since last tag."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/terminalskills/skills",
      "path": "skills/app-store-changelog/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/terminalskills/skills/blob/HEAD/skills/app-store-changelog/SKILL.md",
      "key": "terminalskills/skills/skills/app-store-changelog/SKILL.md"
    },
    "compatibility": "iOS/Android projects with git tags",
    "license": "MIT"
  },
  "instructions": "# App Store Changelog\n\n## Overview\nGenerate a comprehensive, user-facing changelog from git history since the last tag, then translate commits into clear App Store release notes.\n\n## Workflow\n\n### 1) Collect changes\n- Run `scripts/collect_release_changes.sh` from the repo root to gather commits and touched files.\n- If needed, pass a specific tag or ref: `scripts/collect_release_changes.sh v1.2.3 HEAD`.\n- If no tags exist, the script falls back to full history.\n\n### 2) Triage for user impact\n- Scan commits and files to identify user-visible changes.\n- Group changes by theme (New, Improved, Fixe",
  "cost": {
    "context_tokens": 655
  }
}

Fetch it by URL: GET /api/v1/registry/terminalskills-skills-app-store-changelog/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.