skill-authoring
Twórz efektywne umiejętności dla agentów AI — przewodnik po standardzie agentskills.io
Instalacja
Wybierz klienta i sklonuj repozytorium do odpowiedniego katalogu skilli.
Instalacja
O skillu
Naucz się pisać SKILL.md — pliki definiujące nowe możliwości dla agentów Claude i podobnych systemów. Przewodnik obejmuje strukturę pliku, zasady zwięzłości, dopasowanie stopnia swobody do zadania oraz organizację katalogów. Użyj go przy tworzeniu nowych umiejętności, aktualizacji istniejących lub nauczaniu agenta specjalistycznych przepływów pracy.
Jak używać
Przygotuj katalog umiejętności o nazwie zgodnej z konwencją (małe litery, myślniki). Umieść w nim plik SKILL.md jako obowiązkowy element — to serce twojej umiejętności.
Zdefiniuj sekcję metadanych YAML na początku SKILL.md: nazwa (1–64 znaki, małe litery i myślniki), opis (1–1024 znaki zawierające co umiejętność robi, kiedy jej użyć i słowa kluczowe), oraz opcjonalnie autora i wersję.
Napisz instrukcje dla agenta w formacie markdown poniżej metadanych. Pamiętaj o zasadzie zwięzłości: każde zdanie musi być niezbędne. Pytaj siebie, czy agent rzeczywiście tego nie wie, zanim dodasz wyjaśnienie.
Dopasuj poziom szczegółowości do stopnia swobody zadania. Dla zadań wymagających precyzji (niski stopień swobody) podaj konkretne skrypty i parametry. Dla zadań otwartych (wysoki stopień swobody) wystarczą wytyczne tekstowe.
Organizuj pliki dodatkowe w podkatalogach: scripts/ na kod wykonywalny (Python, Bash, JavaScript), references/ na dokumentację szczegółową, assets/ na szablony i zasoby statyczne. Trzymaj SKILL.md poniżej 500 linii.
Umieść umiejętność w katalogu skills/ agenta (np. ~/.clawdbot/skills/) i zweryfikuj, że agent może ją załadować i aktywować na podstawie słów kluczowych z opisu.