steipete/npm

Operações de registro npm: login, whoami, nomes, publicação; integração com 1Password e tmux.

O que é npm?

Esta skill fornece um conjunto de ferramentas para gerenciar contas e pacotes no registro npm, com suporte a autenticação via 1Password e gerenciamento de sessões no tmux. É útil para desenvolvedores que precisam realizar tarefas como verificar o usuário logado (`npm whoami`), verificar disponibilidade de nomes de pacotes, publicar versões, reservar nomes e depurar problemas de autenticação. A skill se integra com o 1Password para armazenar tokens de registro e credenciais, priorizando o uso de `OP_SERVICE_ACCOUNT_TOKEN` para automação, com fallback para autenticação desktop quando necessário. Ela suporta operações em sessões persistentes do tmux, mantém as credenciais temporárias em um npmrc que é limpo após cada comando, e utiliza scripts auxiliares (`scripts/npm-auth.sh`, `scripts/publish-package.sh`, `scripts/reserve-packages.sh`) para garantir consistência e segurança no processo de autenticação e publicação.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/npm

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que npm faz?

Use para tarefas de registro/ conta npm: npm whoami, disponibilidade de pacotes, reserva de pacotes, publicação, verificações de organização e depuração de autenticação.

Autenticação

  • Use one-password primeiro para regras secretas.
  • Nunca execute op diretamente na ferramenta de shell.
  • Item principal: npm Registry - steipete - Release Automation em Molty.
  • Padrão para OP_SERVICE_ACCOUNT_TOKEN; sem desbloqueio de desktop. O item carrega a sessão de registro ativa (registry_token) além de nome de usuário/senha/TOTP como fallback.
  • Fallback de desktop npmjs é explícito somente: passe --account my.1password.com quando o Molty não estiver disponível e o usuário quiser o fallback. Solicitações explícitas de release/publish são consentimento para seu prompt de desbloqueio.
  • Pare e pergunte se o item estiver faltando, a conta/cofre for ambíguo, as credenciais estiverem malformadas, o npm negar acesso ao pacote, ou o pacote/versão solicitado não corresponder ao alvo de release do repositório.
  • Execute trabalhos de autenticação npm dentro de uma sessão tmux persistente. Reutilize-a em caso de falha.
  • Mantenha a autenticação npm em um npmrc temporário; exclua-o após o comando.
  • Todos os helpers compartilham scripts/npm-auth.sh: sessão registry_token armazenada primeiro, depois login no registro com scripts/npm-auth-login.mjs e um OTP novo de seis dígitos; sessões de fallback bem-sucedidas são armazenadas em cache no mesmo item. Não implemente manualmente extração de campos, login no registro ou escrita de cache.
  • A seleção de credenciais prefere o campo canônico id, depois purpose, depois um rótulo único; correspondências de rótulo duplicado são rejeitadas (o npmjs legado pode reter campos com o mesmo rótulo).
  • Para comandos de registro autenticados ad-hoc, use scripts/npm-service.sh -- <npm args...>; use publish-package.sh para um pacote local.
  • O piping de prompt do npm 11 é frágil; evite printf ... | npm login --auth-type=legacy.
  • Evite expect para login npm, a menos que necessário; logs podem ecoar prompts e são fáceis de errar.
  • Prefira o caminho de login da API de registro do helper (npm-profile loginCouch) para automação.
  • Se a forma de autenticação for ambígua ou npm whoami falhar, pare e pergunte pelo rótulo exato do campo / correção de credencial. Não investigue mais itens do 1Password ou inicie outra sessão tmux.

Publicação de Pacotes

A partir da raiz do pacote, dentro da mesma sessão tmux de autenticação:

/Users/steipete/Projects/agent-scripts/skills/npm/scripts/publish-package.sh

O helper verifica a identidade, recusa uma versão de pacote já existente, publica com um novo OTP, tenta novamente um OTP expirado, verifica a visibilidade no registro e limpa arquivos de autenticação.

Reserva de Pacotes

Use scripts/reserve-packages.sh dentro da mesma sessão tmux:

/Users/steipete/Projects/agent-scripts/skills/npm/scripts/reserve-packages.sh package-one package-two

O que faz:

  • lê o item de automação de release do Molty uma vez via op
  • reutiliza a sessão de registro armazenada ou cria uma a partir de nome de usuário/senha/TOTP
  • publica pacotes placeholder 0.0.0 com um README genérico
  • continua após falhas de publicação por pacote
  • oculta tokens/OTP nos logs
  • limpa npmrc/diretórios temporários

Notas:

  • O npm pode rejeitar nomes como muito semelhantes a nomes já publicados. Trate isso como um resultado da política do registro, não como uma falha de autenticação.
  • O piping de prompt da CLI npm é frágil no npm 11. Prefira o caminho de login da API de registro do helper em vez de npm login com script.
  • Para pacotes com escopo, npm view pode atrasar/retornar 404 mesmo quando o pacote existe. Verifique npm access get status <pkg>; public ou uma falha de publicação dizendo previously published versions significa que o nome está reservado.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Habilidades Relacionadas