asc-notarization

Archive, sign, and notarize macOS apps with xcodebuild and Developer ID.

1|Updated Aug 16, 2025
One-click install
npx skills add https://github.com/barronlroth/Cubby --skill asc-notarization-barronlroth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: asc-notarization
Source: https://github.com/barronlroth/Cubby/tree/main/.agents/skills/asc-notarization
Command: npx skills add https://github.com/barronlroth/Cubby --skill asc-notarization-barronlroth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Archiving, signing, and notarizing macOS apps for distribution outside the App Store can be complex and error-prone, and this guide provides a repeatable process to prepare an app for Apple notarization.

Core Features & Use Cases

  • Preflight: Verify signing identity and trust settings to ensure a smooth notarization process.
  • End-to-end notarization: Archive the app, export with a Developer ID, submit for notarization, and staple once approved.
  • Troubleshooting guide: Includes common issues like missing certificates, failed notary submissions, and timestamping problems.

Quick Start

Submit your signed macOS app for notarization using ASC to begin the process.

Frequently Asked Questions about asc-notarization

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate macOS app notarization with xcodebuild?

You can automate macOS app notarization end-to-end by using xcodebuild to archive, exporting with a Developer ID, submitting via ASC, and stapling once approved. This provides a repeatable process for App Store distribution.

What is needed for macOS app notarization preflight checks?

Preflight checks for macOS app notarization require verifying your Developer ID signing identity and trust settings. This ensures the app meets Apple's security requirements before submission.

Can I use Developer ID signing for macOS apps outside the App Store?

Yes, Developer ID signing is required for macOS apps distributed outside the App Store. You must export with a Developer ID profile, submit for notarization, and staple the approval ticket.

How do I troubleshoot failed notary submissions for a macOS app?

Troubleshooting failed notary submissions involves checking for missing certificates, verifying Developer ID signing, and resolving timestamping problems. The guide provides steps to diagnose and fix these common issues.

Why does macOS app codesigning fail during xcodebuild archive?

macOS app codesigning fails during xcodebuild archive due to missing certificates, incorrect Developer ID trust settings, or timestamping problems. Verifying your signing identity during preflight prevents these errors.