file-search-on: Skill for Claude Code

Cut Release

A release publishes to three independent targets in one shot. Pushing a tag matching v* to origin triggers .github/workflows/release.yml, which runs GoReleaser v2 and produces:

1. GitHub Release — six archives (linux/darwin/windows × amd64/arm64) + checksums.txt.
2. OCI image — ghcr.io/richardwooding/file-search-on:<version> (and :latest for non-prerelease).
3. Homebrew cask — auto-commit on richardwooding/homebrew-tap, installable via brew install richardwooding/tap/file-search-on.

This skill encodes the pre-flight, the tag-and-push, the verification, and the rollback. Tag pushes are public and hard to reverse — confirm version with the user before pushing if there's any ambiguity.

GitHub Marketplace action. The repo-root action.yml (a composite "review gate" action) is published to the Marketplace. GoReleaser creates releases via the API and cannot tick the Marketplace checkbox, so this is a one-time manual step done once: on a published release, click Edit, check "Publish this Action to the GitHub Marketplace", confirm "Everything looks good!", pick categories (Code quality + Code review), and save. After the first publish, every subsequent v* release automatically becomes a new Marketplace version — no per-release action needed. The action downloads the release binary matching its ref, so the action version tracks the CLI version automatically; just keep action.yml's example version references roughly current.

Quick start

# 1. Pre-flight (all of these must be clean)
git checkout main
git pull --ff-only origin main
git status                          # clean working tree
gh run list --branch main --limit 1 # latest CI run on main is green
git tag --sort=-v:refname | head -1 # current latest tag
goreleaser check                    # validates .goreleaser.yaml

# 2. Pick the new version using semver
#    feat: → minor bump (v0.X.0)
#    fix:/chore: → patch bump (v0.X.Y+1)
#    breaking change → major bump (vX+1.0.0) — until 1.0.0, breaking ⇒ minor

# 3. Tag and push
git tag -a v0.X.Y -m "v0.X.Y — <one-line summary>"
git push origin v0.X.Y

# 4. Watch the workflow — bounded by a hard timeout so an orphaned
#    runner can't block forever (see "Orphaned runs" below).
RUN_ID=$(gh run list --workflow=release.yml --limit 1 --json databaseId -q '.[0].databaseId')
timeout 600 gh run watch "$RUN_ID" --exit-status || echo "watch exited (timeout or run failed); checking artifacts directly"

# 5. Verify all three publish targets — THIS is the source of truth,
#    not the workflow status.
bash .claude/skills/cut-release/scripts/verify_release.sh v0.X.Y