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

npm パッケージヘルスチェック(Lite版)

npm パッケージをインストールする前に、最新バージョン、最終公開からの日数、非推奨フラグ、ライセンス、および非推奨/放置の可能性をワンショットでチェックします。認証不要のレジストリリクエスト1回で動作。ユーザーが「このパッケージはメンテナンスされているか?安全に追加できるか?」と尋ねたときに使用します。

npm パッケージヘルスチェック(Lite版) とは?

このスキルは、npm パッケージの簡易ヘルスチェックを提供する軽量ツールです。`registry.npmjs.org/<package>` への1回の GET リクエストのみで、最新バージョン、最終公開日からの経過日数、非推奨フラグ、ライセンス情報を取得し、「stale」(放置)または「deprecated」(非推奨)のヒューリスティック判定を行います。Node 18+ で動作し、依存関係はゼロ。出力は JSON(stdout)で、失敗時は終了コード1、引数欠落時は2を返します。フルバージョンとは異なり、週間ダウンロード数やメンテナー数、依存関係数の取得は行いません。Claude Code, Cursor, Codex などの AI エージェントから「このパッケージはまだメンテナンスされている?」や「安全に追加できる?」といった質問に答えるために利用できます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/NenadZivotic/lite-agent-skills/tree/HEAD/npm-package-health-lite

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

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

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

ドキュメント

npm パッケージヘルスチェック(Lite版) は何をしますか?

ネットワークアクセス(宣言済み)

registry.npmjs.org/<package> への1回の GET リクエスト — 公開レジストリのメタデータのみ。他のホストへのアクセスなし、データ送信なし、パッケージのインストールなし、コード実行なし。

制約

  • 「Stale」は公開の新しさに基づくヒューリスティックです — 静かなパッケージが必ずしも放棄されているわけではありません。
  • このLite版では週間ダウンロード統計は取得しません(フルバージョンで2回目のAPI呼び出しを行います)。

1. 実行

Node 18+ 必須、依存関係ゼロ。

node <skill-dir>/scripts/health.mjs <package-name>

JSON が stdout に出力されます。フェッチ失敗時は終了コード 1、引数欠落時は 2 を返します。

2. レポートを読む

  • latest, lastPublish, ageDays, deprecated, license, health
  • フラグ: deprecated 文字列が存在する、ageDays > 730、license: null

3. レポート

<package>@<latest>: <health>
last publish Y days ago · license <spdx|none> · deprecated <yes/no>
<one-line recommendation: safe to add / pin version / consider alternative>

Lite版とフル版の比較

フル版 npm-package-health は、追加で週間ダウンロード数(api.npmjs.org)、メンテナー数、依存関係数を報告します。

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

関連スキル