publish-macos

Automate macOS release workflows from version bump to publishing.

Updated Mar 19, 2026
One-click install
npx skills add https://github.com/LarryHsiao/Skadi --skill publish-macos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: publish-macos
Source: https://github.com/LarryHsiao/Skadi/tree/main/skills/publish-macos
Command: npx skills add https://github.com/LarryHsiao/Skadi --skill publish-macos

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates end-to-end macOS release workflows from version bump to release publishing, eliminating manual, error-prone steps.

Core Features & Use Cases

  • End-to-end release automation: bumps version, commits, pushes, builds, exports, signs, and publishes releases for macOS apps.
  • Per-project publish targets: remembers whether to publish to GitHub Releases or App Store Connect and applies consistently.
  • Scheme detection & build orchestration: auto-detects Xcode schemes, chooses the appropriate workspace or project, and coordinates archiving and packaging.
  • Secure signing & notarization: handles Apple credentials, signing configurations, and notarization steps for Gatekeeper compliance.
  • Workflow guardrails: supports a --no-bump option to skip versioning/pushes, prompts for missing credentials, and stops on failures with clear logs.

Quick Start

Run the publish-macos skill to bump the version, build, sign, and publish the configured macOS release to your target.

Frequently Asked Questions about publish-macos

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

FAQPage Schema
How do I automate macOS app releases from build to publishing?

Automating macOS app releases uses a script-driven process to bump versions, build Xcode projects, sign artifacts, and publish to GitHub or App Store Connect. It detects schemes automatically and applies per-project state files for consistent results.

How does code signing and notarization work for Xcode releases?

Code signing and notarization for Xcode releases work by handling Apple credentials, applying signing configurations, and executing notarization steps. This ensures Gatekeeper compliance before publishing the exported macOS app artifact.

Can I skip the version bump when running a macOS release workflow?

Yes, you can skip the version bump during a macOS release workflow by using the --no-bump option. This mode bypasses versioning, commits, and pushes, allowing you to build and publish without modifying the project state.

Does the macOS release process support both GitHub and App Store Connect?

Yes, the macOS release process supports both GitHub Releases and App Store Connect. It resolves per-project publish targets and remembers your configuration to apply the destination consistently across future workflows.

What happens if credentials are missing during macOS app notarization?

If credentials are missing during macOS app notarization, the workflow prompts for the required Apple credentials. It uses guarded steps that halt on failure, providing clear logs to ensure secure and successful Gatekeeper compliance.