macos-direct-distribution SKILL.md skillA

macos-direct-distribution from yybd/app-factory is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add yybd/app-factory/macos-direct-distribution@git:20261021.202b5c1

Pins git:20261021.202b5c1 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
yybd/app-factory
Path
plugins/apple-track/skills/macos-direct-distribution/SKILL.md
Versions recorded
4
Latest version
git:20261021.202b5c1, committed Oct 21, 2026
First version recorded
Sep 29, 2026
Size
12,579 bytes
Repository stars
5
License
MIT

Set up direct (outside the Mac App Store) distribution for a macOS Xcode app: a dedicated "Direct" target — sandbox off, hardened runtime on, a DIRECT flag, direct-only frameworks linked to it alone — wired to Sparkle auto-updates with EdDSA signing keys, a SUFeedURL, a "Check for Updates" menu item and an appcast signing script — and, for selling that build, a licence key from a hosted checkout, kept out of the App Store build. Use whenever the user wants automatic updates for a Mac app sold…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Direct distribution + auto-updates for a macOS app

Give a macOS app a second distribution channel — a notarized DMG downloaded from
your own site — that lives **alongside** the App Store build from one codebase,
and updates itself via Sparkle. This skill creates the build target and the
update mechanism; the **notarize-and-distribute** skill builds the signed DMG.

The hard part is keeping the two channels cleanly separated. The key constraint:
**a linked framework is embedded per-target, not per-configuration**, so keeping
Sparkle out of the App Store build (required by Guideline 2.4.5) means the direct
build needs its own *target*, not just a build config. See
[references/xcode-target.md](references/xcode-target.md) for the full rationale.

## Prerequisites

- **Tools:** Xcode 16, and the `xcodeproj` Ruby gem (`gem install xcodeproj`, or via
  the project's `bundle`) — the scripts use it to edit the project safely. Sparkle
  itself is added as a package dependency, not installed.
- **Credentials:** a Developer ID Application certificate, plus the Sparkle EdDSA key
  pair this skill generates and stores in the keychain. Notarization credentials belong
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add yybd/app-factory/macos-direct-distribution@sha256:861dd942a3427600

The line at the top of this page pins the label git:20261021.202b5c1, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_hkx2t2frwehwo4iq.svg)](https://markdownregistry.com/a/art_hkx2t2frwehwo4iq)

1 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Sep 29, 2026 and Oct 21, 2026, about one every 7 days.

versioncommittedcommitsizeaudit
git:20261021.202b5c1 latest2026-10-21 202b5c1 12,579 BA view · diff
git:20261021.9543c5f2026-10-21 9543c5f 12,504 BA view · diff
git:20261021.68c4e6a2026-10-21 68c4e6a 12,297 BA view · diff
git:20260929.a7fd8b72026-09-29 a7fd8b7 10,882 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12579 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

yybd/app-factory · 5 stars · license MIT · pushed 2026-10-28 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_hkx2t2frwehwo4iq
GET https://markdownregistry.com/api/v1/resolve?ref=yybd/app-factory/macos-direct-distribution
GET https://markdownregistry.com/api/v1/blob/861dd942a342760007485bff4ba88090b69c04422fb2ff4a0f2a9ac815630322

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from yybd/app-factory

CLAUDE.md CLAUDE.md file
yybd/app-factory · CLAUDE.md
git:20261017.cd72387 · audit A · 5 stars
android-credentials SKILL.md skill
yybd/app-factory · plugins/android-track/skills/android-credentials/SKILL.md · The single owner of Android signing and Google Play credentials — the upload keystore, Play App Signing, the…
git:20260929.a7fd8b7 · audit A · 5 stars
android-icon-generator SKILL.md skill
yybd/app-factory · plugins/android-track/skills/android-icon-generator/SKILL.md · Generate a complete Android launcher-icon set from one source image — the adaptive icon (separate foreground and…
git:20261014.d283321 · audit A · 5 stars
android-run-device SKILL.md skill
yybd/app-factory · plugins/android-track/skills/android-run-device/SKILL.md · Build a debug APK and run it on a connected Android phone or emulator — the development loop, not a store release. Use…
git:20260929.a7fd8b7 · audit A · 5 stars
play-store-compliance SKILL.md skill
yybd/app-factory · plugins/android-track/skills/play-store-compliance/SKILL.md · Audit an Android app against Google Play's policies and the Console declarations that gate a release, and fix what…
git:20260929.a7fd8b7 · audit A · 5 stars
play-store-deliver SKILL.md skill
yybd/app-factory · plugins/android-track/skills/play-store-deliver/SKILL.md · The single send-surface to Google Play — sync the app's Play listing metadata, graphics, changelogs, AND in-app…
git:20261014.d283321 · audit A · 5 stars
play-store-media SKILL.md skill
yybd/app-factory · plugins/android-track/skills/play-store-media/SKILL.md · Produce and conform the graphics a Google Play listing requires — phone, 7" and 10" tablet screenshots, the 1024x500…
git:20260929.a7fd8b7 · audit A · 5 stars
play-store-metadata SKILL.md skill
yybd/app-factory · plugins/android-track/skills/play-store-metadata/SKILL.md · Author and validate a Google Play listing's text: title, short and full description, release notes per versionCode, and…
git:20260929.a7fd8b7 · audit A · 5 stars
play-store-reviews-responder SKILL.md skill
yybd/app-factory · plugins/android-track/skills/play-store-reviews-responder/SKILL.md · Read Google Play user reviews and write and post replies to them, through the Play Developer API. Use when the user…
git:20260929.a7fd8b7 · audit A · 5 stars
play-store-ship SKILL.md skill
yybd/app-factory · plugins/android-track/skills/play-store-ship/SKILL.md · Verify an Android app is release-ready and ship it to Google Play — the FINAL Play step: confirm the content is in…
git:20260929.a7fd8b7 · audit A · 5 stars
announce SKILL.md skill
yybd/app-factory · plugins/announce-track/skills/announce/SKILL.md · Write the posts that announce a release, a launch or an article — Hacker News, Reddit, LinkedIn, X, Bluesky and…
git:20261022.066146c · audit A · 5 stars
app-icon-generator SKILL.md skill
yybd/app-factory · plugins/apple-track/skills/app-icon-generator/SKILL.md · Generate a complete Xcode app-icon set from a single source image (or create a starter icon if the user has none)…
git:20260929.a7fd8b7 · audit A · 5 stars

Every file in yybd/app-factory

Browse by kind, by grade A, or by owner.