메뉴
Rotate the npm publish token for a package to a fresh granular+bypass-2fa token, update 1Password and the GitHub Actions secret. Use when publishes hit E403/EOTP and /npm-doctor says the token needs replacing.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
One-time per-package setup — writes an entry in `~/.config/npm-helper/state.json` mapping a package to its 1Password item, GitHub repo, publish workflow, GH secret, and optional Vercel mirrors. Run this once before `/npm-publish` will work on a new package.
Read-only diagnosis of npm ↔ 1Password ↔ GitHub Actions credential drift for a package. Reports what's stale and what to do. Side-effect free.
One-shot npm publish — detects package, syncs credentials, bumps version, tags, pushes, tails the workflow, classifies failures, recovers automatically where possible. Use when the user says "publish this", "ship it", "release npm", or similar.
Change the npm account 2FA level between disabled, auth-only, and auth-and-writes. Use when /npm-doctor reports account 2FA is blocking automation tokens.
Invoked after a failed npm publish to classify the failure, take the right recovery action, and retry once. Called automatically by the PostToolUse hook — the user rarely invokes this directly.
| name | npm-rotate-token |
| description | Rotate the npm publish token for a package to a fresh granular+bypass-2fa token, update 1Password and the GitHub Actions secret. Use when publishes hit E403/EOTP and /npm-doctor says the token needs replacing. |
Swap the publish token with minimal human interaction.
npm token create --packages @scope/pkg --packages-and-scopes-permission read-write --cidr-whitelist 0.0.0.0/0 --expires 365 --name "npm-helper <date>" (plus --bypass-2fa if supported by current CLI version).
https://www.npmjs.com/settings/<user>/tokens/granular-access-tokens/new in the user's default browser. Print the parameters they need to fill:
npm-helper <pkg> <date><pkg> (read+write)npm_... token back.op item edit <id> 'token[password]=<new-token>' — updates 1P.echo -n <new-token> | gh secret set NPM_TOKEN -R <repo> — updates GH Actions.vercel_projects, mirror with vercel env add per project.token_id + sha256(token) + timestamp to state.npm token revoke <old-id>. Only after the new one is confirmed written everywhere.op and gh via stdin.