aithos-rr/aithos-selection/skill-reviewer
Claude Code and agent skill by aithos-rr/aithos-selection
- community
- ext:[{"type":"hook","description":"Pre/post lifecycle hooks"}]
Checking that the SKILL.md file is still in the repository.
Audita una skill Claude Code esistente contro 27 best practice Anthropic e produce un report con severity verde/giallo/rosso più fix concreti. Da attivare quando l'utente dice "rivedi questa skill", "è fatta bene?", "ottimizza la skill X", "review skill"; dopo aver usato /skill-builder per validazione pre-publish; prima di installare una skill di terze parti per screening qualità.
Install
npx vskill@latest install aithos-rr/aithos-selection/skill-reviewerSemi-extensibleMentions customization, but needs skill-specific knowledge. Read the extensible skills standard
SKILL.md
The same SKILL.md was published earlier as aithos-rr/aithos-selection/skill-reviewer.
Skill Reviewer
Audit strutturato di una skill Claude Code contro le best practice ufficiali Anthropic. Produce un report con issue classificati per severity e fix concreti.
When to use
Attivare quando:
- L'utente ha appena creato una skill con
/skill-buildere vuole validarla - Una skill non si auto-attiva più come prima
- Prima di installare una skill di terze parti (screening qualità)
- Richiesta esplicita "rivedi questa skill", "è fatta bene?", "review skill"
Non attivare se:
- La skill non esiste (proporre invece
/skill-builder) - Serve solo eseguire la skill (nessun audit richiesto)
Instructions
Fase 1 — Discovery
- Leggere
<path>/SKILL.md ls -la <path>/per lista file e subfolderwc -l <path>/SKILL.mdper conta righe (target < 500)- Se
scripts/esiste, listare i file e l'interprete - Se
references/esiste, listare i file e la dimensione
Fase 2 — Check frontmatter (12 regole)
Valutare ciascuna regola con verde (OK), giallo (minor), rosso (blocker).
Obbligatori:
namepresente, lowercase+trattini+numeri, ≤ 64 charnameNON contiene parole riservateanthropicoclaudedescriptionpresente, specifica cosa+quando, in terza personadescription+when_to_usecombinati ≤ 1,536 char
Raccomandati:
descriptionfront-loaded (caso d'uso critico nei primi 200 char)descriptioncontiene ≥ 3 trigger phrases concretedescriptionevita parole vaghe ("cose", "helper", "tool", "assistente")argument-hintpresente se la skill accetta argomentiallowed-toolscon scope (nonBashtout-court, usareBash(cmd:*))disable-model-invocation: truese la skill ha side effect (deploy, commit, send)
Opzionali ma utili:
pathsglob se la skill è specifica per tipo filemodeloeffortse task pesante
Fase 3 — Check struttura cartella
- SKILL.md < 500 righe (se supera, proporre offload in
references/) - No
README.md,CHANGELOG.mdnella cartella skill (solo file che Claude usa) - Nomi file parlanti (no
data.json, sìapi-schema.json) - Script hanno shebang se eseguibili
- Ogni file in
references/è linkato da SKILL.md (altrimenti è orfano) - Path referenziati usano forward slash (no backslash Windows-style)
- Nessun path assoluto hardcoded (
~/Dev/...,/Users/...)
Fase 4 — Check contenuto SKILL.md
- Struttura standard:
# Titolo→## When to use→## Instructions→## Examples→## Gotchas→## References - "When to use" ha sia trigger sia anti-trigger
- "Instructions" con step atomici, verbi imperativi
- "Examples" con ≥ 2 esempi concreti (input + output)
- "Gotchas" con errori reali (non ipotetici)
- Niente prima persona ("Io faccio") o seconda persona ("Ti aiuto")
- Reference files linkati one-level-deep (no catene
A → B → C)
Fase 5 — Check audience (se pubblico business non-dev)
- Zero jargon dev non spiegato, output orientato al risultato business
Fase 5b — Check pattern Claude 4.5/4.6-specific
Tre regole emerse dalla community (ActiveMemory/ctx-skill-audit, okwinds/skill-review-audit) per i modelli Claude recenti, dove i pattern di over-triggering e mandates rigidi hanno effetto peggiore che in passato.
- Positive framing: ogni istruzione negativa ("non fare X") dovrebbe avere un counterpart positivo ("invece fai Y"). Eccezione consentita per le gotcha dichiaratamente didattiche.
- Motivation over mandates: preferire ragionamento al posto di imperativi rigidi. Invece di "MUST NEVER...", scrivere "perché X causa problema Y, preferire Z". I modelli Claude 4.5/4.6 rispondono meglio alla motivazione che alle caps.
- Overtriggering calibration: eccesso di CAPS emphasis nella description (CRITICAL, MUST, ALWAYS, NEVER) può causare over-triggering indesiderato. Usare caps solo per acronimi (API, JSON, YAML); preferire prose normale per enfasi.
Fase 6 — Report
Produrre output nel formato:
Criterio di publish-ready: maggioranza verde + zero blocker rosso. Anche con pochi minor, se i fondamentali (description, gotchas, third-person) sono OK, la skill è pubblicabile.
Dopo il report, proporre all'utente di:
- Applicare i fix in ordine
- Re-invocare
/skill-reviewerper verifica post-fix - Se la skill passa, invitare
/skill-buildernext time per nuove skill con lo stesso standard
Examples
Esempio 1 — Skill ben fatta
Input: skills/meta/skill-builder/ Output: 26 regole verdi, 1 minor (allowed-tools potrebbe restringere ancora). Publish-ready.
Esempio 2 — Skill problematica
Input: skills/esperimenti/my-helper/ Output:
- 3 blocker: description in prima persona, SKILL.md 800 righe, no trigger phrases
- 5 minor: allowed-tools
Bashsenza scope,namecontiene "claude", path hardcoded - Fix prioritari:
- Riscrivere description in terza persona con ≥ 3 trigger
- Rinominare skill (rimuovere parola riservata dal name)
- Offload materiale dettagliato in
references/full-reference.mdper scendere < 500 righe - Aggiungere
## Gotchascon ≥ 2 errori reali
Gotchas
- Non auditare per autorità: una skill può violare una regola e avere buon motivo. Chiedere contesto prima di marcare un blocker (es.
user-invocable: falseper skill di solo background). - Contare gli OK non basta: 25 verdi su 27 possono essere peggio di 22 su 27 se le 2 violazioni sono nei fondamentali (description, gotchas, third-person).
- Additive-only PR per skill di terzi: proporre i fix come aggiunte, non riscrittura totale. Rispettare lo stile dell'autore.
- Audit dopo ogni iterazione: ri-lanciare
/skill-reviewerdopo ogni modifica significativa per confermare che i fix non abbiano introdotto nuovi issue. - Le regole ufficiali possono cambiare: le docs Anthropic evolvono. Se un blocker è controverso, verificare sulla fonte pubblica prima di bloccare il publish.
References
- references/review-checklist.md: 27 regole espanse con esempi OK e KO
_Basato su best-practices Anthropic, docs Anthropic, agentskills.io, pattern da daymade/claude-code-skills. MIT License._
Security
- Security scanPassed, 100 of 100Pattern checks on the skill's files.
- Model reviewNot runA model review is scheduled for the next rescan.
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/skill-reviewer/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Extension points
hookPre/post lifecycle hooks
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/aithos-rr/aithos-selection/skill-reviewer)