SkillProof tested Claude skills

Add Convention

Guardiano delle convenzioni del repo: triages duplicati, instrada al file corretto

di EvolveHQ · EvolveHQ/docflow

Richiede configurazione ★ 8.0/10

Add Convention — Guardiano delle convenzioni del repo: triages duplicati, instrada al file corretto

Cosa fa

Parte del toolkit docflow ADR. Prima di scrivere qualsiasi cosa, legge CONVENTIONS.md e AGENTS.md per intero, discute se la proposed rule vale la pena di essere codificata, quindi la instrada a una AGENTS.md hard rule, una CONVENTIONS.md section, un GLOSSARY term, o la consegna come un ADR. Si attiva su 'add a convention', 'make this a rule' o 'we should always X', e funziona solo in un repo che ha già il docflow scaffold.

Rapporto di test

Testato su un repo scaffolded con i templates di docflow, chiedendo due rules contemporaneamente: British English everywhere, e Conventional Commits. Senza la skill ho aggiunto entrambi come new sections, il che ha lasciato la commit rule dichiarata in tre posti e ha silenziosamente eliminato l'esistente mandatory 'Rationale:' footer; seguendo la skill, il duplicate è stato rejected con un pointer alla existing Git Contract section e la language rule è andata nello slot che CONVENTIONS.md già riserva per essa, mirrored come una AGENTS.md hard rule. Il problema è la precondition: su un plain repo senza CONVENTIONS.md o AGENTS.md la skill non ha nulla da leggere e non può procedere, quindi è necessario eseguire prima il docflow's bootstrap, e una copia di questa skill da sola non lo include. La sua assessment è anche una multi-question interview per quella che è spesso una one-line rule.

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

Installazione

git clone https://github.com/EvolveHQ/docflow.git
mkdir -p ~/.claude/skills
cd docflow && cp -r plugins/docflow/skills/add-convention ~/.claude/skills/add-convention

Comandi e prompt di esempio

  • /add-conventionGuardiano delle convenzioni del repo: triages duplicati, instrada al file corretto

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

  • Add a convention requiring British English spelling in our docs
  • Codify a Conventional Commits rule into AGENTS.md or CONVENTIONS.md
  • Should this proposed rule become a hard rule or just a glossary term?

Rapporto completo →