# Release

> Create a new specops release with version bump, tag, and GitHub release Use when this capability is needed.

- Skill: `tomevault-io/release-31` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/release-31`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/release-31/raw
- Safety review: WARNING (external: skill-scanner WARNING, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/release-31

---


# Release Process

Create a new release for specops.

## Steps

### 1. Determine Version

Ask the user for the new version, or suggest one based on semver:
- **patch** (x.y.Z): bug fixes, minor changes
- **minor** (x.Y.0): new features, backwards compatible
- **major** (X.0.0): breaking changes

To find the current version:
```bash
git describe --tags --abbrev=0
```

### 2. Bump Version

Update version in these files:
- `install.ps1`: `$VERSION = "vX.Y.Z"`
- `install.sh`: `VERSION="vX.Y.Z"`
- `README.md`: Update install URLs to use `vX.Y.Z` instead of previous version
- `.claude-plugin/plugin.json`: `"version": "X.Y.Z"` (no "v" prefix)

### 3. Commit Version Bump

```bash
git add install.ps1 install.sh README.md .claude-plugin/plugin.json
git commit -m "Bump version to vX.Y.Z"
```

### 4. Create and Push Tag

```bash
git tag vX.Y.Z
git push origin main
git push origin vX.Y.Z
```

### 5. Generate Release Notes

Get commits since last tag for release notes:
```bash
git log $(git describe --tags --abbrev=0 HEAD^)..HEAD --oneline
```

### 6. Create GitHub Release

```bash
gh release create vX.Y.Z --title "vX.Y.Z" --notes "RELEASE_NOTES_HERE"
```

**PowerShell note:** Escape backticks by doubling them (`` ` `` → ``` `` ```).

Format release notes as:
```markdown
## Changes

- Change 1
- Change 2

## Installation

**Windows:**
```powershell
irm https://raw.githubusercontent.com/wilddeer/specops/main/install.ps1 | iex
```

**macOS/Linux:**
```bash
curl -fsSL https://raw.githubusercontent.com/wilddeer/specops/main/install.sh | bash
```
```

## Checklist

- [ ] Version follows semver
- [ ] Both install scripts updated
- [ ] README install URLs updated
- [ ] plugin.json version updated (no "v" prefix)
- [ ] Tag matches version in scripts, README, and plugin.json
- [ ] Release notes summarize changes clearly

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/wilddeer) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-15 -->