# Generate App Store Release Notes

Release notes often mix technical commits with user-facing changes. This skill collects git history and turns visible changes into clear App Store copy.

## Install

```bash
npx skillstore add dimillian/app-store-changelog
```

## Metadata

- Status: approved
- Slug: dimillian-app-store-changelog
- Skillstore revision: r1
- Version status: missing
- Tree hash: 7f346e7de123ae712e6f9f51d088a7fe11173161f0348bedf8f9ff1bd63b83f8
- Author: Dimillian
- GitHub username: Dimillian
- License: MIT
- Repository: https://github.com/Dimillian/Skills/tree/main/app-store-changelog
- Ref: 72d5025b022c77f7a51bdf5c1637c689c80e89d1
- Supported tools: Claude, Codex, Claude Code
- Audit status: complete
- Agent install advisory: allowed
- Manual install advisory: allowed
- Artifact signature: available
- Audit attestation: unavailable
- Human verification: not\_verified
- Risk factors: external\_commands, filesystem
- Quality score: 72
- Public page: https://skillstore.pages.dev/skills/dimillian-app-store-changelog
- Manifest: https://skillstore.pages.dev/api/skills/dimillian-app-store-changelog/manifest

## Capabilities

- Collects commits and touched files since the last git tag or a specified ref.
- Converts technical commit history into user-facing App Store release notes.
- Filters internal refactors, CI changes, dependencies, and developer-only work.
- Groups visible changes by themes such as New, Improved, and Fixed.
- Checks that each release-note bullet maps to a real change in the selected range.

## Use Cases

- Prepare iOS Release Notes: Turn recent git commits into concise store update bullets before submitting an app update.
- Review User Impact: Separate visible product changes from internal work before a release review meeting.
- Polish Storefront Copy: Rewrite technical change summaries into plain language that users can understand quickly.

## Prompt Templates

### Draft Latest Notes

```
Use app-store-changelog to create App Store release notes from the latest tag to HEAD.
```

### Use Custom Range

```
Generate App Store update text for changes from v1.2.3 to HEAD. Group bullets by New, Improved, and Fixed.
```

### Filter Technical Work

```
Review the collected changes and omit internal refactors, CI updates, dependency changes, and file paths. Keep only user-visible changes.
```

### Produce Final Copy

```
Create final App Store release notes under 1,000 characters. Include only verified user-facing changes and flag any ambiguous commit separately.
```

## Limitations

- Requires a local git repository with accessible history.
- Does not verify app behavior, QA status, or shipped binaries.
- May need human clarification for ambiguous commits or internal-only changes.
- Does not publish releases or update App Store Connect metadata.

## Best Practices

- Run the skill from the repository root so git history and file paths resolve correctly.
- Provide the exact tag or ref range when preparing notes for a specific release.
- Review ambiguous commits with the product owner before finalizing storefront copy.

## Anti Patterns

- Do not include internal ticket IDs, file paths, or implementation names in public notes.
- Do not describe refactors, CI changes, or dependency updates as user-facing improvements.
- Do not publish generated notes without checking that each bullet maps to a real shipped change.

## Security Audit

- Audited at: 2026-07-06T11:57:47.194\+00:00
- Summary: Static command and reconnaissance matches were false positives in context: markdown inline code, local git metadata collection, and guidance to avoid internal details. I found one implementation weakness: the shell helper expands user-supplied git ranges without quoting, which can alter the git log query. No prompt injection, network access, or data exfiltration intent was found.

## Stats

- Views: 197
- Downloads: 7
- Favorites: 0
- Popularity score: 0