← ClaudeAtlas

releaselisted

Drafts and publishes GitHub or GitLab releases with curated release notes. Use when the agent needs to prepare release text, compare tags, summarize release changes, or create a release. Always use this skill when the user asks to create a release, draft release notes, publish a release, summarize changes for a version, update a changelog for a release, or anything involving GitHub or GitLab releases. Trigger for phrases like "release notes", "draft a release", "publish release", "create a release", "v1.x.x release", "what changed since last tag", or "prepare release text".
skrrt-sh/skills · ★ 2 · Data & Documents · score 76
Install: claude install-skill skrrt-sh/skills
# Git Release Skill Prepare release text and publish it with the forge's own CLI — `gh` for GitHub, `glab` for GitLab. Use only when the user asks for a release, a draft, or release notes. ## Workflow 1. **Read the strategy** — find the `<!-- skrrt:branching -->` block in `CLAUDE.md`, `AGENTS.md`, `.claude/CLAUDE.md`, or `.github/AGENTS.md` (first match). No block found → tell the user to run `/setup` and stop. 2. **Detect the forge:** ```bash bash "${CLAUDE_SKILL_DIR}/scripts/detect-forge-cli.sh" ``` Continue only when `FORGE` and `MATCHED_CLI` agree (`github`/`gh`, `gitlab`/`glab`); otherwise stop and report the mismatch. 3. **Validate the release context.** GitHub Flow / Trunk-Based: tag a commit on `main` — switch to `main` and pull first. Gitflow: the `release/*` (or `hotfix/*`) branch must already be merged to `main`; if not, stop and tell the user to open that PR with `/pr`. After tagging, remind them of the sync-back PR to `develop`. 4. `git fetch origin --tags`, then inspect tags and history for the release range (`git describe --tags --abbrev=0`, `git log --oneline <range>`). That command fails on a repo with no tags — treat that as the initial release: run the range from the root commit (`git log --oneline $(git rev-list --max-parents=0 HEAD)..HEAD`), say in the notes that no previous release tag was found, and omit the compare link. 5. Draft the notes, update an existing `CHANGELOG.md` if the repo has one, then pub