.agents/skills/release/SKILL.md
Version management and release processes using Jetpack Changelogger. Use when creating releases, managing changelogs, bumping versions, or preparing releases.
npx skillsauth add Automattic/wordpress-atmosphere releaseInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Quick reference for managing releases and changelogs for the WordPress ATmosphere plugin.
bin/release.sh [version] # Build release ZIP with production deps only.
composer changelog:add # Add a changelog entry.
composer changelog:write # Write changelog entries to CHANGELOG.md.
When updating versions manually, change these files:
atmosphere.php - Plugin header (Version: X.Y.Z) and ATMOSPHERE_VERSION constant.readme.txt - WordPress.org readme (Stable tag: X.Y.Z).package.json - npm version ("version": "X.Y.Z").CHANGELOG.md - Changelog file (auto-updated by changelogger).Changelogs are managed through the Jetpack Changelogger:
Adding entries:
composer changelog:add
.github/changelog/ directory.Writing changelog:
composer changelog:write
.github/changelog/.CHANGELOG.md automatically.Always end changelog messages with punctuation:
Good: Add support for custom post types.
Good: Fix OAuth token refresh failing silently.
Bad: Add support for custom post types
Bad: Fix OAuth token refresh failing silently
Write end-user friendly messages:
Good: Fix posts not appearing on Bluesky when published via Quick Edit.
Good: Add option to disable standard.site document records.
Bad: Refactor Publisher class to handle edge case in applyWrites batch.
Bad: Fix TID collision in transformer output.
Never mention AI tools or coding assistants in changelog messages.
Semantic versioning:
# 1. Write changelog.
composer changelog:write
# 2. Update version numbers in all version file locations.
# 3. Commit version bump.
git add -A
git commit -m "Release version X.Y.Z"
# 4. Build release ZIP.
bin/release.sh X.Y.Z
# 5. Create GitHub release with the ZIP.
gh release create X.Y.Z atmosphere-X.Y.Z.zip --title "X.Y.Z" --generate-notes
development
Testing patterns for PHPUnit tests. Use when writing tests, debugging test failures, setting up test coverage, or implementing test patterns for ATmosphere features.
documentation
Version management and release processes using Jetpack Changelogger. Use when creating releases, managing changelogs, bumping versions, or preparing releases.
testing
MUST be invoked before creating any PR, pushing a branch for review, or running `gh pr create`. Covers changelog entries, branch naming, PHPCS/PHPUnit checks, and reviewer assignment.
tools
Development workflows for WordPress ATmosphere plugin including wp-env setup, testing commands, linting, and build processes. Use when setting up development environment, running tests, checking code quality, or working with wp-env.