Napisz i przetestuj pierwszy skill
Ćwiczenie do lekcji Skille agenta: jak dodać własną procedurę do OpenClaw. Teorię masz za sobą — teraz wykonaj to na własnym agencie albo w dowolnym czacie z modelem. Bez tego kroku kurs zostaje wiedzą, która nie zmienia niczego w Twojej pracy.
Co powinieneś już wiedzieć z teorii
- Skill to katalog z plikiem SKILL.md — nagłówek YAML z polami name i description plus zwykły tekst. Nie dodaje agentowi żadnego narzędzia, tylko opisuje procedurę.
- Źródeł skilli jest sześć, a wykrywanie schodzi do sześciu poziomów w głąb. Przy tej samej nazwie wygrywa źródło wyżej na liście, z <workspace>/skills na czele.
- Pole description to jedyna informacja, na której model opiera decyzję o sięgnięciu po skill. Skill Workshop trzyma na nie limit 160 bajtów.
- Lista skilli zamrażana jest na starcie sesji. Odświeżenie w trakcie daje obserwator (skills.load.watch domyślnie true, opóźnienie 250 ms) albo nowa sesja.
Co masz zrobić
Wybierz procedurę, którą wykonujesz co najmniej raz w tygodniu, ma jedno wejście i sprawdzalny wynik. Zapisz ją jako skill w katalogu workspace, sprawdź, czy się ładuje, a potem przetestuj pytaniem sformułowanym tak, jak zadałbyś je normalnie — bez podawania nazwy skilla. Do samego testu wystarczy lokalny model z Ollamy albo LM Studio; klucz płatnego providera nie jest do tego ćwiczenia potrzebny. Jeśli agent po skill nie sięgnie, poprawiaj wyłącznie pole description, aż zadziała.
Opisuję procedurę, którą wykonuję co tydzień: [tu wklej opis własnymi słowami — skąd biorę dane, co z nimi robię, gdzie ląduje wynik, czego nigdy nie robić]. Przerób to na treść pliku SKILL.md: nagłówek YAML z polami name i description, a pod nim sekcje „Kiedy używać”, „Kroki” i „Czego nie robić”. Pole description ma mieć jedną linię i zawierać słowa, których użyłbym, prosząc o to zadanie w rozmowie. Nie wymyślaj narzędzi ani kluczy konfiguracyjnych, których nie podałem.
Gotowe, gdy:
Gdzie to się najczęściej sypie
Zanim uznasz ćwiczenie za zrobione, sprawdź, czy nie wpadłeś w któreś z tych miejsc. Każde widzieliśmy więcej niż raz.
- Skill opisujący pracę narzędziem, którego agent nie ma w polityce. Model przeczyta instrukcję, spróbuje wykonać krok i odbije się od polityki narzędzi — a Ty będziesz szukał błędu w treści pliku.
- Pole description napisane jak hasło marketingowe. Model wybiera skill wyłącznie na podstawie tej jednej linii, więc „pomaga w pracy z dokumentami” gwarantuje, że skill nigdy się nie odpali.
- Poprawianie SKILL.md w trakcie trwającej sesji i ocenianie efektu od razu. Lista skilli jest zamrażana na starcie sesji; bez obserwatora zobaczysz starą wersję i wprowadzisz kolejne, niepotrzebne zmiany.
- Traktowanie agents.entries.*.skills jako dopisku do agents.defaults.skills. Lista przy agencie jest finalna i kasuje domyślne, więc wpisanie tam jednej pozycji odcina agenta od wszystkich pozostałych skilli.
Nie masz jeszcze na czym ćwiczyć?
Agent w chmurze EU startuje w około minutę. Pierwsza subskrypcja pakietu Premium ma 5 dni za darmo, a kurs czytasz dalej niezależnie od tego.
Zobacz plany