Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

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.

Repozytorium
platform ↗
Licencja
MIT
Ostatnia zmiana repozytorium
08.10.2026

Ocena i bezpieczeństwo

90/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść25 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
7
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 08.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

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

t say
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

  1. Core Principles
  2. Operations
  3. Gotchas
  4. Progressive Disclosure
Sekcje z nagłówków SKILL.md, w oryginale · 31 linii, 318 słów
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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.