This handles the full macOS notarization pipeline: archiving with xcodebuild, exporting with Developer ID signing, zipping the bundle, and submitting to Apple's notary service using the asc CLI. It covers the annoying preflight checks like verifying your signing identity and fixing broken certificate trust settings that can silently break codesigning. The skill walks through each step with actual commands, including how to poll for results, fetch developer logs when things fail, and staple the notarization ticket for offline verification. If you're distributing a Mac app outside the App Store and need to get past Gatekeeper, this is the checklist.

skills.sh installs
6.9K
GitHub stars
1.1K
last updated
Aug 21, 2026

Install

$ npx -y skills add rorkai/app-store-connect-cli-skills --skill asc-notarization --agent claude-code

Installs into .claude/skills of the current project.

Files

macOS Notarization

Use this skill when you need to notarize a macOS app for distribution outside the App Store.

Preconditions

  • Xcode installed and command line tools configured.
  • Auth is configured (asc auth login or ASC_* env vars).
  • A Developer ID Application certificate in the local keychain.
  • The app's Xcode project builds for macOS.

Preflight: Verify Signing Identity

Before archiving, confirm a valid Developer ID Application identity exists:

security find-identity -v -p codesigning | grep "Developer ID Application"

If no identity is found, create one at https://developer.apple.com/account/resources/certificates/add (the App Store Connect API does not support creating Developer ID certificates).

Inspect Trust Settings

If codesign or xcodebuild fails with "Invalid trust settings" or "errSecInternalComponent", the certificate may have custom trust overrides that break the chain:

# Check for custom trust settings
security dump-trust-settings 2>&1 | grep -A1 "Developer ID"

Sponsors

Details

Repository
github.com/rorkai/app-store-connect-cli-skills
Categories
Mobile Development, CLI & Terminal
First seen
Jun 3, 2026

More from rorkai/app-store-connect-cli-skills

All 23
1rorkai avatarasc-crash-triagerorkai/app-store-connect-cli-skillsTriage TestFlight crashes, beta feedback, and performance diagnostics using asc. Use when the user asks about TF crashes, TestFlight crash reports, beta tester 6.6Kskills.sh installs
2rorkai avatarasc-aso-auditrorkai/app-store-connect-cli-skillsRun an offline ASO audit on canonical App Store metadata under `./metadata` and surface keyword gaps using Astro MCP. Use after pulling metadata with `asc metad6.4Kskills.sh installs
3rorkai avatarasc-revenuecat-catalog-syncrorkai/app-store-connect-cli-skillsReconcile App Store Connect subscriptions and in-app purchases with RevenueCat products, entitlements, offerings, and packages using asc and RevenueCat MCP. Use6.3Kskills.sh installs
4rorkai avatarasc-wall-submitrorkai/app-store-connect-cli-skillsSubmit or update a Wall of Apps entry in the App-Store-Connect-CLI repository using `asc apps wall submit`. Use when the user says "submit to wall of apps", "ad6Kskills.sh installs
5rorkai avatarasc-whats-new-writerrorkai/app-store-connect-cli-skillsGenerate engaging, localized App Store release notes (What's New) from git log, bullet points, or free text using canonical metadata under `./metadata`. Optiona5.9Kskills.sh installs
6rorkai avatarasc-screenshot-resizerorkai/app-store-connect-cli-skillsResize and validate App Store screenshots with current asc screenshot-size data and macOS sips. Use when preparing or fixing screenshots for App Store Connect s5.3Kskills.sh installs