asc-notarization

Archive, sign, and notarize macOS apps with xcodebuild and asc.

32|10|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/moasq/nanowave --skill asc-notarization-moasq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: asc-notarization
Source: https://github.com/moasq/nanowave/tree/main/internal/orchestration/skills/features/asc-notarization
Command: npx skills add https://github.com/moasq/nanowave --skill asc-notarization-moasq

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the complex process of archiving, exporting, and notarizing macOS applications, ensuring they meet Apple's security requirements for distribution outside the App Store.

Core Features & Use Cases

  • Automated Archiving: Uses xcodebuild archive to create a release build.
  • Developer ID Export: Configures and exports the app bundle signed with a Developer ID certificate.
  • Notarization Submission: Submits the signed application (as a zip or pkg) to Apple's notary service.
  • Status Checking & Logging: Provides mechanisms to track notarization status and retrieve detailed logs for troubleshooting.
  • Stapling: Attaches the notarization ticket to the app or disk image for offline validation.
  • Use Case: You've finished developing your macOS app and need to distribute it to users via your website. This Skill will guide you through preparing the app, getting it notarized by Apple, and making it ready for download.

Quick Start

Use the asc-notarization skill to archive, export, and notarize your macOS app named 'YourMacApp' using the 'YourMacScheme' scheme.

Frequently Asked Questions about asc-notarization

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

FAQPage Schema
How do I notarize a macOS app for distribution outside the Mac App Store?

To notarize a macOS app, you archive it with xcodebuild, export it with a Developer ID certificate, and submit it to Apple's notary service using the asc command-line tool. This workflow prepares your app for secure direct download distribution.

What is the process for exporting a macOS app with Developer ID signing?

Exporting with Developer ID signing requires validating your signing identities and creating specific export options. The skill configures these steps automatically, ensuring your app bundle is correctly signed for distribution outside the Mac App Store.

Can I staple a notarization ticket to my macOS app after submission?

Yes, you can staple a notarization ticket to your app or disk image. This attaches the notarization ticket directly to the application, allowing offline validation and ensuring users can run the app without an active network connection.

How do I check the status of my macOS app notarization submission?

You can check notarization status and retrieve detailed logs for troubleshooting. The skill provides mechanisms to track the submission progress and fetch logs from Apple's notary service to diagnose any issues during the process.

Do I need an App Store Connect account and Developer ID to use this notarization workflow?

Yes, you need a Developer ID certificate and App Store Connect access to use this workflow. The process validates your signing identities and submits packages to Apple's notary service, both of which require an active Apple Developer account.

Why does my macOS app need notarization before users can download it?

macOS apps need notarization to meet Apple's security requirements for distribution outside the App Store. Notarization verifies the app is free from malicious components, allowing it to run on macOS without triggering Gatekeeper warnings for users.