Release

What it does

When your agent uses it

• Automated CI/CD builds
• The user asks to release
• Create a release
• Update changelog

Example prompts

• “release”
• “create a release”
• “tag a version”
• “/release”

Requirements

• A credential in HOMEBREW_TAP_TOKEN
• A credential in SPARKLE_PRIVATE_KEY

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

1. 1Update CHANGELOG.md (see below)
2. 2Commit: 📝 docs: update CHANGELOG for vX.Y.Z
3. 3Tag: git tag vX.Y.Z
4. 4Push: git push origin main --tags
5. 5CI triggers .github/workflows/release.yml → builds, signs, notarizes, and publishes the GitHub Release
6. 6CI updates vaayne/homebrew-tap with the new mori cask version and SHA-256

What it can do on your machine

Read from SKILL.md and the folder at commit ff206ee. 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

  Shell commands in SKILL.md call:

  • git
  • gh
  • xcrun

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

• Network

  Links to these hosts (documentation or services it may open):

  • appstoreconnect.apple.com
  • keepachangelog.com

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

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • APPLE_APP_PASSWORD
  • APPLE_CERTIFICATE_PASSWORD
  • HOMEBREW_TAP_TOKEN
  • SPARKLE_PRIVATE_KEY
  • IOS_CERTIFICATE_PASSWORD

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

Context cost

Release loads about 1.2k tokens when it runs. Until then it costs about 96 tokens; SKILL.md has 438 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~96

When it runs · the whole SKILL.md, loaded when a task matches

~1.2k

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

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

The full file from vaayne/mori at commit ff206ee, republished under its MIT licence (© vaayne). 438 words, ~1,166 tokens.

name

release

description

Release workflow for Mori macOS workspace terminal and MoriRemote iOS app. Create releases with semantic versioned tags, update changelog, and trigger automated CI/CD builds. Use when the user asks to "release", "create a release", "tag a version", "update changelog", "prepare release", "cut a release", "publish to TestFlight", or discusses versioning and release artifacts.

gh workflow run release-ios.yml -R vaayne/mori \
  --ref <branch> \
  -f version=0.3.5 \
  -f build_number=N

git log $(git describe --tags --abbrev=0 2>/dev/null || git rev-list --max-parents=0 HEAD)..HEAD --oneline
gh pr list --state merged --base main --search "merged:>=$(git log -1 --format=%aI $(git describe --tags --abbrev=0 2>/dev/null || git rev-list --max-parents=0 HEAD))"

© vaayne, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/release of vaayne/mori.

Open the folder on GitHubat commit ff206ee