CommunityCoding & Developmentgithub.com

NenadZivotic/lite-agent-skills

Quick health check on an npm package before installing — latest version, days since last publish, deprecation flag, license, and a stale/deprecated heuristic. One unauthenticated registry request. Use when the user asks if an npm package is maintained or safe to add.

What is lite-agent-skills?

lite-agent-skills is a Claude Code agent skill that quick health check on an npm package before installing — latest version, days since last publish, deprecation flag, license, and a stale/deprecated heuristic. One unauthenticated registry request. Use when the user asks if an npm package is maintained or safe to add.

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

Installed? Explore more Coding & Development skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

npm Package Health (Lite)

Network access (declared)

One GET to registry.npmjs.org/<package> — public registry metadata. No other hosts, nothing sent, no package installed, no code executed.

Boundaries

  • "Stale" is a heuristic on publish recency — quiet packages aren't necessarily abandoned.
  • No weekly-download stats in this lite version (that is the full version's second API call).

1. Run

Requires Node 18+, zero dependencies.

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

JSON on stdout; exit 1 on fetch failure, 2 on missing argument.

2. Read the report

  • latest, lastPublish, ageDays, deprecated, license, health.
  • Flag: deprecated string present, ageDays > 730, license: null.

3. Report

<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 vs full

The full npm-package-health additionally reports weekly downloads (api.npmjs.org), maintainer count, and dependency count.

Individual skills in this repo

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

Related Skills