npm-guide
/npm-guide
Sprawdza pakiet npm przed publikacją: pola package.json, licencję, pliki, prowenancję i flagi dostępu, z bezpiecznym pomijaniem istniejących wersji.
- Autor
- xonovex ↗
- Repozytorium
- platform ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 08.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 7
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 08.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Sprawdza pakiet npm przed publikacją: pola package.json, licencję, pliki, prowenancję i flagi dostępu, z bezpiecznym pomijaniem istniejących wersji.
Wyzwalacze z opisu
Oryginalny opis (EN)
Use when publishing an npm package or checking that one is ready to publish. Triggers on prompts about npm publish, publish-readiness or package.json validation (name/version/license/repository/files/publishConfig/private), idempotent publishing (skip if the version already exists), provenance and access flags, dist-tags, or platform-specific (os/cpu/libc) native-binary packages, even when the user doesn't say 'npm'.
Jak działa
- Core Principles
- Operations
- Gotchas
- Progressive Disclosure
Podgląd SKILL.md
--- name: npm-guide description: "Use when publishing an npm package or checking that one is ready to publish. Triggers on prompts about npm publish, publish-readiness or package.json validation (name/version/license/repository/files/publishConfig/private), idempotent publishing (skip if the version already exists), provenance and access flags, dist-tags, or platform-specific (os/cpu/libc) native-binary packages, even when the user doesn't say 'npm'." --- # npm Publishing Guidelines Validate publish-readiness and publish packages idempotently, with correct access, provenance, dist-tags, and platform fields. ## Core Principles - **npm requires only name + version**: `license` / `repository` / `files` are house policy, not npm rules, and `private: true` blocks publishing outright, see [references/publish-check.md](references/publish-check.md) - **Provenance needs CI + OIDC**: `--provenance` only works from a supported runner with `id-token` permission, the public registry, and a matching `repository`; it errors elsewhere, see [references/publish.md](references/publish.md) - **Access is derived**: unscoped packages are always public; scoped packages default to restricted and need `--access public` on first publish, see [references/publish.md](references/publish.md) - **Platform packages gate install**: `os` / `cpu` / `libc` restrict where a native-binary package installs; inject and restore those fields safely, see [references/publish.md](references/publish.md) ## Operations - **publish-check**: validate a package.json is publish-ready, separating npm rules from policy, see [references/publish-check.md](references/publish-check.md) - **publish**: publish a package idempotently with provenance / access / dist-tag / platform handling, see [references/publish.md](references/publish.md) ## Gotchas - Hard-requiring `license` / `repository` / `files` exceeds npm (it warns, it doesn't block), and rejecting a `repository` shorthand string like `github:org/repo` is wrong: treat the three as policy - `publishConfig.access` is only meaningful for `@scoped` names; unscoped packages cannot be restricted: don't hard-require it universally - `--provenance` fails outside a supported CI/OIDC environment: gate it on CI, never expect a local no-op - `files` supports globs and `dist/` is built later: don't existence-check glob entries or build outputs; `package.json` / `README` / `LICENSE` / `main` are always included - Inject-then-restore of `os` / `cpu` / `libc` must restore on failure (try/finally), and `libc` is a silent no-op unless `os` includes `linux` - A pre-release published without `--tag` lands on `latest` and installs by default: derive a dist-tag from the version ## Progressive Disclosure - Read [references/publish-check.md](references/publish-check.md) - Load when validating that a package is ready to publish - Read [references/publish.md](references/publish.md) - Load when publishing (idempotency, provenance, access, dist-tag, platform fields)
Pliki w paczce (7)
- SKILL.md 3 KB
- SOURCES.md 3 KB
- eval-queries.json 3 KB
- evals.json 3 KB
- moon.yml 1 KB
- references/publish-check.md 2 KB
- references/publish.md 2 KB
Wersje
W bazie nie ma innych skilli o nazwie npm-guide.
Migawka bazy z 13.11.2026 · wersja paczki 13d33b36bcbb (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100bun-publishing
Publikuje pakiety npm zbudowane z Bun: konfiguracja package.json, pakowanie narzędzi CLI, podpisy provenance i automatyzacja wydań, w tym publishConfig, files, bin i release-please. - 100fast-npm-meta
Odpytuje metadane pakietów npm przez CLI fast-npm-meta: wersje, dist-tagi, daty publikacji, wymagania silników i rozwiązywanie zakresów wersji, szybciej i taniej tokenowo niż npm view. - 100deploy-npm
Prowadzi wydanie pakietu npm: wersja, CHANGELOG, publikacja i weryfikacja. - 90npm-publish
Publikuje pakiet w npm: wydanie wersji, weryfikacja listingu w rejestrze i pi.dev, diagnoza błędów uwierzytelniania (E403), przepływ tokenowy z NPM_TOKEN i bramka wycieków przed każdą publikacją. - 90release-and-publish
Publikuje pakiet npm, czyta rejestr npm, sprawdza, czy wersja już istnieje, i wyznacza tagi wydań oraz bramkę wieku wydania w CI. - 100publish-npm-package
Pokazuje, jak publikować pakiety do npm przez GitHub Actions, z trusted publishing, provenance i semantic-release.