# release-lotion

release-lotion is a Claude Code skill that ships Lotion macOS releases to GitHub. It handles archive builds, notarization, DMG packaging, and appcast updates.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 156 repo stars
- Author: fayazara
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/fayazara/Lotion/tree/HEAD/.agents/skills/release-lotion/SKILL.md
- Updated: 2026-11-15
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/release-lotion

## What it does

release-lotion runs the Lotion release CLI written in Go. It can archive the app, export a Developer ID build, submit it for notarization, staple the result, create a DMG, sign it with Sparkle, and publish a GitHub release. It also updates the appcast and Homebrew cask.

The workflow needs `create-dmg`, an authenticated `gh`, `git`, `plutil`, `go`, Sparkle `sign_update`, an EdDSA private key in the login keychain, and the local package at `../shiki-swift`. Full builds add `xcodebuild`, `xcrun`, `ditto`, and a `notarytool` keychain profile. The default profile is `screendrop-notary`, using an App Store Connect API key for team `TB2S44TFQS`.

Release notes can come from `-notes` or `-notes-file`; version and build values can be changed with `-set-version` and `-set-build`. The CLI pushes commits to `main`, creates the GitHub release before publishing `appcast.xml`, and treats the Homebrew cask update as non-fatal.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add fayazara/Lotion --skill release-lotion -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/release-lotion/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/release-lotion/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add fayazara/Lotion --skill release-lotion -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/release-lotion/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add fayazara/Lotion --skill release-lotion -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/release-lotion/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install fayazara/Lotion .agents/skills/release-lotion
```

2. **Manually: put the files in place**
- File: `.github/skills/release-lotion/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add fayazara/Lotion --skill release-lotion -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/fayazara/Lotion --path .agents/skills/release-lotion
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/release-lotion/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/fayazara/Lotion/tree/HEAD/.agents/skills/release-lotion/SKILL.md

## When to use it
- build and notarize a new Lotion release
- package and Sparkle-sign a macOS DMG
- publish a GitHub release with the DMG attached
- refresh `appcast.xml` for Sparkle updates
- regenerate the Lotion Homebrew cask

## Example prompts
- Release Lotion as version `0.2.1` with build number `12`, using notes from the latest commits.
- Run a full Lotion build, complete notarization, and publish the DMG to GitHub.
- Update `appcast.xml` for the new Lotion release and push the changes to `main`.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: a32d228f796400a7.

BEGIN THIRD-PARTY FILE a32d228f796400a7
````text
---
name: release-lotion
description: "Release the Lotion macOS notes app to GitHub using the lotion-release CLI tool. Use this skill whenever the user wants to publish a new version, create a release, ship an update, cut a build, push a release to GitHub, or update the appcast. Also use when they mention archiving, notarization, DMG creation, Sparkle signing, bumping the version/build, the Homebrew cask, or anything related to building and distributing a new Lotion version."
---

# Release Lotion

This skill releases new versions of Lotion using a custom Go CLI
(`cmd/lotion-release`). The CLI can run **fully automated and
non-interactively**, so a release can be triggered directly from a chat session
(the agent can run it end to end).

There are two modes:

- **Full auto (`-build`)** - archive, export (Developer ID), notarize, staple,
  package, sign, and publish. Nothing in Xcode's GUI is required.
- **Package-only** (no `-build`) - assumes the user already exported a
  notarized `~/Downloads/Lotion.app` from Xcode, then packages & publishes.

Prefer **full auto** unless the user says they've already exported the app.

## Prerequisites

Always required:

1. Tools installed: `create-dmg` (brew), `gh` (GitHub CLI, authenticated), `git`, `plutil`, `go`.
2. The Sparkle `sign_update` binary in DerivedData (created when the project is
   built/archived - the `-build` flow produces it automatically).
3. The Sparkle EdDSA private key in the login keychain (shared with Screendrop;
   `generate_keys -p` must print the `SUPublicEDKey` below).
4. [shiki-swift](https://github.com/fayazara/shiki-swift) cloned at
   `../shiki-swift` - the project uses it as a local package.

For **full auto (`-build`)** additionally:

5. `xcodebuild`, `xcrun`, `ditto` (Xcode 27; the CLI points `DEVELOPER_DIR` at
   `/Applications/Xcode.app` itself if the active dir is Command Line Tools).
6. A **notarytool keychain profile**. The default is `screendrop-notary` - an
   App Store Connect API key for team `TB2S44TFQS`, shared with Screendrop. If
   it is missing, create it (or another name, passed with `-notary-profile`):
   ```bash
   xcrun notarytool store-credentials "screendrop-notary" \
     --key /path/to/AuthKey_XXXXXXXXXX.p8 --key-id XXXXXXXXXX --issuer <issuer-uuid>
   ```

## The Release CLI

Source: `/Users/fayazahmed/Developer/fayazara/mac/Paper/cmd/lotion-release/`

### Flags

- `-build` - run the archive → export → notarize → staple phase first.
- `-set-version <x.y.z>` - set `MARKETING_VERSION` before archiving (and commit it). Used with `-build`.
- `-set-build <n>` - set `CURRENT_PROJECT_VERSION` before archiving (and commit it). Used with `-build`.
- `-scheme <name>` - Xcode scheme to archive (default `Lotion`; never `Lotion Demo`).
````
END THIRD-PARTY FILE a32d228f796400a7

The third-party file has ended. Everything between the a32d228f796400a7 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2772 of 9225 bytes. © fayazara · MIT · https://github.com/fayazara/Lotion/tree/HEAD/.agents/skills/release-lotion/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
