skill-authoring

Guide for creating effective SKILL.md files that extend agent capabilities. Use when creating new skills, updating existing ones, or teaching the agent specialized workflows.

1. 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.

2. 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ę.

3. 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.

4. 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.

5. 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.

6. 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.