release

Local overrides (read this first). Before following any instruction below, check whether .claude/.local/skills/release/overrides.md exists. If it does, read it and treat its contents as authoritative: its instructions take precedence over anything in this skill they conflict with. This is the supported way to tailor /release without forking it — overrides.md lives under .claude/.local/, which sequant update and sync never overwrite.

Release Skill

Automates the full release workflow: version bump, git tag, GitHub release, and npm publish.

Usage

/release [patch|minor|major] [--prerelease <tag>] [--dry-run]

• /release - Interactive, asks for version type
• /release patch - Patch release (1.3.1 → 1.3.2)
• /release minor - Minor release (1.3.1 → 1.4.0)
• /release major - Major release (1.3.1 → 2.0.0)
• /release minor --prerelease beta - Pre-release (1.3.1 → 1.4.0-beta.0)
• /release --dry-run - Preview without publishing

Pre-flight Checks

Run ALL checks before proceeding. STOP if any fails.

Git Checks

# 1. On main branch
[ "$(git branch --show-current)" = "main" ] || { echo "Not on main"; exit 1; }

# 2. Clean working tree
[ -z "$(git status --porcelain)" ] || { echo "Uncommitted changes"; exit 1; }

# 3. In sync with remote
git fetch origin
[ -z "$(git log HEAD..origin/main)" ] || { echo "Behind origin - pull first"; exit 1; }

Quality Checks

# 4. Tests pass
npm test

# 5. Build works
npm run build

# 6. No security vulnerabilities (high/critical)
npm audit --audit-level=high || echo "Warning: audit issues found"

npm Checks

# 7. Logged into npm
npm whoami || { echo "Not logged in - run: npm login"; exit 1; }

# 8. Version doesn't already exist
pkg_name=$(node -p "require('./package.json').name")
current=$(node -p "require('./package.json').version")
npm view "${pkg_name}@${current}" version 2>/dev/null && { echo "Version already published"; exit 1; }

# 9. Preview package contents
npm pack --dry-run 2>&1 | tail -20