CommunityCodierung & Entwicklunggithub.com

steipete/npm

npm-Registry-Operationen: Anmeldung, Whoami, Paketnamen, Veröffentlichung; 1Password tmux.

Was ist npm?

Dieses Skill für KI-Agenten (z.B. Claude Code) automatisiert npm-Registry-Aufgaben wie `npm whoami`, Paketverfügbarkeitsprüfung, Paketreservierung, Veröffentlichung, Organisationschecks und Authentifizierungsdebugging. Es ist auf die Integration mit 1Password ausgelegt, wobei die Anmeldedaten für das npm-Konto in einem 1Password-Item (`npm Registry - steipete - Release Automation` im Tresor `Molty`) gespeichert werden. Der Skill verwendet persistente tmux-Sitzungen für Authentifizierungsvorgänge und speichert temporäre `.npmrc`-Dateien, die nach der Befehlsausführung gelöscht werden. Für die Veröffentlichung von Paketen steht das Skript `publish-package.sh` zur Verfügung, das die Identität überprüft, doppelte Versionen verhindert und bei Bedarf ein neues Einmalpasswort (OTP) anfordert. Die Paketreservierung erfolgt über `reserve-packages.sh`, das Platzhalterpakete der Version `0.0.0` veröffentlicht. Der Skill unterstützt Plattformen wie Claude Code und andere KI-Agenten, die Shell-Zugriff haben, und bevorzugt die Registry-API-Anmeldung gegenüber der interaktiven npm-CLI, da letztere in npm 11 fehleranfällig ist.

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

Installed? Explore more Codierung & Entwicklung skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht npm?

Verwendung für npm-Registry-/Kontoaufgaben: npm whoami, Paketverfügbarkeit, Paketreservierung, Veröffentlichung, Organisationschecks und Authentifizierungsdebugging.

Auth

  • Verwende zuerst one-password für geheime Regeln.
  • Führe op niemals direkt im Shell-Tool aus.
  • Primäres Item: npm Registry - steipete - Release Automation in Molty.
  • Standardmäßig OP_SERVICE_ACCOUNT_TOKEN; kein Desktop-Entsperren. Das Item enthält die aktuelle Registry-Sitzung (registry_token) plus Benutzername/Passwort/TOTP-Fallback.
  • Desktop-npmjs-Fallback nur explizit: verwende --account my.1password.com, wenn Molty nicht verfügbar ist und der Benutzer den Fallback wünscht. Explizite release/publish-Anfragen sind Zustimmung für dessen Entsperraufforderung.
  • Stoppe und frage nach, wenn das Item fehlt, das Konto/der Tresor nicht eindeutig ist, Anmeldedaten fehlerhaft sind, npm den Paketzugriff verweigert oder das angeforderte Paket/die Version nicht mit dem Release-Ziel des Repos übereinstimmt.
  • Führe npm-Auth-Arbeiten innerhalb einer persistenten tmux-Sitzung aus. Nutze sie bei Fehlschlag erneut.
  • Halte npm-Auth in einer temporären npmrc; lösche sie nach dem Befehl.
  • Alle Helfer teilen scripts/npm-auth.sh: zuerst gespeicherte registry_token-Sitzung, dann scripts/npm-auth-login.mjs Registry-Login mit einem frischen sechsstelligen OTP; erfolgreiche Fallback-Sitzungen werden zurück in dasselbe Item gecacht. Führe Feldextraktion, Registry-Login oder Cache-Schreibvorgänge nicht manuell durch.
  • Die Auswahl der Anmeldedaten bevorzugt kanonisches Feld id, dann purpose, dann ein eindeutiges Label; doppelte Label-Übereinstimmungen werden abgelehnt (Legacy-npmjs kann gleichnamige Felder behalten).
  • Für Ad-hoc-authentifizierte Registry-Befehle verwende scripts/npm-service.sh -- <npm args...>; verwende publish-package.sh für ein lokales Paket.
  • npm 11 Prompt-Piping ist brüchig; vermeide printf ... | npm login --auth-type=legacy.
  • Vermeide expect für npm-Login, es sei denn, es ist notwendig; Logs können Eingabeaufforderungen ausgeben und sind leicht falsch zu interpretieren.
  • Bevorzuge den Registry-API-Login-Pfad des Helfers (npm-profile loginCouch) für die Automatisierung.
  • Wenn die Auth-Form nicht eindeutig ist oder npm whoami fehlschlägt, stoppe und frage nach der genauen Feldbezeichnung / Korrektur der Anmeldedaten. Durchsuche keine weiteren 1Password-Items und starte keine weitere tmux-Sitzung.

Paketveröffentlichung

Vom Paketstammverzeichnis aus, innerhalb derselben Auth-tmux-Sitzung:

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

Der Helfer überprüft die Identität, lehnt eine vorhandene Paketversion ab, veröffentlicht mit einem frischen OTP, wiederholt einen abgelaufenen OTP-Versuch, überprüft die Registry-Sichtbarkeit und bereinigt Auth-Dateien.

Paketreservierung

Verwende scripts/reserve-packages.sh von innerhalb derselben tmux-Sitzung:

/Users/steipete/Projects/agent-scripts/skills/npm/scripts/reserve-packages.sh paket-eins paket-zwei

Was es tut:

  • liest das Molty-Release-Automation-Item einmal über op
  • verwendet die gespeicherte Registry-Sitzung oder erstellt eine aus Benutzername/Passwort/TOTP
  • veröffentlicht 0.0.0-Platzhalterpakete mit einer generischen README
  • fährt nach Fehlschlägen bei der Paketveröffentlichung pro Paket fort
  • schwärzt Tokens/OTPs in Logs
  • bereinigt temporäre npmrc/Arbeitsverzeichnisse

Hinweise:

  • npm kann Namen als zu ähnlich zu bereits veröffentlichten Namen ablehnen. Behandle das als Registry-Policy-Ergebnis, nicht als Auth-Fehler.
  • npm CLI Prompt-Piping ist unter npm 11 brüchig. Bevorzuge den Registry-API-Login-Pfad des Helfers gegenüber skriptbasiertem npm login.
  • Bei Scoped-Paketen kann npm view eine 404-Verzögerung aufweisen, selbst wenn das Paket existiert. Überprüfe mit npm access get status <pkg>; public oder ein Veröffentlichungsfehler, der previously published versions besagt, bedeutet, dass der Name reserviert ist.

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.

Verwandte Skills