skills/releasing/SKILL.md
Use when publishing a new version of the plugin.
npx skillsauth add sipengxie2024/superpower-planning releasingInstall 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.
Bump versions, tag, and publish a GitHub Release with an auto-generated changelog. All version sources must stay in sync.
| File | Field |
|------|-------|
| .claude-plugin/plugin.json | version |
| .claude-plugin/marketplace.json | plugins[0].version |
| Git tag | vX.Y.Z |
Check commits since last tag:
git log $(git describe --tags --abbrev=0)..HEAD --oneline
Apply semver: patch for fixes, minor for features, major for breaking changes.
Group commits by type when there are enough to justify it:
feat:)fix:)refactor:)For small releases (< 5 commits), a flat list is fine.
Once version and changelog are determined, run the release script:
${CLAUDE_PLUGIN_ROOT}/scripts/release.sh "<version>" "<changelog>"
This handles all mechanical steps: update both JSONs → commit → tag → push → create GitHub Release.
| Mistake | Fix |
|---------|-----|
| marketplace.json version not updated | Always update both JSON files together |
| Tag created before commit pushed | Push commit first, then tag, or use --tags |
| Changelog missing commits | Use prev_tag..HEAD, not prev_tag..new_tag before tagging |
development
Use when a spec or requirements exist for a multi-step task and an implementation plan needs to be written before touching code
data-ai
Use when about to claim work is complete, fixed, or passing, before committing or creating PRs.
data-ai
Use when executing implementation plans with parallel task groups or individual tasks too heavy for subagent context limits.
development
Use when implementing any feature or bugfix, before writing implementation code