Release notes & version bump
SkillDocs & knowledgeLets your agent bump the version number and write a CHANGELOG.md entry after a change ships.
Instructions available. Your AI can read the instructions. Execution depends on the setup they require.
Account requirements not reviewed. Check the skill instructions before use; ahel provides instructions and does not run this skill.
Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.
Then ask your AI: use the Release notes & version bump skill
About this skill
Bump 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.
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
- 457
- Forks
- 84
- Last commit
- Sep 2026
Advanced
- Item type
- skill
- Key
release-notes-bagofwords1- Source
- github.com/bagofwords1/bagofwords
github.com/bagofwords1/bagofwords
Related picks
Skill · aaronnat23
The pick for Whatsappwhatsapp-marketing
Skill · arnabbagxd
The pick for Whatsapplark-markdown
Skill · larksuite
The pick for Markdownmarkdown-mermaid-writing
Skill · k-dense-ai
The pick for Markdownhandoff
Skill · mattpocock
More in Docs & knowledgecanvas-design
Skill · anthropics
More in Docs & knowledge