Jak napisać skill dla Claude. Działający przykład w dwóch plikach i pierwszy test
Piszemy od zera mały skill, który zamienia notatki ze spotkania w notatkę według szablonu firmy. Pokazujemy plik SKILL.md, plik pomocniczy, test w Claude Code i zasady Anthropic, dzięki którym Claude sięga po skill wtedy, kiedy trzeba.
Część przewodnikaClaude Code. Kompletny przewodnik od instalacji po własne skille i pluginy
W tym tekście
W skrócie
Skill dla Claude piszecie jako folder z plikiem SKILL.md, w którym nagłówek mówi, kiedy go użyć, a reszta mówi, co zrobić. Pokazujemy działający przykład w dwóch plikach, test w Claude Code i zasady z dokumentacji Anthropic. Najwięcej zależy od jednego zdania w polu description.
Po każdym spotkaniu z klientem ktoś przepisuje chaotyczne notatki do tego samego układu. Kto był, co ustaliliśmy, kto co robi i do kiedy. To idealny pierwszy skill. Zadanie powtarza się co tydzień, ma stały wzór i łatwo sprawdzić, czy wynik jest dobry. Poniżej piszemy go od zera i pokazujemy, jak napisać skill dla Claude tak, żeby Claude naprawdę po niego sięgał.
Korzystamy z dokumentacji skilli Claude Code i z zasad pisania skilli od Anthropic, stan na 10 listopada 2026. Jeśli nie wiecie jeszcze, czym jest skill, zacznijcie od tekstu skill w Claude, co to jest. Cały cykl zbiera przewodnik po Claude Code.
Krok po kroku, jak napisać skill
Skill będzie miał dwa pliki. SKILL.md z instrukcją i szablon.md ze wzorem notatki. Robimy go w Claude Code jako skill osobisty, czyli działający we wszystkich Waszych projektach.
- Utwórzcie folder skilla poleceniem
mkdir -p ~/.claude/skills/notatka-ze-spotkaniaw terminalu. - Zapiszcie w nim plik
SKILL.mdz treścią poniżej. - Obok zapiszcie plik
szablon.mdze wzorem. - Uruchomcie
claudew dowolnym folderze i przetestujcie skill tak, jak opisujemy niżej.
---
name: notatka-ze-spotkania
description: Zamienia surowe notatki ze spotkania w notatkę według szablonu firmy. Używaj, gdy ktoś wkleja notatki ze spotkania, prosi o podsumowanie rozmowy z klientem albo o listę ustaleń i zadań.
---
Zrób notatkę ze spotkania według pliku szablon.md.
Zasady
- Pisz tylko to, co jest w notatkach. Nie dopisuj ustaleń ani terminów.
- Każde zadanie ma osobę i termin. Jeśli terminu brak, wpisz brak terminu.
- Kwoty i daty przepisuj dokładnie tak, jak są w notatkach.
- Na końcu wypisz pytania, których notatki nie rozstrzygają.# Spotkanie z KLIENT, DATA
Obecni
Ustalenia
Zadania, osoba, termin
Otwarte pytaniaNazwa w polu name może mieć tylko małe litery, cyfry i myślniki, najwyżej 64 znaki, i nie może zawierać słów anthropic ani claude. W Claude Code pole name jest nawet opcjonalne, bo nazwą staje się wtedy nazwa folderu. Ustawiamy je, bo ten sam skill może później trafić do aplikacji Claude.
Plik szablon.md nie zajmuje miejsca w rozmowie, dopóki skill go nie potrzebuje. Claude sięga po niego, bo SKILL.md wprost go wymienia. Tak działa każdy plik pomocniczy, także skrypt, z którego do rozmowy trafia tylko wynik.
Jak przetestować skill w Claude Code
Najpierw sprawdźcie, czy Claude w ogóle widzi skill. Wpiszcie /skills albo zapytajcie wprost, jakie skille są dostępne. Potem przetestujcie go na dwa sposoby. Raz wklejcie notatki i napiszcie zwykłym językiem, że chcecie z nich notatkę. Claude powinien sam sięgnąć po skill, bo prośba pasuje do opisu. Drugi raz wpiszcie /notatka-ze-spotkania i wklejcie notatki.
Claude Code obserwuje folder skilli, więc po poprawce w SKILL.md nie trzeba restartu. Do testów lepiej jednak za każdym razem otworzyć nową sesję. Dokumentacja zwraca uwagę, że kontekst z pisania skilla potrafi ukryć luki w samej instrukcji.
Jeśli skill się nie uruchamia, problem prawie zawsze siedzi w polu description. Zabrakło w nim słów, którymi naprawdę prosicie o to zadanie. Gdy nagłówek ma błąd składni, skill dalej działa przez ukośnik, ale Claude nie widzi opisu i sam po niego nie sięgnie. Polecenie claude plugin validate ~/.claude/skills w zwykłym terminalu sprawdza nagłówki wszystkich skilli osobistych, od wersji 2.1.233.
Zasady Anthropic, które robią największą różnicę
Opis piszcie w trzeciej osobie i konkretnie. Ma mówić, co skill robi i kiedy go użyć, ze słowami, których używacie na co dzień. Jako zły przykład Anthropic podaje opis w rodzaju pomaga z dokumentami.
Piszcie krótko. Anthropic zakłada, że Claude jest już bardzo zdolny, więc w skillu ma być tylko to, czego Claude nie wie. Wasz wzór, Wasze zasady, Wasze wyjątki. Treść SKILL.md warto zmieścić w mniej niż 500 liniach, a dłuższe materiały przenieść do osobnych plików, do których prowadzi bezpośredni odnośnik z SKILL.md, bez łańcucha plik do pliku.
Najważniejsze zasady dajcie na górę. Gdy rozmowa jest streszczana, żeby zwolnić miejsce, Claude Code zostawia z każdego użytego skilla tylko pierwsze 5000 tokenów. Ścieżki zapisujcie z ukośnikiem w prawo, także na Windows.
Skill, który coś zmienia na zewnątrz, na przykład wysyła wiadomość albo publikuje stronę, lepiej uruchamiać tylko ręcznie. Służy do tego linijka disable-model-invocation: true w nagłówku. Wtedy Claude nie odpali go sam, nawet gdy uzna, że pasuje.
Jeśli ten sam skill ma działać w aplikacji Claude, pamiętajcie o limicie, który podaje Centrum pomocy. Opis może tam mieć najwyżej 200 znaków.
Skill-creator, skill do pisania skilli
Anthropic udostępnia skill-creator, który pomaga pisać i poprawiać skille. W Claude Code instaluje się go jako plugin z oficjalnego marketplace.
/plugin install skill-creator@claude-plugins-officialPo instalacji wystarczy poprosić Claude o ocenę istniejącego skilla. Skill-creator zapisuje przypadki testowe w pliku evals/evals.json, uruchamia każdy w czystym kontekście ze skillem i bez niego, porównuje wyniki i proponuje lepszy opis, jeśli skill odpala się przy złych prośbach. Jak działają pluginy, opisujemy w tekście plugin w Claude Code, a gotowe skille do podejrzenia są w tekście o oficjalnych skillach.
Zacznijcie od jednego zadania, które już dziś robicie według wzoru, i dopiszcie do skilla tylko to, co Claude robi źle bez niego. Jeśli chcecie sprawdzić, które takie zadania w Waszej firmie warto oddać AI, zapraszamy na darmowy audyt AI, w którym patrzymy, gdzie AI może zdjąć z firmy część pracy.
Dokumentacja do tematu
Co chcecie zmienić w swojej firmie?
Zostawcie numer. Porozmawiamy o Waszym procesie i sprawdzimy, czy możemy pomóc. Pierwsza rozmowa jest bezpłatna.
Usługa, o której jest ten tekst
Automatyzacja i AI / OCRAutomatyzacja przepisywania dokumentów, OCR i reguły sprawdzania, a dane zostają u Was.