plugin-validator

Plugin Validator to umiejętność, która sprawdza poprawność wtyczek Claude Code pod kątem struktury katalogów, schematów JSON, formatu frontmatter i zgodności z repozytorium. Uruchamia się automatycznie, gdy wspomniasz o walidacji, sprawdzeniu lub błędach wtyczki. Narzędzie weryfikuje wymagane pliki (.claude-plugin/plugin.json, README.md, LICENSE), poprawność JSON-a, zgodność pól z schematem (nazwa w kebab-case, wersja semver, wymagane metadane autora) oraz spójność katalogu marketplace. Działa na tych samych zasadach co pipeline CI, pozwalając wyłapać problemy przed wysłaniem zmian do repozytorium.

1. Upewnij się, że masz dostęp do odczytu do katalogu wtyczki i pliku .claude-plugin/marketplace.extended.json na poziomie repozytorium. Zainstaluj narzędzia wymagane: jq do walidacji JSON (jq empty ), grep i find dostępne w PATH, oraz skrypt ./scripts/validate-all-plugins.sh w głównym katalogu repozytorium.

2. Wskaż ścieżkę do wtyczki, którą chcesz zwalidować, lub pozwól narzędziu użyć bieżącego katalogu, jeśli zawiera on podkatalog .claude-plugin/.

3. Narzędzie automatycznie sprawdzi obecność wymaganych plików: .claude-plugin/plugin.json (musi być poprawnym JSON-em), README.md (niepusty), LICENSE oraz co najmniej jeden katalog komponentów (commands/, agents/, skills/, hooks/ lub mcp/).

4. Walidacja schematu plugin.json obejmuje weryfikację wszystkich wymaganych pól: name (format kebab-case), version (semver x.y.z), description, author.name, author.email, license oraz keywords (tablica z minimum 2 elementami). Narzędzie odrzuci pola spoza dozwolonego zestawu.

5. Wyzwól walidację, używając fraz takich jak 'validate plugin', 'check plugin', 'verify' lub 'plugin errors'. Narzędzie uruchomi kompletne sprawdzenie i zwróci raport z ewentualnymi błędami lub potwierdzeniem zgodności.

6. Przejrzyj wyniki i napraw wskazane problemy przed committem zmian do repozytorium.