Craft Plugin Release

Releasing Craft CMS plugins — tagging, Packagist propagation, GitHub releases, branch promotion. ALWAYS load when cutting, preparing, verifying, or debugging a plugin release: bumping a version, dating a changelog, creating or moving a git tag, editing a GitHub release, or checking what Packagist serves. Covers the composer.json version key (bump-or-omit trade-off, same-commit rule, verifying the tag's own blob), Packagist verification via repo.packagist.org/p2, the 'Skipped tag ... does not match version' silent failure, the tag recreation risk model (unserved tags safe to recreate, served tags never), GitHub release objects drifting from tags, gh api PATCH wiping tag_name to untagged-<hash>, releases/latest 404 when all releases are prereleases, drafts minting their tag from target_commitish at publish time, two-way origin branch comparison before promotion, and Composer path repositories for multi-plugin local dev (canonical semantics, no exclude on wildcards, extra.branch-alias, duplicate package names). Triggers on: cut/prepare a release, tag a version, bump the version, Packagist not serving the new version, 'Skipped tag', repo.packagist.org, packagist webhook, gh release create/edit, untagged- release, prerelease latest 404, target_commitish, draft release, promote develop to main, commits behind/ahead, path repository, branch-alias, dev-develop, symlinked plugin dependency. NOT for writing changelog entries, CI workflow YAML (craftcms skill quality.md), or plugin store listings.

mkdir -p ~/.claude/skills/craft-plugin-release
curl -L https://claudskills.com/skills/craft-plugin-release/SKILL.md \
  -o ~/.claude/skills/craft-plugin-release/SKILL.md

@misc{craft-plugin-release-2026,
  author    = {michtio},
  title     = {Craft Plugin Release [Claude Code skill]},
  year      = {2026},
  publisher = {ClaudSkills},
  url       = {https://claudskills.com/skills/craft-plugin-release/}
}