steipete/npm

Opérations sur le registre npm : connexion, whoami, noms de paquets, publication ; utilise 1Password et tmux.

Qu'est-ce que npm ?

Cette compétence offre un accès automatisé et sécurisé au registre npm, en s'intégrant avec 1Password pour la gestion des secrets et tmux pour les sessions persistantes. Elle est conçue pour les développeurs ayant besoin d'effectuer des tâches courantes sur le registre npm, telles que la vérification de l'identité (`npm whoami`), la réservation de noms de paquets, la publication de versions, et le débogage d'authentification. La compétence privilégie l'utilisation de jetons de service (`OP_SERVICE_ACCOUNT_TOKEN`) pour l'authentification sans intervention manuelle, avec une sauvegarde via le coffre Molty. Elle repose sur des scripts shell dédiés pour gérer les sessions d'authentification de manière fiable, en évitant les méthodes fragiles comme le pipe de prompts ou `expect`. En cas d'ambiguïté ou d'échec, la compétence s'arrête et demande une clarification à l'utilisateur, garantissant ainsi la sécurité et la précision des opérations.

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

Installed? Explore more Développement et programmation skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait npm ?

Utilisation pour les tâches relatives au registre/compte npm : npm whoami, disponibilité des paquets, réservation de paquets, publication, vérifications d'organisation et débogage de l'authentification.

Authentification

  • Utilisez one-password en premier pour les règles secrètes.
  • N'exécutez jamais op directement dans l'outil shell.
  • Élément principal : npm Registry - steipete - Release Automation dans Molty.
  • Par défaut, utilisez OP_SERVICE_ACCOUNT_TOKEN ; pas de déverrouillage du bureau. L'élément contient la session de registre active (registry_token) ainsi que le nom d'utilisateur/mot de passe/TOTP de secours.
  • La sauvegarde du bureau npmjs est explicite uniquement : passez --account my.1password.com lorsque Molty est indisponible et que l'utilisateur souhaite cette sauvegarde. Les demandes explicites de release/publish sont un consentement pour son invite de déverrouillage.
  • Arrêtez-vous et demandez si l'élément est manquant, le compte/coffre est ambigu, les informations d'identification sont malformées, npm refuse l'accès au paquet, ou si la version/le paquet demandé ne correspond pas à la cible de publication du dépôt.
  • Exécutez le travail d'authentification npm dans une seule session tmux persistante. Réutilisez-la en cas d'échec.
  • Gardez l'authentification npm dans un npmrc temporaire ; supprimez-le après la commande.
  • Tous les assistants partagent scripts/npm-auth.sh : d'abord la session registry_token stockée, puis la connexion au registre via scripts/npm-auth-login.mjs avec un nouveau code OTP à six chiffres ; les sessions de secours réussies sont mises en cache dans le même élément. N'extrayez pas les champs, ne vous connectez pas au registre, et n'écrivez pas manuellement dans le cache.
  • La sélection des informations d'identification privilégie le champ canonique id, puis purpose, puis un libellé unique ; les correspondances de libellés en double uniquement sont rejetées (le npmjs hérité peut conserver des champs avec le même libellé).
  • Pour les commandes de registre authentifiées ponctuelles, utilisez scripts/npm-service.sh -- <arguments npm...> ; utilisez publish-package.sh pour un paquet local.
  • Le pipe des invites npm 11 est fragile ; évitez printf ... | npm login --auth-type=legacy.
  • Évitez expect pour la connexion npm sauf si nécessaire ; les journaux peuvent faire écho aux invites et sont faciles à mal interpréter.
  • Préférez le chemin de connexion à l'API du registre de l'assistant (npm-profile loginCouch) pour l'automatisation.
  • Si la forme des informations d'identification est ambiguë ou si npm whoami échoue, arrêtez-vous et demandez le libellé exact du champ / la correction des informations d'identification. Ne sondez pas plus d'éléments 1Password et ne démarrez pas une autre session tmux.

Publication de paquets

Depuis la racine du paquet, dans la même session tmux d'authentification :

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

L'assistant vérifie l'identité, refuse une version de paquet déjà existante, publie avec un nouveau code OTP, réessaie en cas d'OTP expiré, vérifie la visibilité sur le registre et nettoie les fichiers d'authentification.

Réservation de paquets

Utilisez scripts/reserve-packages.sh depuis la même session tmux :

/Users/steipete/Projects/agent-scripts/skills/npm/scripts/reserve-packages.sh paquet-un paquet-deux

Ce qu'il fait :

  • lit l'élément d'automatisation de publication Molty une fois via op
  • réutilise la session de registre stockée ou en crée une à partir du nom d'utilisateur/mot de passe/TOTP
  • publie des paquets factices 0.0.0 avec un README générique
  • continue après les échecs de publication par paquet
  • masque les jetons/OTP dans les journaux
  • nettoie les dossiers npmrc/temporaires

Remarques :

  • npm peut rejeter des noms comme trop similaires à des noms déjà publiés. Traitez cela comme un résultat de la politique du registre, pas comme un échec d'authentification.
  • Le pipe des invites CLI npm est fragile sur npm 11. Préférez le chemin de connexion à l'API du registre de l'assistant plutôt que npm login scripté.
  • Pour les paquets avec portée, npm view peut avoir un retard/404 même si le paquet existe. Vérifiez npm access get status <pkg> ; public ou un échec de publication indiquant previously published versions signifie que le nom est réservé.

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 associés