This handles the full macOS notarization pipeline: archive your app with xcodebuild, export it with Developer ID signing, zip it up, and submit it to Apple's notarization service using the asc CLI. It covers the annoying edge cases like broken trust settings on certificates and missing secure timestamps that can derail a release. The skill uses the newer Notary API v2 instead of notarytool, supports streaming uploads for large files, and includes practical commands for checking status and debugging failures through Apple's developer logs. If you distribute Mac apps outside the App Store, this gives you the complete workflow in one place instead of hunting through Apple's documentation every time.

skills.sh installs
2.1K
GitHub stars
904
last updated
Jul 14, 2026

Install

$ npx -y skills add rudrankriyam/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/rudrankriyam/app-store-connect-cli-skills
Categories
Mobile Development, CLI & Terminal

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

All 31
1rudrankriyam avatarasc-subscription-localizationrudrankriyam/app-store-connect-cli-skillsasc subscription localization2.1Kskills.sh installs
2rudrankriyam avatarasc-app-create-uirudrankriyam/app-store-connect-cli-skillsasc app create ui2Kskills.sh installs
3rudrankriyam avatarasc-localize-metadatarudrankriyam/app-store-connect-cli-skillsasc localize metadata2Kskills.sh installs
4rudrankriyam avatarasc-crash-triagerudrankriyam/app-store-connect-cli-skillsasc crash triage1.7Kskills.sh installs
5rudrankriyam avatarasc-wall-submitrudrankriyam/app-store-connect-cli-skillsasc wall submit1.5Kskills.sh installs
6rudrankriyam avatarasc-aso-auditrudrankriyam/app-store-connect-cli-skillsasc aso audit1.4Kskills.sh installs