NenadZivotic/lite-agent-skills

Verificação rápida de saúde de um pacote npm antes de instalá-lo — versão mais recente, dias desde a última publicação, sinalizador de descontinuação, licença e uma heurística de pacote desatualizado/obsoleto. Uma única requisição não autenticada ao registro. Use quando o usuário perguntar se um pacote npm é mantido ou seguro para adicionar.

O que é lite-agent-skills?

Esta skill fornece uma verificação rápida e leve da saúde de um pacote npm diretamente do registro público, sem instalar o pacote ou executar seu código. Ela consulta o endpoint `registry.npmjs.org/<package>` com uma única requisição GET para obter metadados essenciais: versão mais recente, data da última publicação, sinalizador de descontinuação, licença e uma heurística que marca o pacote como 'desatualizado' se não houver publicação há mais de 730 dias ou se a licença for nula. É útil para desenvolvedores que desejam avaliar rapidamente se um pacote ainda é mantido ou se há sinais de abandono antes de adicioná-lo como dependência. A skill suporta Node.js 18+ sem dependências externas e exige apenas o nome do pacote como argumento. A saída é um JSON detalhado e um relatório legível em uma linha, com uma recomendação prática (seguro adicionar, fixar versão ou considerar alternativa). Seu design minimalista evita chamadas extras de API, mantendo a operação rápida e gratuita. A versão completa (não incluída aqui) adiciona estatísticas de download semanais, contagem de mantenedores e contagem de dependências.

Funciona com~Claude Code~Codex CLI~Cursor

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

Documentação

Saúde do Pacote npm (Lite)

Acesso à rede (declarado)

Um GET para registry.npmjs.org/<package> — metadados públicos do registro. Nenhum outro host, nada é enviado, nenhum pacote é instalado, nenhum código é executado.

Limites

"Desatualizado" é uma heurística baseada na recência da publicação — pacotes silenciosos não são necessariamente abandonados.
Sem estatísticas de downloads semanais nesta versão lite (essa é a segunda chamada de API da versão completa).

1. Executar

Requer Node 18+, zero dependências.

node <skill-dir>/scripts/health.mjs <nome-do-pacote>

JSON na saída padrão; código de saída 1 em caso de falha na requisição, 2 se o argumento estiver faltando.

2. Ler o relatório

latest, lastPublish, ageDays, deprecated, license, health.
Sinalizadores: string deprecated presente, ageDays > 730, license: null.

3. Relatório

<pacote>@<latest>: <health>
última publicação há Y dias · licença <spdx|none> · descontinuado <sim/não>
<recomendação em uma linha: seguro adicionar / fixar versão / considerar alternativa>

Lite vs completa

A versão completa npm-package-health adicionalmente reporta downloads semanais (api.npmjs.org), contagem de mantenedores e contagem de dependências.