CommunityProgramación y desarrollogithub.com

steipete/npm

Operaciones del registro npm: inicio de sesión, whoami, nombres, publicación; 1Password tmux.

¿Qué es npm?

Este skill está diseñado para que un agente de IA (como Claude Code, Cursor o Codex) gestione de forma segura y automatizada todas las interacciones con el registro npm, incluyendo autenticación, verificación de identidad, comprobación y reserva de nombres de paquetes, publicación y depuración de autorizaciones. Su principal ventaja es que centraliza la autenticación a través de 1Password (usando una cuenta de servicio o el proceso de escritorio según el contexto), guarda las sesiones del registro como tokens en una bóveda y evita exponer credenciales en el shell o en archivos temporales. Soporta la creación de sesiones persistentes de tmux para mantener el contexto de autenticación a lo largo de varios comandos y proporciona scripts auxiliares (npm-auth.sh, npm-auth-login.mjs, npm-service.sh, publish-package.sh, reserve-packages.sh) que el agente invoca en lugar de ejecutar npm login directamente, sorteando así problemas de piping de prompts en npm 11. El skill se usa principalmente en el equipo de steipete, con el gestor de contraseñas Molty como fuente principal de credenciales y un mecanismo de respaldo explícito para cuentas de escritorio de npmjs.

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

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace npm?

Úsalo para tareas del registro npm/cuenta: npm whoami, disponibilidad de paquetes, reserva de paquetes, publicación, comprobaciones de organizaciones y depuración de autenticación.

Autenticación

  • Usa one-password primero para las reglas de secretos.
  • Nunca ejecutes op directamente en la herramienta de shell.
  • Elemento principal: npm Registry - steipete - Release Automation en Molty.
  • Por defecto, usa OP_SERVICE_ACCOUNT_TOKEN; no es necesario desbloquear el escritorio. El elemento contiene la sesión activa del registro (registry_token) además del respaldo de usuario/contraseña/TOTP.
  • El respaldo de escritorio npmjs solo es explícito: pasa --account my.1password.com cuando Molty no está disponible y el usuario quiere el respaldo. Las solicitudes explícitas de release/publish implican consentimiento para su solicitud de desbloqueo.
  • Detente y pregunta si falta el elemento, la cuenta/bóveda es ambigua, las credenciales están mal formadas, npm deniega el acceso al paquete, o el paquete/versión solicitado no coincide con el destino de lanzamiento del repositorio.
  • Ejecuta el trabajo de autenticación npm dentro de una única sesión persistente de tmux. Reutilízala en caso de fallo.
  • Mantén la autenticación npm en un npmrc temporal; elimínalo después del comando.
  • Todos los ayudantes comparten scripts/npm-auth.sh: primero la sesión almacenada registry_token, luego el inicio de sesión en el registro con scripts/npm-auth-login.mjs usando un OTP de seis dígitos fresco; las sesiones de respaldo exitosas se guardan en el mismo elemento. No implementes manualmente la extracción de campos, el inicio de sesión en el registro ni la escritura de la caché.
  • La selección de credenciales prefiere el campo canónico id, luego purpose, luego una etiqueta única; las coincidencias duplicadas solo por etiqueta se rechazan (el legado npmjs puede conservar campos con la misma etiqueta).
  • Para comandos ad-hoc del registro autenticados, usa scripts/npm-service.sh -- <npm args...>; usa publish-package.sh para paquetes locales.
  • El piping de prompts de npm 11 es frágil; evita printf ... | npm login --auth-type=legacy.
  • Evita expect para el inicio de sesión npm a menos que sea necesario; los registros pueden hacer eco de los prompts y es fácil equivocarse.
  • Prefiere la ruta de inicio de sesión API del registro del ayudante (npm-profile loginCouch) para la automatización.
  • Si la forma de autenticación es ambigua o npm whoami falla, detente y pregunta por la etiqueta de campo exacta o la corrección de la credencial. No explores más elementos de 1Password ni inicies otra sesión de tmux.

Publicación de Paquetes

Desde la raíz del paquete, dentro de la misma sesión de tmux de autenticación:

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

El ayudante verifica la identidad, rechaza una versión de paquete existente, publica con un OTP nuevo, reintenta un OTP caducado, verifica la visibilidad en el registro y limpia los archivos de autenticación.

Reserva de Paquetes

Usa scripts/reserve-packages.sh desde la misma sesión de tmux:

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

Qué hace:

  • lee el elemento de automatización de lanzamientos de Molty una vez mediante op
  • reutiliza la sesión de registro almacenada o crea una a partir de usuario/contraseña/TOTP
  • publica paquetes placeholder 0.0.0 con un README genérico
  • continúa después de fallos de publicación por paquete
  • enmascara tokens/OTP en los registros
  • limpia npmrc temporal/directorios de trabajo

Notas:

  • npm puede rechazar nombres por ser demasiado similares a nombres ya publicados. Trátalo como un resultado de la política del registro, no como un fallo de autenticación.
  • El piping de prompts de la CLI de npm es frágil en npm 11. Prefiere la ruta de inicio de sesión API del ayudante sobre npm login con script.
  • Para paquetes con ámbito, npm view puede retrasarse/dar 404 incluso cuando el paquete existe. Comprueba con npm access get status <pkg>; public o un fallo de publicación que diga previously published versions significa que el nombre 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.

Skills relacionados