muthuishere/toolnexus / .claude/skills/release
release
FlaggedCut and verify a toolnexus release across all eight registries, with the guardrails that a green CI run does not give you. Use whenever the user says publish, release, ship it, cut a release, bump the version, or asks whether a release actually landed. Also use to re-publish a single failed registry leg.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.9 KB |
| scripts/check-release-readiness.shexecutable | script | 8.1 KB |
scripts/check-release-readiness.sh
View on GitHub#!/usr/bin/env bash
# Release readiness gate for toolnexus. Read-only: it never publishes, tags, or edits.
#
# Replicates release.yml's `preflight` manifest check LOCALLY, and adds the check
# preflight does NOT have — that the versioned install coordinates in the docs match
# the version being released. That gap shipped 0.14.0 with Java/Clojure install
# snippets two minor versions behind.
#
# Usage: ./check-release-readiness.sh 0.15.0
# Exit: 0 = ready, 1 = blocked (reasons printed)
set -uo pipefail
V="${1:-}"
[ -z "$V" ] && { echo "usage: $0 <version> e.g. $0 0.15.0"; exit 2; }
cd "$(git rev-parse --show-toplevel)" || exit 2
fail=0
note() { printf ' %s\n' "$1"; }
bad() { printf ' ✗ %s\n' "$1"; fail=1; }
ok() { printf ' ✓ %s\n' "$1"; }
echo "== 1. Manifest parity (same check release.yml preflight runs) =="
JS=$(node -p "require('./js/package.json').version" 2>/dev/null)
PY=$(grep -E '^version' python/pyproject.toml | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
CS=$(grep -oE '<Version>[^<]+</Version>' csharp/src/Toolnexus/Toolnexus.csproj | head -1 | sed -E 's/<\/?Version>//g')
JAVA=$(grep -E "^version" java/build.gradle | head -1 | sed -E "s/.*'([^']+)'.*/\1/")
EX=$(grep -E '@version "' elixir/mix.exs | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
CLJ=$(grep -E '^\(def version ' clojure/build.clj | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
RS=$(grep -E '^version' rust/Cargo.toml | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
for pair in "js:$JS" "python:$PY" "csharp:$CS" "java:$JAVA" "elixir:$EX" "clojure:$CLJ" "rust:$RS"; do
n="${pair%%:*}"; v="${pair#*:}"
[ "$v" = "$V" ] && ok "$n = $v" || bad "$n = ${v:-<unreadable>}, expected $V"
done
note "(golang has no manifest — it releases as the tag golang/v$V)"
echo
echo "== 2. Docs install coordinates (preflight does NOT check these) =="
# Exact coordinate forms only — a broad version grep matches unrelated things like
# serverInfo `version: "0.1.0"` defaults. Historical prose ("since v0.13.0",
# "as of 0.12.0", "Versions measured") is intentionally NOT checked: rewriting it
# would falsify the record.
MINOR="${V%.*}" # 0.14.0 -> 0.14, for the elixir `~>` form
DOCS=$(git ls-files '*.md' '*.mdx' '*.edn' | grep -vE "^(CHANGELOG|docs/adr/|docs/spikes/|openspec/)")
stale=""
for f in $DOCS; do
# a) elixir: {:toolnexus, "~> 0.14"}
while IFS= read -r hit; do
echo "$hit" | grep -q '<version>' && continue # PUBLISHING.md templates
echo "$hit" | grep -q "~> $MINOR\"" || stale="$stale\n $f: $hit"
done < <(grep -n '{:toolnexus, "~>' "$f" 2>/dev/null)
# b) maven: io.github.muthuishere:toolnexus:0.14.0
while IFS= read -r hit; do
echo "$hit" | grep -q ":toolnexus:$V" || stale="$stale\n $f: $hit"
done < <(grep -n 'io\.github\.muthuishere:toolnexus:[0-9]' "$f" 2>/dev/null)
# c) clojars, BOTH spellings — deps.edn leaves the artifact bare, cljgo's
# build.cljgo quotes it: (dep b "net.clojars.muthuishere/toolnexus" {...}).
# Matching only the bare form let a cljgo-ex1 coordinate sit at 0.13.0 for
# two releases, which is precisely what this section exists to prevent.
while IFS= read -r hit; do
echo "$hit" | grep -q '"<version>"' && continue # PUBLISHING.md templates
echo "$hit" | grep -q "\"$V\"" || stale="$stale\n $f: $hit"
done < <(grep -n 'muthuishere/toolnexus" \?{:mvn/version\|muthuishere/toolnexus {:mvn/version' "$f" 2>/dev/null)
# e) crates: toolnexus = "0.24.0" (Cargo.toml dependency line)
while IFS= read -r hit; do
echo "$hit" | grep -q '"<version>"' && continue
echo "$hit" | grep -qE "\"(\\^)?($V|$MINOR)\"" || stale="$stale\n $f: $hit"
done < <(grep -nE '^\s*toolnexus = "[0-9^]' "$f" 2>/dev/null)
# d) maven xml: <version>..</version> in a file that installs the java artifact
if grep -q 'artifactId>toolnexus<' "$f" 2>/dev/null; then
while IFS= read -r hit; do
echo "$hit" | grep -q ">$V<" || stale="$stale\n $f: $hit"
done < <(grep -n '<version>[0-9]' "$f" 2>/dev/null)
fi
done
if [ -n "$stale" ]; then
bad "install coordinates not at $V:"; printf "$stale\n" | sed 's/^/ /'
else
ok "every live install coordinate reads $V (maven, clojars, elixir ~> $MINOR)"
fi
echo
echo "== 3. CHANGELOG =="
if grep -qE "^## $V — [0-9]{4}-[0-9]{2}-[0-9]{2}$" CHANGELOG.md; then
ok "has a dated '## $V' section"
else
bad "no '## $V — YYYY-MM-DD' section (roll '## Unreleased' down and add a fresh empty one above)"
fi
grep -qE "^## Unreleased" CHANGELOG.md && ok "'## Unreleased' still present for the next cycle" \
|| bad "no '## Unreleased' heading left at the top"
echo
echo "== 4. Git state =="
BR=$(git rev-parse --abbrev-ref HEAD)
[ -z "$(git status --porcelain --untracked-files=no)" ] && ok "working tree clean" || bad "uncommitted changes — commit or stash before releasing"
if [ "$BR" = "main" ]; then
git fetch -q origin main 2>/dev/null
[ "$(git rev-list --count origin/main..HEAD)" = "0" ] && ok "on main, in sync with origin" \
|| bad "on main but ahead of origin — push first; never release unmerged code"
else
bad "on '$BR', not main — the release must be cut from merged code"
fi
git ls-remote --tags origin 2>/dev/null | grep -q "refs/tags/v$V$" \
&& bad "tag v$V ALREADY EXISTS — a version can never be reused on any registry" \
|| ok "tag v$V is free"
echo
echo "== 5. Publish gates (a leg that is off is skipped SILENTLY) =="
if command -v gh >/dev/null 2>&1; then
for v in ENABLE_NPM ENABLE_PYPI ENABLE_GO ENABLE_NUGET ENABLE_JAVA ENABLE_ELIXIR ENABLE_CLOJARS ENABLE_CRATES; do
val=$(gh variable list 2>/dev/null | awk -v k="$v" '$1==k{print $2}')
[ "$val" = "true" ] && ok "$v=true" || note " ! $v=${val:-unset} — this registry will NOT publish"
done
else
note "gh not available — check the ENABLE_* variables by hand"
fi
echo
echo "== 6. Licensing =="
missing=""
for d in js python golang java csharp elixir clojure; do
[ -f "$d/LICENSE" ] || missing="$missing $d"
done
[ -z "$missing" ] && ok "every port carries a LICENSE" || bad "no LICENSE in:$missing"
[ -f THIRD-PARTY-NOTICES.md ] && ok "THIRD-PARTY-NOTICES.md present" || bad "THIRD-PARTY-NOTICES.md missing"
# The real drift risk: a dependency was added and never listed in the notices.
# Name-presence only — verifying the LICENSE of each pinned version needs a
# per-ecosystem resolver, which this gate deliberately does not attempt.
if [ -f THIRD-PARTY-NOTICES.md ]; then
undoc=""
add() { grep -q -- "$1" THIRD-PARTY-NOTICES.md || undoc="$undoc\n $2: $1"; }
for dep in $(node -p "Object.keys(require('./js/package.json').dependencies||{}).join('\n')" 2>/dev/null); do add "$dep" js; done
for dep in $(sed -n '/^dependencies = \[/,/^\]/p' python/pyproject.toml | grep -oE '"[a-zA-Z0-9_.-]+' | tr -d '"' | grep -v '^dependencies$'); do add "$dep" python; done
for dep in $(grep -oE '^\t[a-z0-9./-]+\.[a-z]+/[^ ]+' golang/go.mod | tr -d '\t'); do add "$dep" golang; done
# shipped configurations only — testImplementation/testRuntimeOnly are not distributed
for dep in $(grep -E "^\s+(api|implementation|compileOnly|runtimeOnly) " java/build.gradle \
| grep -oE "'[a-z0-9.]+:[a-z0-9.-]+:[0-9]" | sed -E "s/'([^:]+:[^:]+):.*/\1/"); do add "$dep" java; done
for dep in $(grep -oE 'PackageReference Include="[^"]+"' csharp/src/Toolnexus/Toolnexus.csproj | sed 's/.*="//;s/"//'); do add "$dep" csharp; done
for dep in $(sed -n '/defp deps do/,/^ end/p' elixir/mix.exs | grep -oE '\{:[a-z_]+' | tr -d '{:' | grep -vE '^(excoveralls|ex_doc)$'); do add "$dep" elixir; done
for dep in $(grep -oE '^\s+[a-z0-9./]+/[a-z0-9.-]+ \{:mvn' clojure/deps.edn | awk '{print $1}'); do add "$dep" clojure; done
if [ -n "$undoc" ]; then
bad "declared dependencies absent from THIRD-PARTY-NOTICES.md:"; printf "$undoc\n"
else
ok "every declared dependency appears in THIRD-PARTY-NOTICES.md"
fi
fi
grep -q 'LICENSE' elixir/mix.exs && ok "elixir Hex package ships LICENSE" \
|| bad "elixir mix.exs \`files:\` omits LICENSE — Hex consumers get no license text"
echo
if [ "$fail" = "0" ]; then
echo "READY for $V. Cutting the release is still an owner decision."
else
echo "BLOCKED — fix the ✗ items above."
fi
exit $fail
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |