Nexus-agents release

Name: release
Author: williamzujkowski

install

source · Clone the upstream repo

git clone https://github.com/williamzujkowski/nexus-agents

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/williamzujkowski/nexus-agents "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/release" ~/.claude/skills/williamzujkowski-nexus-agents-release && rm -rf "$T"

manifest: skills/release/SKILL.md

source content

Release Skill

Pre-Release Checks

# Verify all gates pass
pnpm lint && pnpm typecheck && pnpm test

# Check fitness score (must be >= 90)
nexus-agents fitness-audit --format=json

Release Workflow (Changesets)

Releases are automated via changesets + GitHub Actions:

Add a changeset during development:
```
pnpm changeset
```
Merge PR to main — the Release workflow will:
- Create a "Version Packages" PR (bumps version, updates CHANGELOG.md)
- When that PR merges, publish to npm via OIDC trusted publishing
- Create a GitHub Release with auto-generated notes
No tokens required — npm authentication uses OIDC (see
```
id-token: write
```
permission in
```
.github/workflows/release.yml
```
). The trusted publisher is configured on npmjs.com to accept publishes from this repo's
```
release.yml
```
.

IMPORTANT: npm trusted publisher config must match workflow filename. The npmjs.com package settings specify the exact workflow file (
```
release.yml
```
), repository (
```
williamzujkowski/nexus-agents
```
), and environment. If you rename the workflow file, update the npm trusted publisher config to match or publishing will fail with OIDC token rejection.

Manual Publish (emergency only)

# Manual publish via the same release workflow (uses OIDC, no tokens needed)
gh workflow run release.yml

# Or with dry run:
gh workflow run release.yml -f dry_run=true

Rollback (if needed)

npm unpublish nexus-agents@<version>  # Within 72 hours
git tag -d v<version> && git push --delete origin v<version>

Release CLI Commands

The project also has built-in release automation:

nexus-agents release-notes      # Generate release notes
nexus-agents release-validate   # Validate release readiness
nexus-agents release-announce   # Announce release