Communityコーディング&開発github.com

steipete/npm

npm レジストリ操作:ログイン、whoami、名前確認、公開;1Password tmux。

npm とは?

このスキルは、npm レジストリのタスク(npm whoami、パッケージの可用性確認、予約、公開、組織チェック、認証デバッグ)を自動化するためのツールです。主に 1Password(Molty)と連携し、安全かつ効率的に認証情報を管理します。tmux セッション内で npm 認証を実行し、一時的な npmrc に認証情報を保存してコマンド実行後に削除することで、セキュリティリスクを低減します。サポートするプラットフォームは、Claude Code や他のエージェントベースの開発ツールを想定しており、スクリプト(scripts/npm-auth.sh、publish-package.sh、reserve-packages.sh)を使って認証、公開、予約の各操作を自動化します。このスキルにより、開発者は手動介入を減らし、一貫性のある安全な npm レジストリ操作を実現できます。

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

Installed? Explore more コーディング&開発 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

npm は何をしますか?

npm レジストリやアカウントのタスクに使用します:npm whoami、パッケージの可用性確認、パッケージ予約、公開、組織チェック、認証デバッグ。

認証

  • 秘密ルールには最初に one-password を使用します。
  • シェルツールで op を直接実行しないでください。
  • プライマリアイテム:npm Registry - steipete - Release Automation(Molty 内)
  • デフォルトでは OP_SERVICE_ACCOUNT_TOKEN を使用します。デスクトップのロック解除は不要です。このアイテムには、有効なレジストリセッション(registry_token)に加え、ユーザー名/パスワード/TOTP のフォールバックが含まれています。
  • デスクトップ npmjs のフォールバックは明示的にのみ使用します:--account my.1password.com を渡して、Molty が利用できずユーザーがフォールバックを希望する場合に限ります。明示的な release/publish リクエストは、そのロック解除プロンプトへの同意とみなします。
  • 以下の場合は停止して確認します:アイテムが見つからない、アカウント/ボールトがあいまい、認証情報の形式が不正、npm がパッケージアクセスを拒否、要求されたパッケージ/バージョンがリポジトリのリリースターゲットと一致しない。
  • npm 認証作業は、1 つの永続的な tmux セッション内で実行します。失敗した場合はそれを再利用します。
  • npm 認証は一時的な npmrc に保存し、コマンド実行後に削除します。
  • 全てのヘルパーは scripts/npm-auth.sh を共有します:まず保存された registry_token セッションを使用し、次に scripts/npm-auth-login.mjs によるレジストリログイン(新しい 6 桁の OTP を使用)を試みます。成功したフォールバックセッションは同じアイテムにキャッシュされます。フィールド抽出、レジストリログイン、キャッシュ書き込みは手動で行わないでください。
  • 認証情報の選択は、正規のフィールド id、次に purpose、次に一意のラベルを優先します。ラベルが重複するだけの一致は拒否されます(レガシー npmjs は同じラベルのフィールドを保持する場合があります)。
  • アドホックな認証付きレジストリコマンドには、scripts/npm-service.sh -- <npm args...> を使用します。ローカルパッケージの公開には publish-package.sh を使用します。
  • npm 11 のプロンプトパイピングは不安定です。printf ... | npm login --auth-type=legacy は避けてください。
  • npm ログインに expect を使用することは、必要な場合を除き避けてください。ログにプロンプトがエコーされる可能性があり、間違えやすいです。
  • 自動化には、ヘルパーのレジストリ API ログインパス(npm-profile loginCouch)を優先します。
  • 認証情報の形状があいまいな場合、または npm whoami が失敗した場合は、停止して正確なフィールドラベルや認証情報の修正を確認してください。これ以上の 1Password アイテムを探索したり、新しい tmux セッションを開始しないでください。

パッケージ公開

パッケージルートから、同じ認証 tmux セッション内で次のコマンドを実行します:

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

ヘルパーは、本人確認、既存パッケージバージョンの拒否、新しい OTP を使用した公開、期限切れ OTP の 1 回再試行、レジストリへの可視性の確認、認証ファイルのクリーンアップを行います。

パッケージ予約

同じ tmux セッション内で scripts/reserve-packages.sh を使用します:

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

処理内容:

  • Molty の release-automation アイテムを op 経由で 1 回読み取ります
  • 保存されたレジストリセッションを再利用するか、ユーザー名/パスワード/TOTP から新しく作成します
  • 汎用 README 付きの 0.0.0 プレースホルダーパッケージを公開します
  • パッケージごとの公開失敗後も処理を継続します
  • ログ内のトークン/OTP を難読化します
  • 一時 npmrc/作業ディレクトリをクリーンアップします

注意事項:

  • npm は、既に公開された名前と類似している名前を拒否する場合があります。これは認証失敗ではなく、レジストリポリシーの結果として扱います。
  • npm 11 では npm CLI のプロンプトパイピングが不安定です。スクリプト化された npm login よりも、ヘルパーのレジストリ API ログインパスを優先します。
  • スコープ付きパッケージの場合、npm view はパッケージが存在していても遅延や 404 を返すことがあります。npm access get status <pkg> を確認してください。public または previously published versions という公開失敗メッセージは、名前が予約済みであることを意味します。

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.

関連スキル