Agent skill

macOS Release

by fayazara in fayazara/macos-app-skills

Release a native macOS app to GitHub with DMG packaging and Sparkle appcast updates.

No licenceAuto-check passedMobile

Install macOS Release

skills CLI
$ npx skills add fayazara/macos-app-skills --skill macos-release -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install fayazara/macos-app-skills macos-release --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/fayazara/macos-app-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/release .claude/skills/macos-release && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
macos-release
GitHub stars
676
Token cost
~1.8k tokens
SKILL.md length
650 words
Files
4
Skills in repo
4
Repo updated
First seen
Licence
None found

At a glance

Release a native macOS app to GitHub with DMG packaging and Sparkle appcast updates.

  • Works in 8 steps: Bump Version Numbers → Archive in Xcode → Notarize and Export → …
  • The user wants to publish a new version
  • SKILL.md covers Release Pipeline Overview, Prerequisites, Step-by-Step Release Guide and Automating the Pipeline, plus 3 more sections
  • Runs Go scripts from its folder; calls git, gh and go; reaches github.com and raw.githubusercontent.com

What it does

macOS Release is an agent skill from fayazara/macos-app-skills. Release a native macOS app to GitHub with DMG packaging and Sparkle appcast updates. Use this skill whenever the user wants to publish a new version, create a release, ship an update, push a release to GitHub, or update the appcast. Also trigger when the user mentions DMG creation, Sparkle signing, notarization, archiving, or anything related to distributing a new version of their macOS app. This covers the full release pipeline: archive, notarize, export, create DMG, sign with Sparkle EdDSA, update appcast.xml…

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files (for example `cli/release.example.json`).

It sits in Mobile. It works with macOS, GitHub, Git and Xcode. The repository describes itself as: AI coding agent skills for building, shipping, and maintaining native macOS apps.

When your agent uses it

  • The user wants to publish a new version
  • Create a release
  • Push a release to GitHub
  • Update the appcast

Example prompts

  • “/macos-release”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Bump Version Numbers
  2. Archive in Xcode
  3. Notarize and Export
  4. Create DMG
  5. Sign DMG with Sparkle
  6. Update appcast.xml
  7. Commit and Push Appcast
  8. Create GitHub Release

What it can do on your machine

Read from SKILL.md and the folder at commit a60365a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Go), which the agent can run.

    Shell commands in SKILL.md call:

    • git
    • gh
    • go
    • brew

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • github.com
    • raw.githubusercontent.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

macOS Release loads about 1.8k tokens when it runs. Until then it costs about 143 tokens; SKILL.md has 650 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~143
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 650 words (~1,813 tokens).

“This skill covers the full release pipeline for distributing a native macOS app outside the Mac App Store via GitHub Releases with Sparkle auto-update support.”

— opening of SKILL.md by fayazara
name
macos-release

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files in release of fayazara/macos-app-skills.

  • SKILL.md
  • cli/main.go
  • cli/main_test.go
  • cli/release.example.json

Open the folder on GitHubat commit a60365a

Compare with similar skills

macOS Release next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

macOS Release compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
macOS Release this skillfayazara/macos-app-skills676—~1.8kAutomated safety check: PassNone
Releasenotepadqq/notepadqq2.3k—~2kAutomated safety check: PassGPL-3.0
Release Screendropfayazara/Screendrop2.1k—~2.1kAutomated safety check: PassCC0-1.0
Release Kazefayazara/Kaze179—~1.9kAutomated safety check: PassMIT
Tusk ReleaseShape-Machine/tusk-macos126—~822Automated safety check: PassCustom licence
Build Afmscouzi1966/maclocal-api346—~1.8kAutomated safety check: NotesMIT

Similar skills

  • Release

    notepadqq/notepadqq

    Release a new Notepadqq version. An agent skill from notepadqq/notepadqq.

    2.3k GitHub stars~2k tokensUpdated 3 days ago
    MobileAuto-check passed
  • Release Screendrop

    fayazara/Screendrop

    Release the Screendrop macOS app to GitHub using the screendrop-release CLI tool.

    2.1k GitHub stars~2.1k tokensUpdated 7 days ago
    MobileAuto-check passed
  • Release Kaze

    fayazara/Kaze

    Release the Kaze macOS app to GitHub using the kaze-release CLI tool.

    179 GitHub stars~1.9k tokensUpdated today
    MobileAuto-check passed
  • Tusk Release

    Shape-Machine/tusk-macos

    A skill your agent uses when preparing a full Tusk macOS release: bump the app version, regenerate the Xcode project, build and package the DMG, publish the GitHub release, and update README links.

    126 GitHub stars~822 tokensUpdated 4 mo ago
    MobileAuto-check passed
  • Build Afm

    scouzi1966/maclocal-api

    Build AFM from scratch — submodules, patches, webui, and Swift build.

    346 GitHub stars~1.8k tokensUpdated today
    MobileAuto-check: notes
  • Build Run Debug

    robinebers/openusage

    Build, run, and debug local macOS apps and desktop executables using shell-first Xcode and Swift workflows.

    4.3k GitHub stars~1.8k tokensUpdated 3 days ago
    MobileAuto-check passed

More from fayazara/macos-app-skills

  • macOS Auto Update

    fayazara/macos-app-skills

    Add Sparkle auto-update support to a native macOS app. An agent skill from fayazara/macos-app-skills.

    676 GitHub stars~1.8k tokensUpdated 4 mo ago
    Auto-check passed
  • macOS Settings UI

    fayazara/macos-app-skills

    Build a proper macOS settings/preferences window with liquid glass support for macOS 26 (Tahoe).

    676 GitHub stars~2.2k tokensUpdated 4 mo ago
    Auto-check passed
  • macOS Patterns

    fayazara/macos-app-skills

    Essential native macOS development patterns that web developers don't know about.

    676 GitHub stars~4.6k tokensUpdated 4 mo ago
    Auto-check passed

Questions about macOS Release

What does macOS Release do?

Release a native macOS app to GitHub with DMG packaging and Sparkle appcast updates. macOS Release is an agent skill from fayazara/macos-app-skills. Release a native macOS app to GitHub with DMG packaging and Sparkle appcast updates.

When should I use macOS Release?

macOS Release fits situations like: the user wants to publish a new version; create a release; push a release to GitHub; update the appcast.

How do I install macOS Release in Claude Code?

Run `npx skills add fayazara/macos-app-skills --skill macos-release -a claude-code`. Or copy the skill folder (release in fayazara/macos-app-skills) into .claude/skills/macos-release in your project. Claude Code loads it when a task matches its description.

How do I install macOS Release in Codex?

Run `npx skills add fayazara/macos-app-skills --skill macos-release -a codex`. Or copy the skill folder (release in fayazara/macos-app-skills) into .agents/skills/macos-release in your project. Codex loads it when a task matches its description.

Can I use macOS Release in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add fayazara/macos-app-skills --skill macos-release -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/macos-release, .gemini/skills/macos-release, .github/skills/macos-release and .opencode/skills/macos-release in your project.

What does macOS Release need to run?

Going by SKILL.md and its folder, macOS Release needs Go for the scripts in its folder and the command-line tools its instructions call (git, gh, go and brew).

Does macOS Release access the network?

SKILL.md names 2 domains. In commands or code: github.com and raw.githubusercontent.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is macOS Release safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does macOS Release use?

No licence was found for macOS Release or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does macOS Release use?

About 1.8k tokens (SKILL.md is roughly 7.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to macOS Release?

Skills that share tags, products or a category with macOS Release: Release (notepadqq/notepadqq, 2.3k stars), Release Screendrop (fayazara/Screendrop, 2.1k stars), Release Kaze (fayazara/Kaze, 179 stars) and Tusk Release (Shape-Machine/tusk-macos, 126 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains macOS Release?

fayazara (a GitHub user) maintains it in fayazara/macos-app-skills, which has 676 GitHub stars. The repository holds 4 skills in this directory. The repository was last updated on May 27, 2026.

Source: fayazara/macos-app-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.