muggle-ai-works: Skill for Claude Code

Muggle Test Works — npm release (single playbook)

Maintainer-only. Lives at .claude/skills/ (mirrored to .cursor/skills/), not in the published plugin (plugin/skills/). Invokable as /mrelease while working in this repo; run pnpm run link:maintainer-skills to invoke it from any project.

Repo: multiplex-ai/muggle-ai-works. Workflow: .github/workflows/publish-works-to-npm.yml (“Publish Works to npm”). Never run local npm publish (OIDC trusted publishing in CI).

---

Phase 1 — Ask bump type (do this first)

Stop until the user answers.

Prefer AskUserQuestion with exactly these three options: major, minor, patch (fix). If the environment has no structured question tool, ask the same in plain text:

Is this release a major, minor, or patch (fix)?

You may recommend a bump from commit subjects (e.g. feat! / breaking → major, feat → minor, fix / chore → patch) but do not choose for them. Do not edit files yet.

---

Phase 2 — Sync, surface state, empty-release gate

Run from muggle-ai-works:

git checkout master && git pull --ff-only && git fetch --tags

Show what is shipping:

node -e 'console.log("master package.json:", require("./package.json").version)'
npm view @muggleai/works version 2>&1 | sed 's/^/npm latest: /'

Commits since the last release commit (stop if there is nothing to ship):

LAST_RELEASE_SHA=$(git log --grep='chore(release)' --format='%H' -1)
NON_SHIPPING=(':(exclude)internal/' ':(exclude)docs/' ':(exclude)ops/' ':(exclude)test/' ':(exclude).github/' ':(exclude).claude/' ':(exclude).cursor/' ':(exclude)README.md' ':(exclude)eslint.config.js' ':(exclude)vitest.config.ts')
git log --oneline "$LAST_RELEASE_SHA..HEAD"
git diff --name-only "$LAST_RELEASE_SHA..HEAD" -- . "${NON_SHIPPING[@]}"

The log is for reading; the diff decides. NON_SHIPPING drops paths that cannot reach the npm tarball — the shipping surface is package.json → files, plus the sources dist/ is built from (src/, packages/, tsup.config.ts) and the lockfile pinning what gets bundled. The gate is a diff rather than a pathspec'd git log because path filtering makes git log simplify merge commits out of the range, which a tree-to-tree diff cannot do.