SkillProof tested Claude skills

Add Convention

Portvokter for repo-konvensjoner: triagerer duplikater, ruter til riktig fil

av EvolveHQ · EvolveHQ/docflow

Krever oppsett ★ 8.0/10

Add Convention — Portvokter for repo-konvensjoner: triagerer duplikater, ruter til riktig fil

Hva den gjør

Del av docflow ADR-verktøysettet. Før den skriver noe, leser den CONVENTIONS.md og AGENTS.md i sin helhet, argumenterer for om den foreslåtte regelen i det hele tatt er verdt å kodifisere, deretter ruter den til en AGENTS.md hard regel, en CONVENTIONS.md-seksjon, et GLOSSARY-begrep, eller overleverer den som en ADR. Utløses av 'add a convention', 'make this a rule' or 'we should always X', og fungerer kun i et repo som allerede inneholder docflow-stillaset.

Testrapport

Testet på et repo scaffolded with docflow's own templates, asking for two rules at once: British English everywhere, and Conventional Commits. Uten ferdigheten la jeg til begge som nye seksjoner, which left the commit rule stated in three places and quietly dropped the existing mandatory 'Rationale:' footer; following the skill, the duplicate was rejected with a pointer to the existing Git Contract section and the language rule went into the slot CONVENTIONS.md already reserves for it, mirrored as one AGENTS.md hard rule. Haken er forutsetningen: on a plain repo with no CONVENTIONS.md or AGENTS.md the skill has nothing to read and cannot proceed, so you must run docflow's bootstrap first, and a copy of this one skill alone does not include it. Dens vurdering er også et multi-question interview for what is often a one-line rule.

Testet på: 2026-08-10 · Claude Code 2.x (agent harness)

Installer

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

Kommandoer og eksempelprompter

  • /add-conventionPortvokter for repo-konvensjoner: triagerer duplikater, ruter til riktig fil

Skills utløses av vanlige forespørsler — ingen kommandoer å huske. Etter installasjonen aktiverer prompter som disse skillen (på engelsk):

  • 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?

Full rapport →