NenadZivotic/lite-agent-skills

Realiza una verificación rápida de estado de un paquete npm antes de instalarlo: versión más reciente, días desde la última publicación, indicador de deprecación, licencia y una heurística de obsoleto/deprecado. Una sola solicitud al registro sin autenticación. Úsalo cuando el usuario pregunte si un paquete npm está mantenido o es seguro agregarlo.

¿Qué es lite-agent-skills?

Esta habilidad para agentes de IA proporciona una verificación ligera del estado de un paquete npm sin necesidad de instalarlo ni ejecutar código. Realiza una única solicitud GET no autenticada al registro público de npm (registry.npmjs.org/<paquete>) para obtener metadatos básicos: versión más reciente, fecha de la última publicación, indicador de deprecación, licencia y una heurística que clasifica el paquete como 'obsoleto' si tiene más de 730 días sin publicar. No consulta descargas semanales ni cuenta de mantenedores, ya que esa funcionalidad está reservada para la versión completa. Es útil para que agentes como Claude Code, Cursor o Codex respondan preguntas sobre si un paquete npm está mantenido o es seguro de agregar a un proyecto, sin incurrir en riesgos de seguridad ni dependencias. La salida es un JSON sencillo y un resumen legible que recomienda si agregar, fijar versión o considerar una alternativa.

Compatible con~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/NenadZivotic/lite-agent-skills/tree/HEAD/npm-package-health-lite

Documentación

Estado de paquete npm (Lite)

Acceso a red (declarado)

Una solicitud GET a registry.npmjs.org/<paquete> — metadatos del registro público. Sin otros hosts, no se envía nada, no se instala el paquete, no se ejecuta código.

Límites

"Obsoleto" es una heurística basada en la reciente publicación — los paquetes silenciosos no están necesariamente abandonados.
No hay estadísticas de descargas semanales en esta versión ligera (esa es la segunda llamada API de la versión completa).

1. Ejecución

Requiere Node 18+, cero dependencias.

node <directorio-del-skill>/scripts/health.mjs <nombre-del-paquete>

JSON en stdout; código de salida 1 en caso de fallo de obtención, 2 si falta el argumento.

2. Leer el informe

latest, lastPublish, ageDays, deprecated, license, health.
Indicador: cadena deprecated presente, ageDays > 730, license: null.

3. Informe

<paquete>@<última>: <estado>
última publicación hace Y días · licencia <spdx|ninguna> · deprecado <sí/no>
<recomendación en una línea: seguro de agregar / fijar versión / considerar alternativa>

Lite vs completa

La versión completa npm-package-health adicionalmente reporta descargas semanales (api.npmjs.org), conteo de mantenedores y conteo de dependencias.