NenadZivotic/lite-agent-skills

npm 패키지 설치 전 빠른 상태 확인 — 최신 버전, 마지막 게시일, 폐기 플래그, 라이선스 및 부실/폐기 휴리스틱을 제공합니다. 인증 없이 단일 레지스트리 요청만 수행합니다.

lite-agent-skills란 무엇인가요?

이 스킬은 사용자가 npm 패키지가 유지보수되는지 또는 설치해도 안전한지 물을 때, 패키지의 기본 상태를 빠르게 확인하는 데 사용됩니다. `Node 18+` 환경에서 단일 `registry.npmjs.org/<package>` GET 요청으로 최신 버전, 마지막 게시 후 경과 일수, 폐기 여부, 라이선스 타입을 조회하여 'stale' 또는 'deprecated' 휴리스틱을 적용한 상태 보고서를 반환합니다. 이 경량 버전은 주간 다운로드 통계를 포함한 전체 버전과 달리, 단일 요청으로 간단한 상태만 확인하며, 사용자가 '이 패키지 살아있는 거 맞아?' 또는 'npm install 전에 확인해줘'와 같은 질문을 할 때 트리거됩니다.

지원 대상~Claude Code~Codex CLI~Cursor

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

문서

npm 패키지 상태 (Lite)

네트워크 액세스 (선언됨)

registry.npmjs.org/<package>에 대한 GET 요청 하나 — 공개 레지스트리 메타데이터. 다른 호스트 없음, 아무것도 전송하지 않음, 패키지 설치 없음, 코드 실행 없음.

경계

"부실"은 게시 최신성에 대한 휴리스틱 — 조용한 패키지가 반드시 유기된 것은 아닙니다.
이 경량 버전에는 주간 다운로드 통계가 없습니다 (해당 기능은 전체 버전의 두 번째 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>
마지막 게시일 Y일 전 · 라이선스 <spdx|없음> · 폐기 <예/아니오>
<한 줄 권장 사항: 추가해도 안전함 / 특정 버전 고정 / 대안 고려>

경량 버전 vs 전체 버전

전체 npm-package-health 버전은 추가로 주간 다운로드(api.npmjs.org), 유지보수자 수, 종속성 수를 보고합니다.