Community코딩 & 개발github.com

steipete/npm

npm 레지스트리 작업: 로그인, whoami, 패키지 이름 확인, 게시; 1Password tmux.

npm란 무엇인가요?

이 스킬은 npm 레지스트리 계정 및 패키지 작업을 자동화하는 AI 에이전트 도구입니다. `npm whoami`, 패키지 가용성 확인, 패키지 예약, 게시, 조직 확인 및 인증 디버깅을 지원합니다. 주로 1Password와 tmux 세션을 활용한 안전한 인증 흐름을 제공하며, `OP_SERVICE_ACCOUNT_TOKEN`을 기본으로 사용하고 `Molty` 금고의 `npm Registry - steipete - Release Automation` 항목에서 인증 정보를 가져옵니다. 데스크톱 `npmjs` 폴백은 명시적 요청 시에만 사용됩니다. 패키지 게시는 `publish-package.sh` 스크립트를 통해 ID 확인, 중복 버전 방지, 일회용 OTP 사용, 만료 OTP 재시도, 레지스트리 가시성 확인 등을 수행합니다. 패키지 예약은 `reserve-packages.sh`로 `0.0.0` 플레이스홀더를 게시하며, 인증 실패와 레지스트리 정책 오류를 구분합니다. npm 11의 프롬프트 파이핑 취약성을 피하기 위해 헬퍼 스크립트의 레지스트리 API 로그인 경로를 선호합니다.

지원 대상~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를 직접 실행하지 마십시오.
  • 기본 항목: Molty 내 npm Registry - steipete - Release Automation.
  • 기본값: OP_SERVICE_ACCOUNT_TOKEN; 데스크톱 잠금 해제 없음. 항목에는 작업 중인 레지스트리 세션(registry_token)과 사용자 이름/비밀번호/TOTP 폴백이 포함됩니다.
  • 데스크톱 npmjs 폴백은 명시적일 때만 사용: Molty를 사용할 수 없고 사용자가 폴백을 원할 때 --account my.1password.com을 전달하십시오. 명시적 release/publish 요청은 잠금 해제 프롬프트에 대한 동의로 간주됩니다.
  • 항목이 없거나, 계정/금고가 모호하거나, 자격 증명 형식이 잘못되었거나, npm이 패키지 접근을 거부하거나, 요청한 패키지/버전이 저장소 릴리스 대상과 일치하지 않으면 중지하고 질문하십시오.
  • 하나의 지속적 tmux 세션 내에서 npm 인증 작업을 실행하십시오. 실패 시 재사용하십시오.
  • npm 인증을 임시 npmrc에 보관하고 명령 후 삭제하십시오.
  • 모든 헬퍼는 scripts/npm-auth.sh를 공유합니다: 저장된 registry_token 세션을 먼저 사용한 후, scripts/npm-auth-login.mjs를 통한 신규 6자리 OTP로 레지스트리 로그인; 성공한 폴백 세션은 동일한 항목에 캐시됩니다. 필드 추출, 레지스트리 로그인 또는 캐시 쓰기를 직접 구현하지 마십시오.
  • 자격 증명 선택은 정식 필드 id를 우선시하고, 그 다음 purpose, 그 다음 고유 레이블을 사용합니다. 중복 레이블만 일치하는 경우는 거부됩니다(레거시 npmjs는 동일한 레이블의 필드를 유지할 수 있음).
  • 임시 인증된 레지스트리 명령의 경우 scripts/npm-service.sh -- <npm 인수...>를 사용하십시오. 로컬 패키지의 경우 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

헬퍼는 ID를 확인하고, 기존 패키지 버전을 거부하며, 새 OTP로 게시하고, 만료된 OTP를 한 번 재시도하며, 레지스트리 가시성을 확인하고, 인증 파일을 정리합니다.

패키지 예약

동일한 tmux 세션 내에서 scripts/reserve-packages.sh 사용:

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

기능:

  • Molty 릴리스-자동화 항목을 op를 통해 한 번 읽습니다.
  • 저장된 레지스트리 세션을 재사용하거나 사용자 이름/비밀번호/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.

관련 스킬