SkillProof tested Claude skills

Agent Instructions

Scrive un CLAUDE.md/AGENTS.md che elenca solo comandi verificati e reali 'gotcha'

di nimadorostkar · nimadorostkar/Claude-Skills-collection

Promosso ★ 9.2/10

Agent Instructions — Scrive un CLAUDE.md/AGENTS.md che elenca solo comandi verificati e reali 'gotcha'

Cosa fa

Guida per la scrittura del file di istruzioni del progetto che un agente di codifica legge prima di toccare il tuo repo — CLAUDE.md, AGENTS.md o equivalente. Insiste che ogni comando nel file sia eseguito prima di essere scritto, e che il file registri i fallimenti osservati dell'agente e i vincoli rigidi piuttosto che ribadire ciò che il codice già dice. Si attiva quando chiedi di scrivere, aggiornare o correggere un file di istruzioni del progetto.

Rapporto di test

Ho scritto un CLAUDE.md per il repo consensus-loop due volte e poi ho eseguito ogni comando in entrambi i file. La versione senza skill spediva cinque comandi di cui tre erano rotti, incluso `node --test tests/` — l'esatto comando che il vero CLAUDE.md del repo contiene, che fallisce su Node 26 con 'Cannot find module <repo>/tests'. Seguendo la regola della skill che i comandi devono essere eseguiti prima di essere scritti ha trasformato due di quelle trappole in linee esplicite 'do-not-run' con il testo di errore reale, e ha fatto emergere una terza: `npm run quality` in test-harness non può passare perché @types/node è mancante, quindi `npx vitest run` (44/44 verde) l'ha sostituito. Il costo del file migliore è stato di 59 righe contro 39.

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

Installazione

git clone https://github.com/nimadorostkar/Claude-Skills-collection.git
mkdir -p ~/.claude/skills
cd Claude-Skills-collection && cp -r skills/agent-tooling/agent-instructions ~/.claude/skills/agent-instructions

Comandi e prompt di esempio

  • /agent-instructionsScrive un CLAUDE.md/AGENTS.md che elenca solo comandi verificati e reali 'gotcha'

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

  • Write a CLAUDE.md for this repo listing only verified commands
  • Refresh our AGENTS.md so it reflects real agent failures we hit
  • Fix our project instruction file, it has commands that don't run

Rapporto completo →