Agent skill · software engineering · steipete
release-mac-app
macOS app release: Sparkle, notarization, GitHub Release, Homebrew, closeout.
Why this skill is useful
Adds 8 executable scripts for macOS app release processes that automate Sparkle updates, notarization, and GitHub releases.
What it needs
Requires tmux installed locally. Requires 1password account access. About 4k tokens when loaded. Last updated 2026-08-06. 6,510 stars on the source repository.
What this skill does
Mac App Release Use for BlackBar, RepoBar, CodexBar, Trimmy, and similar Sparkle-updated macOS apps. Rules Work from the app repo. Read .mac-release.env; it is the repo-owned release manifest. Use scripts/mac-release from this skill for shared release/appcast/verify work. Execute mac-release directly so its privileged Bash shebang ignores startup hooks; if an explicit interpreter is unavoidable, use /bin/bash -p, never plain bash mac-release. Keep app-specific build/package/sign behavior in repo scripts unless it is already manifest-driven. Never print private key material. Upload app/dSYM assets to a draft before publication. After a failure, preserve the release, tags, appcast commit, and local edits; inspect existing state and resume the failed step instead of deleting or retagging a possibly published release. Prefer MACRELEASESPARKLEOPREF for headless release signing when the key is in 1Password; otherwise prefer Keychain Sparkle signing. SPARKLEPRIVATEKEYFILE is an explicit local override only. Commands verify-appcast uses only SUPublicEDKey; it needs no private key, Keychain, or 1Password access. Manifest Each repo owns .mac-release.env. It must contain no secrets. Required: MACRELEASEAPPNAME MACRELEASEREPO MACRELEASEBUNDLEID MACRELEASEVERSIONFILE MACRELEASEAPPCAST MACRELEASEFEEDURL MACRELEASEDOWNLOADURLPREFIX MACRELEASEAPPZIP either MACRELEASEINFOPLIST or MACRELEASESUPUBLICEDKEY MACRELEASEPACKAGECMD is required only for release; status, notes, changelog-html, verify-appcast, and check-assets do not need it. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills steipete/release-mac-app