zed-extension-release - SKILL.md Agent Skill

name: zed-extension-release description: Automate Zed extension releases for this repo. Use when bumping the extension version, updating CHANGELOG/README/PUBLISHING, rebuilding extension.wasm, running tests, committing/tagging, and pushing a vX.Y.Z tag to trigger the Zed extensions registry update workflow.

Zed Extension Release

Overview

Automate version bumps and release chores for the Zed extension in this repo using the bundled script.

Workflow

Pick the new version and write release notes.
Run the script to update extension.toml, CHANGELOG.md, README.md (Latest), and PUBLISHING.md.
Optionally build extension.wasm and run tests.
Review git status and diffs.
Commit, tag, and push to trigger the registry update workflow.
Verify the GitHub Action run and merge the PR in zed-industries/extensions.

Script

Use scripts/zed_extension_release.py from the repo root.

Common usage

Bump files only:

python3 /Users/applesucks/.codex/skills/zed-extension-release/scripts/zed_extension_release.py 0.0.9 \
  --note "Fix Vue file issue" \
  --note "Improve hover descriptions"

Full release (build + tests + commit + tag + push):

python3 /Users/applesucks/.codex/skills/zed-extension-release/scripts/zed_extension_release.py 0.0.9 \
  --notes-file release-notes.txt \
  --build \
  --run-tests \
  --commit \
  --tag \
  --push

Behavior

Updates extension.toml version.
Inserts a new top section in CHANGELOG.md using provided notes.
Updates README ### Latest: vX.Y.Z if present.
Updates release checklist/version fields in PUBLISHING.md if present.
Updates hardcoded version checks in release tests when present (e.g., test_extension.sh, .github/workflows/test.yml).
--build runs cargo build --release --target wasm32-wasip1 and copies to extension.wasm.
--run-tests runs cargo test --lib, ./test_extension.sh, and ./test_clean_install.sh.
--commit fails on unrelated changes unless --allow-dirty is used.
--tag creates v<version>; --push pushes commit + tag to origin (override with --remote).