SkillProof tested Claude skills

Add Convention

Guardián de convenciones de repositorio: clasifica duplicados, enruta al archivo correcto

Por EvolveHQ · EvolveHQ/docflow

Funciona con configuración ★ 8.0/10

Add Convention — Guardián de convenciones de repositorio: clasifica duplicados, enruta al archivo correcto

Qué hace

Part of the docflow ADR toolkit. Before writing anything it reads CONVENTIONS.md y AGENTS.md in full, argues whether the proposed rule is worth codifying at all, then routes it a an AGENTS.md hard rule, a CONVENTIONS.md section, a GLOSSARY term, o hands it off as an ADR. Se activa on 'add a convention', 'make this a rule' o 'we should always X', y only works in a repo that already carries the docflow scaffold.

Informe de la prueba

Probado on a repo scaffolded con docflow's own templates, asking for two rules at once: British English everywhere, y Conventional Commits. Without the skill I appended both as new sections, which left the commit rule stated in three places y quietly dropped the existing mandatory 'Rationale:' footer; following the skill, el duplicate fue rejected con a pointer a la existing Git Contract section y la language rule went into the slot CONVENTIONS.md already reserves for it, mirrored as one AGENTS.md hard rule. El catch es la precondition: on a plain repo con no CONVENTIONS.md o AGENTS.md la skill has nothing to read y cannot proceed, so you must run docflow's bootstrap first, y a copy of this one skill alone does not include it. Su assessment es also a multi-question interview for what is often a one-line rule.

Probado el: 2026-08-10 · Claude Code 2.x (agent harness)

Instalación

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

Comandos y prompts de ejemplo

  • /add-conventionGuardián de convenciones de repositorio: clasifica duplicados, enruta al archivo correcto

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

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

Informe completo →