luthersystems/elps / .claude/skills/release
release
Verified/release — Create a GitHub Release
Cuts a tagged release by dispatching the repository's release pipeline,
.github/workflows/release-tag.yml. The pipeline validates the version,
generates release notes from the commits since the last stable tag, and
creates the tag + GitHub Release with the official Claude App token; the
tag-push event then triggers vscode-publish.yml (platform elps binaries +
VS Code Marketplace extension).
Use the pipeline. Do not create the tag or release by hand. Two reasons, both documented in the workflow's own header:
- A tag created with the default
GITHUB_TOKEN(e.g.gh release createfrom a workflow, or an Actions-context push) does NOT triggervscode-publish.yml— GitHub suppresses workflow→workflow events for that token. The release would exist but the binaries and extension would never publish. - Direct tag pushes are blocked from agent sandboxes, so
git push origin vX.Y.Zis not available there anyway.
A release is externally visible immediately — the tag publishes the VS Code extension to the Marketplace. Treat cutting one as a production action.
Trigger
Use when asked to create a release, tag a release, cut a release, or ship a version.
Arguments
Optional: version bump type or explicit version.
patch(default) — bump patch: v1.44.0 -> v1.44.1minor— bump minor: v1.44.0 -> v1.45.0major— bump major: v1.44.0 -> v2.0.0vX.Y.Z— explicit version
Workflow
1. Determine the version
git fetch --tags origin
LATEST=$(git tag --list 'v*' | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | sort -V | tail -1)
echo "Latest stable tag: $LATEST"
git log $LATEST..origin/main --oneline
If there are no unreleased commits, stop and say so. Compute the next
version from the bump argument (or use the explicit version). The pipeline
re-validates — exact vMAJOR.MINOR.PATCH format with no leading zeros,
strictly newer than the latest stable tag by semver — and refuses anything
else, so a wrong guess fails safely rather than shipping.
2. Verify main is releasable
The pipeline always cuts from main HEAD — there is no ref input. It
refuses to release unless the CI Tests push run on that commit succeeds,
and waits up to 30 minutes for one still running. So before dispatching,
confirm main is what you intend to ship and its CI is green:
gh run list --branch main --limit 3 # or the Actions API if gh is absent
make release-notes previews the same information locally (latest tag, CI
status, commits since the tag, and the waived API breaks) when gh is
available.
Waived API breaks. bash scripts/api-breaks-since.sh <lasttag> prints
every scripts/api-breaks.txt entry added since the last stable tag -- the
breaking changes the API break gate (#761) let through. The release workflow
lists each under "Breaking changes" in the notes; check they are there on a
dry_run. After the release ships, delete those entries (a follow-up PR).
3. Update the VS Code extension changelog (if applicable)
If any unreleased change affects the extension (grammar, LSP, DAP,
formatter, minifier, binary bundling), add a section to
editors/vscode/CHANGELOG.md and land it on main before dispatching —
the pipeline releases main HEAD, so a changelog commit after the dispatch
misses the release. Skip for internal refactors, test-only changes, and CI
tweaks.
4. Dispatch the pipeline
Trigger release-tag.yml with the version:
gh workflow run release-tag.yml -f version=vX.Y.Z
# optional rehearsal first:
gh workflow run release-tag.yml -f version=vX.Y.Z -f dry_run=true
Without gh (agent sandboxes), use the Actions dispatch API / MCP
actions_run_trigger on release-tag.yml with input version: vX.Y.Z. A 403
"Resource not accessible by integration" means the session's GitHub App cannot
dispatch workflows: stop, and give the user the exact gh workflow run command
to run instead.
dry_run: true prints the validation result and the generated notes
without creating anything — use it if there is any doubt about the version
or the notes.
The pipeline is the org's shared release workflow
(luthersystems/.github/.github/workflows/release-tag.yml), which
release-tag.yml calls. In shell steps it validates the version (format,
newer than the latest tag of its major, the commit not released yet), that
the run's commit is GitHub's live main, and that CI Tests passed on it; and
writes the notes with scripts/release-notes.sh (one bullet per merged PR
since the last tag, plus the waived API breaks). On a validation failure it
stops with an error and creates nothing. Claude then runs one exact command,
gh release create … --target <commit>, with the App token; a hook denies
any other tool call. A last step checks that the release exists and that its
tag resolves to the validated commit. The agent transcript is uploaded as the
release-tag-trace-<run id> artifact.
5. Monitor the publish
The tag push triggers the VS Code extension publish:
gh run list --workflow vscode-publish.yml --limit 3
Verify all 10 jobs pass (the Require tag on main check, 4 binary builds,
4 platform publishes and 1 universal). The check refuses a tag that is not
vMAJOR.MINOR.PATCH or whose commit is not on main, and then nothing
publishes. The extension lands at
https://marketplace.visualstudio.com/items?itemName=LutherSystems.elps-lang
6. Report
Return the release URL (https://github.com/luthersystems/elps/releases/tag/vX.Y.Z), the publish-pipeline status, and a summary of what shipped.
Fallback (human operator only)
make release VERSION=vX.Y.Z performs the same validation and gh release create from a local machine. It requires gh authenticated as a real user
(a personal token's tag DOES trigger the publish workflow — the suppression
applies to the Actions GITHUB_TOKEN, not to user or App tokens). Prefer
the pipeline even then: it keeps every release on one audited path with one
identity.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 193k | Updated | Claude CodeCodex | Verified | Install |