aithos-rr/aithos-selection/skill-reviewer

Claude Code and agent skill by aithos-rr/aithos-selection

Trust tier 2
  • community
  • ext:[{"type":"hook","description":"Pre/post lifecycle hooks"}]
LLM review pending
Source check pending

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-reviewer

Semi-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-builder e 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
  1. Leggere <path>/SKILL.md
  2. ls -la <path>/ per lista file e subfolder
  3. wc -l <path>/SKILL.md per conta righe (target < 500)
  4. Se scripts/ esiste, listare i file e l'interprete
  5. 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:

  1. name presente, lowercase+trattini+numeri, ≤ 64 char
  2. name NON contiene parole riservate anthropic o claude
  3. description presente, specifica cosa+quando, in terza persona
  4. description + when_to_use combinati ≤ 1,536 char

Raccomandati:

  1. description front-loaded (caso d'uso critico nei primi 200 char)
  2. description contiene ≥ 3 trigger phrases concrete
  3. description evita parole vaghe ("cose", "helper", "tool", "assistente")
  4. argument-hint presente se la skill accetta argomenti
  5. allowed-tools con scope (non Bash tout-court, usare Bash(cmd:*))
  6. disable-model-invocation: true se la skill ha side effect (deploy, commit, send)

Opzionali ma utili:

  1. paths glob se la skill è specifica per tipo file
  2. model o effort se task pesante
Fase 3 — Check struttura cartella
  1. SKILL.md < 500 righe (se supera, proporre offload in references/)
  2. No README.md, CHANGELOG.md nella cartella skill (solo file che Claude usa)
  3. Nomi file parlanti (no data.json, sì api-schema.json)
  4. Script hanno shebang se eseguibili
  5. Ogni file in references/ è linkato da SKILL.md (altrimenti è orfano)
  6. Path referenziati usano forward slash (no backslash Windows-style)
  7. Nessun path assoluto hardcoded (~/Dev/..., /Users/...)
Fase 4 — Check contenuto SKILL.md
  1. Struttura standard: # Titolo → ## When to use → ## Instructions → ## Examples → ## Gotchas → ## References
  2. "When to use" ha sia trigger sia anti-trigger
  3. "Instructions" con step atomici, verbi imperativi
  4. "Examples" con ≥ 2 esempi concreti (input + output)
  5. "Gotchas" con errori reali (non ipotetici)
  6. Niente prima persona ("Io faccio") o seconda persona ("Ti aiuto")
  7. Reference files linkati one-level-deep (no catene A → B → C)
Fase 5 — Check audience (se pubblico business non-dev)
  1. 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.

  1. Positive framing: ogni istruzione negativa ("non fare X") dovrebbe avere un counterpart positivo ("invece fai Y"). Eccezione consentita per le gotcha dichiaratamente didattiche.
  2. 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.
  3. 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:

markdown
# Review `<nome-skill>`
Path: <path>
## Blocker (rosso)
-Regola N: <descrizione issue + fix concreto>
## Minor (giallo)
-Regola N: <descrizione + fix>
## OK (verde)
-Regola N
## Fix prioritari (ordine di impatto)
1.<fix più importante>
2.<fix secondo>
## Comando per applicare il primo fix
<snippet ready-to-run>

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:

  1. Applicare i fix in ordine
  2. Re-invocare /skill-reviewer per verifica post-fix
  3. Se la skill passa, invitare /skill-builder next 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 Bash senza scope, name contiene "claude", path hardcoded
  • Fix prioritari:
  1. Riscrivere description in terza persona con ≥ 3 trigger
  2. Rinominare skill (rimuovere parola riservata dal name)
  3. Offload materiale dettagliato in references/full-reference.md per scendere < 500 righe
  4. Aggiungere ## Gotchas con ≥ 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: false per 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-reviewer dopo 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


_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

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/aithos-rr/aithos-selection/skill-reviewer/badge)](https://verified-skill.com/skills/aithos-rr/aithos-selection/skill-reviewer)

Something wrong with this skill or its page? Tell us.