skill-evaluator

Skill Evaluator to narzędzie do kompleksowej oceny umiejętności Clawdbota pod kątem jakości, niezawodności i gotowości do publikacji. Wykorzystuje hybrydowe podejście: automatyczne sprawdzenia struktury plików, składni kodu, dokumentacji oraz ręczną ocenę na podstawie 25 kryteriów z czterech standardów (ISO 25010, OpenSSF, Shneiderman, heurystyki dla agentów). Idealne dla zespołów zarządzających katalogiem umiejętności, którzy chcą utrzymać wysoki standard przed udostępnieniem nowych narzędzi.

1. Przygotuj ścieżkę do umiejętności, którą chcesz ocenić — powinna zawierać plik SKILL.md, skrypty i dokumentację.
2. Uruchom automatyczne sprawdzenia poleceniem python3 scripts/eval-skill.py /ścieżka/do/umiejętności. Narzędzie przeskanuje strukturę katalogów, frontmatter, jakość opisu, składnię skryptów, zależności i zmienne środowiskowe. Dodaj flagę --json jeśli chcesz wynik w formacie maszynowym lub --verbose dla pełnych szczegółów.
3. Przeczytaj dokumentację umiejętności (plik SKILL.md) i przejrzyj kod skryptów, aby zrozumieć funkcjonalność i ocenić jakość implementacji, obsługę błędów oraz testowalność.
4. Użyj rubryk z pliku references/rubric.md do ręcznej oceny wszystkich 25 kryteriów w 8 kategoriach — każde kryterium ma konkretne opisy dla poziomów od 0 do 4 punktów.
5. Skopiuj szablon assets/EVAL-TEMPLATE.md do katalogu umiejętności jako EVAL.md i wypełnij go wynikami automatycznymi, ocenami ręcznymi oraz priorytetami znalezionych problemów (P0 — blokuje publikację, P1 — powinno być naprawione, P2 — ulepszenie opcjonalne).