# release-openspec

> Claude/Codex skill by [@fission-ai](https://omgskills.com/library/fission-ai/index.md) · 72k stars · Updated 2026-10-17

Use this skill when releasing OpenSpec: audit merged work and changeset coverage, decide whether a catch-up changeset PR is needed, prepare or resume the Changesets Version Packages PR, cut a beta or stable release, verify publishing, and polish GitHub release notes. Also use when asked whether an open release PR is complete, what the next release step is, or to continue a release paused for human approval.

Tags: ai, context-engineering, engineering, planning, prd, sdd, sdlc, spec, spec-driven-development, specification

## Install

```sh
git clone https://github.com/Fission-AI/OpenSpec /tmp/OpenSpec && ln -s /tmp/OpenSpec/.agents/skills/release-openspec ~/.claude/skills/release-openspec
```

## From README

Release OpenSpec Run the OpenSpec release workflow as a resumable state machine. Inspect live GitHub state on every invocation and take only the next safe action. Do not assume an earlier invocation completed. Principles Treat Fission-AI/OpenSpec and origin/main as the release source of truth. Default to a read-only audit when the user asks for status, readiness, or advice. Treat a request to release, prepare a release, continue, or resume as authorization to perform the applicable release actions. Preserve the user's checkout. Never discard unrelated changes or switch their current branch just to prepare a changeset. Use a temporary worktree from current origin/main for release-authored commits when the checkout is dirty or not on main. Never approve your own PR. Human review is a deliberate gate. Treat merge-queue entry as an intermediate state, not a merge. Advance only after GitHub reports mergedAt and the commit is present on main.

## Links

- HTML page: https://omgskills.com/skills/fission-ai/openspec/release-openspec/
- GitHub: https://github.com/Fission-AI/OpenSpec
- Author: [@fission-ai](https://omgskills.com/library/fission-ai/index.md)

## More from this repo

- [draft-openspec-docs](https://omgskills.com/skills/fission-ai/openspec/draft-openspec-docs/index.md) — Collaborative page-drafting mode for the OpenSpec docs.
   - [@fission-ai](https://omgskills.com/library/fission-ai/index.md) · 73k stars
- [openspec-apply-change](https://omgskills.com/skills/fission-ai/openspec/openspec-apply-change/index.md) — Implement tasks from an OpenSpec change.
   - [@fission-ai](https://omgskills.com/library/fission-ai/index.md) · 72k stars
- [openspec-archive-change](https://omgskills.com/skills/fission-ai/openspec/openspec-archive-change/index.md) — Archive a completed OpenSpec change in the experimental workflow.
   - [@fission-ai](https://omgskills.com/library/fission-ai/index.md) · 72k stars