Agent-Skills.md

Agent Skills: release - Versioning Stage

Create versioned releases with consolidated changelogs. Gathers shipped items, generates CHANGELOG.md entry, creates git tag, and GitHub Release. Use after multiple /ship tasks are merged.

UncategorizedID: webriq/claude-skills/release

Repository

webriq/claude-skills
webriq

Install this agent skill to your local

pnpm dlx add-skill https://github.com/webriq/webriq-workflow-skills/tree/HEAD/plugins/workflow/skills/release

Skill Files

Browse the full folder contents for release.

Download Skill

Loading file tree…

plugins/workflow/skills/release/SKILL.md

Skill Metadata

Name
release
Description
Use this skill when one or more ready-to-ship tasks have been merged and the user wants a versioned release. Generates changelog entries, creates tags or release notes, and moves merged tasks to Shipped.

release - Versioning Stage

Invariants

  • Release only merged Ready To Ship tasks.
  • Keep changelog entries user-focused.
  • Do not include unmerged pull requests.
  • Do not rewrite existing tags without explicit user approval.

Runtime adapters may expose this stage as a slash command, menu action, or natural-language skill invocation. The portable stage name is release.

Invocation

Supported version inputs:

  • auto or no argument: derive from task Version Impact
  • patch
  • minor
  • major
  • explicit version such as v1.2.3

Workflow

  1. Read AGENTS.md.
  2. Read TASKS.md and find merged items in Ready To Ship.
  3. Read each task document for type, version impact, and summary.
  4. Determine the next version.
  5. Generate or update docs/changelogs/CHANGELOG.md.
  6. Commit changelog changes if the repository workflow expects release commits.
  7. Create a git tag when appropriate.
  8. Create release notes using the available repository hosting tool when appropriate.
  9. Move released items to Shipped in TASKS.md.

Version Calculation

| Signal | Version Impact | |--------|----------------| | Breaking change or required user migration | major | | New feature | minor | | Bug fix, docs, chore, small enhancement | patch |

Highest impact wins when multiple tasks are released together.

Changelog Template

## [v{version}] - {Date}

### New Features
- {User-facing feature}

### Fixes
- {Bug fix}

### Improvements
- {Enhancement}

### Documentation
- {Documentation update}

### Breaking Changes
- {Required migration, if any}

Handoff

Release prepared: v{version}
Tasks shipped: {IDs}
Changelog: docs/changelogs/CHANGELOG.md