# Github Release

> Create a GitHub release with auto-generated release notes from commits since the last tag. Uses conventional commits to categorize changes into Features, Bug Fixes, and maintenance sections. Use when this capability is needed.

- Skill: `tomevault-io/github-release-4` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/github-release-4`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/github-release-4/raw
- Safety review: pending (external: skill-scanner PASS, 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/github-release-4

---


# GitHub Release

Create GitHub release with formatted notes from commits since last tag.

**Prereqs**: `gh` authenticated, existing tags in repo

## Workflow

1. **Get commits** since latest tag (run as separate commands):
   ```bash
   # First: get latest tag
   git tag --sort=-v:refname | head -1
   ```
   ```bash
   # Then: get commits since that tag (replace <TAG> with result above)
   git log <TAG>..HEAD --pretty=format:"%h %s%n%b---" --no-merges
   ```

2. **Bump version** if needed:
   - Check if version in `decentpaste-app/src-tauri/tauri.conf.json` matches latest tag
   - If yes, run `/bump-version` skill first
   - If already bumped, continue

3. **Categorize** by conventional commit prefix:

   | Prefix | Section |
   |--------|---------|
   | `feat:` | Features & Improvements |
   | `fix:` | Bug Fixes |
   | `chore:`, `docs:`, `refactor:`, `perf:`, `style:`, `test:` | Under the Hood |

4. **Generate notes** (omit empty sections):
   ```markdown
   ## What's New in vX.X.X

   [1-2 sentence summary]

   ### Features & Improvements
   - **Feature** - Description

   ### Bug Fixes
   - **Fix** - Description

   ### Under the Hood
   - **Change** - Description

   ### Downloads

   | Platform | Download |
   |----------|----------|
   | Windows | `DecentPaste_X.X.X_x64-setup.exe` |
   | macOS (Intel) | `DecentPaste_X.X.X_x64.dmg` |
   | macOS (Apple Silicon) | `DecentPaste_X.X.X_aarch64.dmg` |
   | Linux (Debian/Ubuntu) | `DecentPaste_X.X.X_amd64.deb` |
   | Linux (AppImage) | `DecentPaste_X.X.X_amd64.AppImage` |
   | Android | `DecentPaste_X.X.X.apk` |

   ---
   **Full Changelog**: https://github.com/decentpaste/decentpaste/compare/<prev-tag>...v<version>
   ```

5. **Confirm** with user: show version, tag, commit count, notes preview

6. **Commit and push version bump** (CRITICAL - must happen before creating release!):
   ```bash
   git add -A && git commit -m "chore: bump version to X.X.X"
   git push
   ```
   ⚠️ CI/CD builds from the pushed code. If you create the release before pushing, CI will build the old version!

7. **Create release**:
   ```bash
   gh release create vX.X.X --title "DecentPaste vX.X.X" --notes "$(cat <<'EOF'
   <notes>
   EOF
   )"
   ```

8. **Done**: Show release URL, CI will automatically build and upload artifacts

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