# Create Release

> Create a GitHub release for hyAway by updating the changelog and tagging commits. Use when user wants to "release", "publish", "tag a version", or "create a release". Handles changelog updates and git tagging with date format (v2026.01.28). Use when this capability is needed.

- Skill: `tomevault-io/create-release` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/create-release`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/create-release/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/create-release

---


# Create Release

Create releases with changelog entry and git tag.

## Tag Format

`vYYYY.MM.DD` (e.g., `v2026.01.28`)

## Process

1. **Update changelog** for today's date in `docs/changelog.md`
2. **Commit** if there are uncommitted changes
3. **Push branch first**: `git push` (important: push before tagging!)
4. **Tag**: `git tag v2026.01.28`
5. **Push tag**: `git push origin v2026.01.28`

> **Why push before tagging?** `git push --follow-tags` only pushes tags pointing to commits in the push range. If HEAD is already on remote, the tag won't be included. Pushing branch first, then tagging and pushing the tag separately avoids this issue.

Once the tag reaches the remote, it triggers:

- GitHub release with changelog content extracted
- Docker image tagged `ghcr.io/hyaway/hyaway:v2026.01.28`

## Commands

```bash
# Push branch first
git push

# Create release tag
git tag v2026.01.28

# Push the tag
git push origin v2026.01.28

# Tag specific commit
git tag v2026.01.28 <commit-hash>

# Delete tag (if needed to redo)
git tag -d v2026.01.28
git push origin :refs/tags/v2026.01.28
```

## Important

- Changelog entry date must match tag: `v2026.01.28` expects `## 2026-01-28`
- Tag must point to commit containing the changelog entry
- Old commits (before workflow existed) need manual dispatch via GitHub Actions UI

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