agents/skills/release/SKILL.md
Create a versioned release with changelog generation, git tag, and GitHub release. Use for creating releases, tagging versions, or publishing changelogs.
npx skillsauth add drn/dots 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.
Create a versioned release: bump version, generate changelog, create git tag, and publish a GitHub release.
$ARGUMENTS - Required: version bump type (major, minor, patch) or an explicit version (e.g., v2.1.0). Optional: --dry-run to preview without creating anything.git branch --show-currentgit status --shortgit describe --tags --abbrev=0 2>/dev/null | head -1git log --oneline 2>/dev/null | head -30git remote -v 2>/dev/null | head -10git branch -r 2>/dev/null | grep -oE 'origin/(main|master)' | head -1git status --short shows uncommitted changes, stop: "Uncommitted changes detected. Commit or stash before releasing."git symbolic-ref refs/remotes/origin/HEAD 2>/dev/null. Fallback to checking for origin/main, then origin/master.release/*, warn: "You are on <branch>, not the default branch. Releases are typically made from <default>. Proceed anyway?" Wait for confirmation.Parse $ARGUMENTS for the version:
v2.1.0), use it directly.major, minor, patch):
v0.0.0.v1.2.3 + patch = v1.2.4, + minor = v1.3.0, + major = v2.0.0.v, keep v; if bare numbers, use bare numbers).Report: "Version: <current> -> <new>"
Fetch commits since the last tag (or all commits if no prior tag):
git log <last-tag>..HEAD --format="%H%n%s%n%b%n---END---"
Categorize using the same approach as /changelog:
Write concise, meaningful entries. Deduplicate related commits. Skip trivial changes. Only include categories that have entries.
Present the release preview:
## Release Preview: <new-version>
### Changelog
<categorized entries from Step 2>
### Tag
`<new-version>` on commit `<HEAD short hash>`
### GitHub Release
Title: <new-version>
Body: <changelog>
IF --dry-run is in $ARGUMENTS, stop here: "Dry run complete. No changes made."
Otherwise, ask for confirmation: "Create this release?"
git tag -a <new-version> -m "<new-version>
<changelog summary>"
Push the tag:
git push origin <new-version>
gh release create <new-version> --title "<new-version>" --notes "<changelog>"
## Release Complete
**Version:** <new-version>
**Tag:** <new-version> on <commit hash>
**GitHub Release:** <URL from gh release create output>
**Changelog:** <N> entries across <M> categories
development
Walk every unresolved review thread on a PR, triage each one, reply with a rationale of whether or not the comment will be acted upon, make the code change if warranted, and mark the thread resolved. Use when the user asks to address only the open PR comments without re-running CI, respond to review feedback, resolve review threads, or clear bot comments on a PR.
tools
Iteratively run /rereview, fix the findings, and loop until reviewers approve clean. Use for iterative automated review, when you want /rereview to loop until clean, or for a paranoid pre-merge review that auto-addresses every blocker.
development
Generate self-contained HTML visualizations with Plannotator theming. Use for implementation plans, PR explainers, architecture diagrams, data tables, slide decks, and any visual explanation of technical concepts. Plans and PR explainers follow Plannotator's prescriptive approach; all other visual content delegates to nicobailon/visual-explainer.
development
Create reviewed Codex goal setup packages for long-running /goal work. Use when the user wants to turn an idea, backlog, project mission, or vague objective into durable goal files under a project goals slug folder, with Plannotator review gates for brief, narrative plan with acceptance criteria, verification, blockers, and the final /goal prompt.