notarization

Archive, sign, and notarize macOS apps with Xcodebuild and Apple Notary API.

37|12|Updated Feb 24, 2026
One-click install
npx skills add https://github.com/exiao/skills --skill notarization
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notarization
Source: https://github.com/exiao/skills/tree/main/app-store-connect/notarization
Command: npx skills add https://github.com/exiao/skills --skill notarization

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

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

Core Features & Use Cases

  • Automated Archiving: Uses xcodebuild archive to create a build archive.
  • Developer ID Export: Exports the app bundle signed with a Developer ID certificate.
  • Notarization Submission: Submits the signed app (as a ZIP, DMG, or PKG) to Apple's notary service.
  • Status Checking & Logging: Provides tools to check notarization status and retrieve detailed logs for troubleshooting.
  • Stapling: Optionally staples the notarization ticket to the app or disk image.
  • Use Case: You have developed a macOS utility and need to distribute it directly to users. This skill will guide you through the steps to get it signed and notarized by Apple.

Quick Start

Use the notarization skill to archive, export with Developer ID, and submit your macOS app named 'YourApp' for notarization.

Frequently Asked Questions about 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 App Store?

You can automate macOS app notarization by archiving with xcodebuild, exporting with Developer ID signing, and submitting the bundle to Apple's notary service for approval and optional ticket stapling.

When do I need Developer ID signing and notarization for my macOS application?

You need Developer ID signing and notarization when distributing macOS applications directly to users outside the Mac App Store to verify the app meets Apple's security requirements.

What file formats are supported for submitting a macOS app to Apple's notary service?

Apple's notary service accepts macOS app submissions packaged as ZIP, DMG, or PKG formats, allowing flexible distribution options for your Developer ID-signed application bundles.

Why does macOS notarization fail and how do I troubleshoot common errors?

Notarization often fails due to missing or invalid signing identities, which can be caught with preflight checks; you can retrieve detailed logs from the Notary API to troubleshoot common errors.

Does this notarization process support checking submission status and stapling the ticket?

Yes, the notarization process includes checking the submission status via the Apple Notary API and optionally stapling the approved notarization ticket directly to your app or disk image.