How do I install the Github Release Best Practices skill?

Run npx skillmds@latest add d-o-hub/github-release-best-practices in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Github Release Best Practices skill do?

Background reference for release prep (SemVer, changelog categories). For actual releases, ALWAYS use the release-guard skill and release-manager.sh ship — never manual gh release create. It is listed under Coding & Dev Tools on SkillMD.

Is Github Release Best Practices safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Github Release Best Practices?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Github Release Best Practices free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Github Release Best Practices?

d-o-hub (@d-o-hub) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Github Release Best Practices by d-o-hub

Name: Github Release Best Practices
Author: d-o-hub

File contents

GitHub Release Best Practices (reference only)

Canonical procedure: release-guard
Canonical CLI: ./scripts/release-manager.sh ship --execute
GitHub Release creator: .github/workflows/release.yml (tag push only)

Do not invent a second release path. This file is supporting context only.

Prep before ship (via PR to main)

Bump workspace version in root Cargo.toml (all members follow workspace).
Update CHANGELOG.md with exactly one ## [X.Y.Z] - YYYY-MM-DD (unique version headers — cargo-dist/parse-changelog fails silently on duplicates → empty GitHub Release body).
Set Released Version in plans/ROADMAPS/ROADMAP_ACTIVE.md and plans/STATUS/CURRENT.md to vX.Y.Z.
Merge PR; wait for main CI green.
Run: ./scripts/release-manager.sh ship --execute
Confirm notes: gh release view vX.Y.Z shows ## Release Notes content (v0.1.34/v0.1.35 format).

Semver (0.x)

Change	Bump
Breaking	minor or major (team call)
Feature	minor preferred
Fix	patch

Changelog categories

Added · Changed · Deprecated · Removed · Fixed · Security

Forbidden

# DO NOT — bypasses cargo-dist and release.yml preflight
gh release create vX.Y.Z ...

References

ADR-034 Release Engineering
.agents/skills/release-guard/SKILL.md
./scripts/release-manager.sh

Frequently asked questions

Github Release Best Practices