Changelog

Compatibility: AskUserQuestion falls back to numbered list on non-Claude-Code platforms.

Dependency Check

Before proceeding, verify that at least one of gh or glab is available:

command -v gh >/dev/null 2>&1 || command -v glab >/dev/null 2>&1 || echo "MISSING: gh or glab — install one to use changelog retcon"

If neither is available: warn the user but allow changelog preview to proceed (it only needs git).

Critical Rules

• Markdown output: soft-wrap prose, never hard-wrap — when this skill writes a .md artifact (changelog entries, previews, or any generated document), write each paragraph as one continuous line; do not insert manual newlines to wrap prose at a fixed column width. Newlines still separate paragraphs, list items, headings, and code fences. (If a markdown formatter is available, prettier --prose-wrap never enforces this deterministically.)

• Never rebase on protected branches — refuse if branch is main, master, develop, or matches *-stable

• Never force-push without --force-with-lease — always protect against concurrent pushes

• retcon --apply requires a clean working tree — refuse if git status --porcelain is non-empty

• preview never writes files — output to conversation only

• Unknown verb → help — never error silently

Step 0: Parse Arguments

The raw invocation args (filled by Claude Code / OpenCode slash commands): $ARGUMENTS. If this line is not filled in, read the verb and remaining args from the user's current message.

VERB="[first non-flag arg, default: help]"
APPLY_MODE=false
PLATFORM=""
[[ "$*" =~ --apply ]] && APPLY_MODE=true
[[ "$*" =~ --platform[[:space:]]github ]] && PLATFORM="github"
[[ "$*" =~ --platform[[:space:]]gitlab ]] && PLATFORM="gitlab"

case "$VERB" in
  "")         VERB="help"    ;;
  "rc")       VERB="retcon"  ;;
esac

Step 1: Dispatch

Read and execute references/workflows/{VERB}.md.

If references/workflows/{VERB}.md does not exist, fall back to references/workflows/help.md.

Workflow Index

• retcon (references/workflows/retcon.md) — propose and apply commit message edits on open PR/MR
• preview (references/workflows/preview.md) — show predicted changelog and next version inline
• help (references/workflows/help.md) — print command reference