Audit Library Health

Esegue ai-agent-skills doctor, check e curate review per verificare un workspace della libreria di skill

di MoizIbnYousaf · MoizIbnYousaf/Ai-Agent-Skills

Richiede configurazione ★ 5.6/10

Audit Library Health — Esegue ai-agent-skills doctor, check e curate review per verificare un workspace della libreria di skill

Cosa fa

Una checklist in cinque passaggi per verificare un workspace della libreria ai-agent-skills: validare il catalogo, eseguire doctor sulle skill installate, controllare le fonti upstream per gli aggiornamenti, confermare che i documenti README/WORK_AREAS generati siano sincronizzati e rivedere la coda di curatela. Si attiva quando si chiede se una libreria di skill è sana, coerente o sicura da pushare a un repo condiviso. È un sottile wrapper sulla CLI `npx ai-agent-skills` e non fa nulla senza quella CLI e un workspace inizializzato.

Rapporto di test

Installato ai-agent-skills@4.3.2 da npm e eseguiti tutti e cinque i passaggi del workflow per davvero, prima in una directory vuota e poi all'interno di un workspace creato con `init-library`. Tre passaggi funzionano come scritto (`doctor --format json` ha segnalato 3 voci rotte nel mio ~/.claude/skills; `check --format json` ha scansionato 249 installazioni; `curate review` ha stampato una coda vuota), ma due no: `npx ai-agent-skills validate` nudo alla root della libreria restituisce stato "error / No SKILL.md found" perché il `validate` fornito è un validatore per directory di skill, non il controllo del catalogo che il corpo descrive, e `build-docs --dry-run --format json` muore con ENOENT su `node_modules/ai-agent-skills/WORK_AREAS.md` (cli.js passa il contesto del workspace nello slot delle opzioni di `generatedDocsAreInSync`, quindi ricade nella directory del pacchetto in bundle, e WORK_AREAS.md è escluso dai `files` di package.json) — quindi il valore `currentlyInSync` su cui la skill dice di basarsi è irraggiungibile, mentre `build-docs` semplice ha successo. Confronto con la baseline: `npx ai-agent-skills help` elenca già doctor/check/validate/build-docs/curate review più `--format json` e `--dry-run`, e descrive validate correttamente, quindi un agente senza skill ha prodotto un audit pulito 5 su 5 mentre il corpo della skill ha prodotto un falso fallimento e un crash; le sezioni Gotchas e Health Checklist sono accurate e sono l'unico vero valore aggiunto della skill. Nessun problema di sicurezza riscontrato — nessun curl|sh, nessun blob base64, nessuna esfiltrazione di segreti, nessun testo di iniezione; `check` effettua richieste GitHub in uscita, cosa che la skill rivela.

Testato il: 2026-07-21 · Claude Code 2.x (agent harness)

Installazione

mkdir -p ~/.claude/skills/audit-library-health
curl -sL https://raw.githubusercontent.com/MoizIbnYousaf/Ai-Agent-Skills/HEAD/skills/audit-library-health/SKILL.md \
  -o ~/.claude/skills/audit-library-health/SKILL.md

# Required runtime — the skill is only CLI invocations:
npm i -g ai-agent-skills   # or use npx per-command

# Steps 1/4/5 need an initialized workspace, not just an install:
npx ai-agent-skills init-library my-library
cd my-library

Comandi e prompt di esempio

  • /audit-library-healthEsegue ai-agent-skills doctor, check e curate review per verificare un workspace della libreria di skill

Gli skill si attivano con richieste in linguaggio naturale, senza comandi da ricordare. Dopo l'installazione, prompt come questi lo attivano (in inglese):

  • Check the health of our skills library
  • Validate all skills and flag stale ones
  • Verify our generated docs are in sync