releasing-skiller

Use when preparing, packaging, tagging, or publishing Skiller Desktop releases, including GitHub release CI, macOS code signing, notarization, release secrets, and desktop version bumps.

Jump to install

Repository: gannonh/skiller
Last source activity: June 24, 2026 at 00:16
Detected SKILL.md language: English
Stars: 7
Forks: 0

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/gannonh/skiller --skill releasing-skiller

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

3 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

valid-skill

A valid skill fixture.

2026-05-09

View all from this repository

Releasing Skiller

Use this for Skiller Desktop releases.

Release Target

Version source: apps/desktop/package.json

Tag format: desktop-vX.Y.Z

Workflow: .github/workflows/desktop-release.yml

Product name: Skiller

Bundle id: com.gannonhall.skiller

Workflow

Work from a clean tree. If already on a feature branch, use that branch for the release PR. If on main, create a release branch named release/desktop-vX.Y.Z before changing files.

Bump apps/desktop/package.json.

Write the changelog entry for the release.

Update README.md for user-facing install, usage, or release changes.

Run local checks:

pnpm typecheck
pnpm --filter @skiller/core test
pnpm --filter @skiller/desktop test
pnpm test:e2e
pnpm --filter @skiller/desktop run desktop:dist:mac
pnpm --dir apps/desktop exec electron-builder --config electron-builder.yml --linux AppImage deb --x64

Update AGENTS.md if the release introduces agent context worth preserving, such as major architecture changes or ADR-level decisions. Do not add obvious, standard, or one-off implementation details.

Open the release PR using references/release-pr-template.md.

Update the user on release PR status and wait for next steps. Do not merge without prior user approval.

On merge to main, CI creates desktop-vX.Y.Z and publishes macOS and Linux artifacts.

Changelog and Release Notes

Add a release entry before tagging.

Use the changelog entry as the GitHub Release notes content.

Include only user-facing changes, fixes, known issues, and install notes.

Keep internal implementation details out unless users need them.

Update README.md when the release changes installation, setup, commands, supported platforms, or visible behavior.

Read references/desktop-release.md before changing release CI or troubleshooting signing. Use references/release-pr-template.md when opening release PRs.