Jak oceniamy skille
Biblioteka zbiera skille z publicznych repozytoriów na GitHubie, ocenia każdy plik SKILL.md tą samą miarą i pokazuje tylko te, które przeszły wszystkie progi.
Skąd są skille
Punktem wyjścia był katalog skillsclau.de (33 971 skilli z 3957 repozytoriów), a potem pełne foldery skilli pobrane z tych repozytoriów na GitHubie: 333 885 plików SKILL.md. Po usunięciu identycznych kopii, artefaktów (testy, kopie zapasowe, archiwa) i bliskich duplikatów zostało 236 717 skilli kanonicznych.
| Etap | Skilli |
|---|---|
| Pliki SKILL.md w repozytoriach | 333 885 |
| Skille kanoniczne (bez kopii i artefaktów) | 236 717 |
| Klasa „dobry” | 89 217 |
| Dobre, aktualne i bez sygnałów ryzyka | 82 798 |
| Do tego otwarta licencja | 64 025 |
| W bibliotece: bez skilli do ataków i testów penetracyjnych | 61 277 |
Wynik jakości (0 do 100)
Wynik liczy skrypt na podstawie samego pliku SKILL.md i repozytorium. Kryteria wynikają z dobrych praktyk Anthropic dla Agent Skills (platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices) i specyfikacji formatu (agentskills.io/specification).
| Część | Punkty | Co sprawdzamy |
|---|---|---|
| Format | 25 | Frontmatter z nazwą i opisem (10), poprawna nazwa (5), opis do 1024 znaków (5), nazwa zgodna z folderem (5). |
| Odkrywalność | 25 | Opis mówi, kiedy użyć skilla (12), ma od 80 do 1024 znaków (8), jest w 3. osobie (5). |
| Treść | 35 | Co najmniej 150 słów i do 500 linii (12), co najmniej 2 nagłówki (8), listy kroków (5), przykłady albo kod (10). |
| Higiena | 15 | Bez zaślepek typu TODO (8), bez ścieżek Windows (2), z licencją (5). |
Klasa „dobry” wymaga wyniku co najmniej 80, opisu z sytuacją użycia, licencji, co najmniej 150 słów i zera zaślepek. Skille przestarzałe nie trafiają do biblioteki: z oznaczeniem deprecated, z odwołaniami do wycofanych modeli albo API, z repozytorium bez zmian od ponad 6 mies.
Wynik mierzy formę i kompletność. Nie mówi, czy skill dobrze rozwiązuje problem. Dlatego losowe próbki z każdej klasy zostały przejrzane ręcznie, a „Wybór Bartosza” to krótka lista skilli wybranych przez autora biblioteki.
Skan ryzyka
Skill może zawierać instrukcje dla modelu i skrypty, które Claude uruchomi. Skan szuka w SKILL.md i skryptach sygnałów nadużycia. Każdy sygnał wyklucza skill z biblioteki.
Od 27.10.2026 (wersja 1.3.0) skan obejmuje każdy skrypt w opublikowanej paczce, także w podkatalogach i w plikach .ts, .tsx i .jsx. Pierwsza ocena sprawdzała najwyżej 30 skryptów na skill, a w części repozytoriów tylko pliki obok SKILL.md. Ponowny skan usunął 15 skilli i poprawił liczbę skryptów w 351. Skill ze skryptem większym niż 2 MB, którego nie da się sprawdzić, nie trafia do biblioteki. Skaner i jego reguły są w repozytorium strony (skille-narzedzia/skanuj_paczki.py).
- Wykonywanie zdekodowanego kodu (base64 do powłoki, eval albo exec zdekodowanego tekstu), reverse shell.
- Odczyt kluczy SSH, haseł systemowych i poświadczeń chmury, dostęp do pęku kluczy macOS.
- Frazy nadpisujące instrukcje modelu poza cytatem, ukryte znaki sterujące kierunkiem tekstu.
- Wysyłanie danych do usług przechwytujących (webhook.site, requestbin, pipedream, interact.sh, webhooki Discorda), tunele ngrok.
- Pobieranie i uruchamianie skryptów z sieci jednym poleceniem (curl do powłoki), kasowanie katalogu domowego.
- Komentarze HTML z poleceniami dla modelu.
Biblioteka nie zawiera skilli do prowadzenia ataków: testów penetracyjnych, red teamingu, exploitów, omijania zabezpieczeń, jailbreaków i OSINT o osobach. Odpadły też całe repozytoria poświęcone głównie tym tematom. Skille do obrony, przeglądu konfiguracji i bezpiecznego kodu zostały w obszarze „Bezpieczeństwo”, o ile nie dotyczą technik ataku.
Skan działa na wzorcach i nie wykrywa wszystkiego. Przed instalacją przejrzyj SKILL.md, a skrypty szczególnie. Biblioteka niczego z paczek nie uruchamiała, a pliki wykonywalne (np. .exe, .dylib, .so, .jar) nie trafiają do paczek .zip.
Licencje
W bibliotece są tylko skille z repozytoriów z otwartą licencją, rozpoznaną w pliku LICENSE. Odpadły repozytoria bez licencji (wszystkie prawa zastrzeżone), z licencją niekomercyjną (CC-BY-NC), z własnymi warunkami i z licencją nierozpoznaną. Każda paczka .zip zawiera tekst licencji repozytorium i plik ZRODLO.txt z adresem źródła.
| Licencja | Skilli | Co oznacza |
|---|---|---|
| MIT | 47 052 | Można używać i zmieniać, z zachowaniem informacji o autorze i licencji. |
| Apache-2.0 | 10 530 | Jak MIT, plus informacja o zmianach i licencja patentowa. |
| AGPL-3.0 | 2 279 | Copyleft: przeróbki udostępniane innym, także przez sieć, muszą mieć tę samą licencję. |
| Inne otwarte | 1 416 | Pozostałe otwarte: BSD, GPL, LGPL, MPL, CC-BY, CC0, Unlicense. |
To informacja, nie porada prawna. Wiążący jest tekst licencji w repozytorium autora.
Połączenie przez MCP
Serwer MCP pozwala Claude przeszukiwać bibliotekę w rozmowie, czytać SKILL.md i instalować skill po twojej zgodzie. Serwer działa tylko do odczytu i nie wymaga logowania.
Adres serwera: https://sokolinski.com/skille/mcp
Claude.ai i aplikacja Claude
- W ustawieniach otwórz konektory i dodaj własny konektor (custom connector).
- Wpisz nazwę, np. „Biblioteka skilli”, i adres serwera powyżej. Uwierzytelnianie zostaw puste.
- W rozmowie włącz konektor i napisz, czego potrzebujesz, np. „znajdź skill do przeglądu umów z dostawcą AI”.
Claude Code
claude mcp add --transport http biblioteka-skilli https://sokolinski.com/skille/mcp
Narzędzia serwera
| Narzędzie | Co robi |
|---|---|
| szukaj_skilli | Szuka po opisie zadania, po polsku albo po angielsku, z filtrami: obszar, typ, licencja, bez skryptów, polska półka, minimalny wynik. |
| pokaz_skill | Pełna karta: opisy, autor, licencja, ocena z rozbiciem, skrypty, pliki i treść SKILL.md. |
| pobierz_skill | Pliki paczki z treścią, adres .zip, SHA-256 i ścieżka instalacji. Do wywołania po zgodzie użytkownika. |
| sprawdz_aktualizacje | Porównuje wersje zainstalowanych skilli z bazą. |
Opisy po polsku i kategorie
Polskie opisy, obszary pracy i typy zadań napisał model językowy (Claude) na podstawie oryginalnych opisów autorów. Oryginał jest na stronie każdego skilla. Jeśli opis po polsku rozmija się z oryginałem, wiążący jest oryginał.
Zgłoszenia i usuwanie
Jeśli skill zawiera szkodliwą treść, działa inaczej niż opis albo narusza licencję, wyślij zgłoszenie przez formularz uwag albo na bartosz@sokolinski.com i podaj adres strony skilla.
Autor skilla, który nie chce go w bibliotece, może poprosić o usunięcie przez formularz albo z tego samego adresu. Skill znika przy najbliższej aktualizacji bazy, a przy szkodliwej treści od razu.
Ranking i statystyki
Strona liczy anonimowo, ile razy skill obejrzano i pobrano (paczka .zip, SKILL.md, instalacja przez MCP). Ten sam adres liczy się raz na skill i dzień, roboty indeksujące nie są liczone, a w bazie liczników nie ma adresów IP. Ranking staje się publiczny po 100 pobraniach w ciągu 30 dni. Szczegóły w polityce prywatności.