SkillProof tested Claude skills

Add Convention

Strażnik konwencji repozytorium: triażuje duplikaty, kieruje do właściwego pliku

Autor: EvolveHQ · EvolveHQ/docflow

Działa po konfiguracji ★ 8.0/10

Add Convention — Strażnik konwencji repozytorium: triażuje duplikaty, kieruje do właściwego pliku

Co robi ten skill

Część zestawu narzędzi `docflow ADR`. Przed napisaniem czegokolwiek, w całości czyta `CONVENTIONS.md` i `AGENTS.md`, argumentuje, czy proponowana zasada jest w ogóle warta skodyfikowania, a następnie kieruje ją do twardej zasady `AGENTS.md`, sekcji `CONVENTIONS.md`, terminu w GLOSARIUSZU, lub przekazuje jako ADR. Uruchamia się na 'add a convention', 'make this a rule' lub 'we should always X', i działa tylko w repozytorium, które już posiada szkielet `docflow`.

Raport z testu

Testowano na repozytorium zbudowanym na podstawie własnych szablonów `docflow`, prosząc o dwie zasady jednocześnie: British English wszędzie i Conventional Commits. Bez umiejętności dodałem obie jako nowe sekcje, co spowodowało, że zasada commitowania była podana w trzech miejscach i cicho usunięto istniejącą obowiązkową stopkę 'Rationale:'; zgodnie z umiejętnością, duplikat został odrzucony ze wskaźnikiem do istniejącej sekcji Git Contract, a zasada językowa trafiła do slotu, który `CONVENTIONS.md` już dla niej rezerwuje, odzwierciedlona jako jedna twarda zasada `AGENTS.md`. Problem tkwi w warunku wstępnym: na zwykłym repozytorium bez `CONVENTIONS.md` lub `AGENTS.md` umiejętność nie ma nic do odczytania i nie może kontynuować, więc najpierw musisz uruchomić bootstrap `docflow`, a kopia tej jednej umiejętności sama w sobie go nie zawiera. Jej ocena to również wielopunktowy wywiad dla tego, co często jest jednozdaniową zasadą.

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

Instalacja

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

Komendy i przykładowe prompty

  • /add-conventionStrażnik konwencji repozytorium: triażuje duplikaty, kieruje do właściwego pliku

Skille uruchamiają się na zwykłe polecenia — bez komend do zapamiętania. Po instalacji aktywują go prompty takie jak te (po angielsku):

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

Pełny raport →