Release notes & version bump
SkillDocs & knowledgeBump the version and write a CHANGELOG.md release-notes entry after a user-facing change ships. Use when asked to "bump the version", "cut a release", "add a changelog entry", or "write release notes". Produces one minimal, user-facing, technical bullet per change.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the Release notes & version bump skill
What this skill tells your AI
The instructions your AI receives, as published by bagofwords1/bagofwords in .agents/skills/release-notes/SKILL.md and read by ahel’s review.
Two files, one commit. VERSION drives the release; CHANGELOG.md is the
human-readable history.
VERSION— a single line,MAJOR.MINOR.PATCH(e.g.0.0.448). The Release workflow (.github/workflows/release.yml) reads it, tagsvX.Y.Z, and extracts the matchingCHANGELOG.mdsection as the GitHub release body.CHANGELOG.md— newest version first. Served to users at/changelog(parsed bybackend/app/routes/changelog.py), so the format is load-bearing.
Steps
- Bump
VERSION. Increment the patch by one (0.0.448→0.0.449) unless told otherwise. No leading spaces, no trailing newline changes — just the number. - Add a section at the top of
CHANGELOG.md, directly under# Release Notes:
Use today's date, format## Version <new-version> (<Month DD, YYYY>) - <One short line stating the change> (#<PR>)July 12, 2026. One bullet per user-facing change; group the whole release under this single version heading. - Commit both files together:
Bump version to <X.Y.Z> with changelog entry.
How to write a bullet
One short plain line per change. That's the whole note.
- Added Google Chat as a new chat channel (#771)
- Start with the verb:
Added …,Fixed …,Renamed …,Removed …. - Name the feature the way a user would say it, then stop. No architecture, no implementation, no docs pointers, no marketing.
(#PR)— the pull request number, if known. Omit if there's no PR.- Only append an
— detailclause when the user needs a concrete knob to use the change (a setting name, env var, or changed default). One clause, not a sentence.
Rules
- Minimal. If a bullet wraps past one line, cut it down.
- User-facing only. Skip pure refactors, test-only changes, CI, and dependency bumps. If a user can't observe it, it's not a release note.
- Be specific, not vague. "Fixed SSO login for mismatched email casing" beats "Improved login reliability".
- No filler. Drop "now", "the ability to", "support for", "improved", "various", "enhancements".
- Never real data. No customer/org names, account identifiers, emails,
tokens, connection strings, or any PII — release notes are public. Use
generic placeholders (
<name>,acme) if an example needs one.
Examples
Feature:
- Added Google Chat as a new chat channel (#771)
Feature with a knob (the only case that earns a detail clause):
- Added concurrent multi-tool execution (#598) — controlled by the `ai_tool_concurrency` org setting (default 4)
Fix:
- Fixed iOS focus-zoom on the report prompt box (#600)
Config/model change (no PR):
- Updated OpenAI model presets — GPT-5.6 Terra is the new default
A full release section:
## Version 0.0.438 (July 7, 2026)
- Added Triggers: webhooks that spawn agent sessions, under a new Automations page (#562)
- Added per-file QVD indexing progress with stop, size, and duration (#564)
- Fixed WhatsApp delivery of agent replies and verification-page branding (#565)
Signals
- GitHub stars
- 455
- Forks
- 83
- Last commit
- Sep 2026
Advanced
- Catalog kind
- skill
- Gateway key
release-notes- Source
- github.com/bagofwords1/bagofwords