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
  1. Krok po kroku, jak napisać skill
  2. Jak przetestować skill w Claude Code
  3. Zasady Anthropic, które robią największą różnicę
  4. Skill-creator, skill do pisania skilli

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.

  1. Utwórzcie folder skilla poleceniem mkdir -p ~/.claude/skills/notatka-ze-spotkania w terminalu.
  2. Zapiszcie w nim plik SKILL.md z treścią poniżej.
  3. Obok zapiszcie plik szablon.md ze wzorem.
  4. Uruchomcie claude w dowolnym folderze i przetestujcie skill tak, jak opisujemy niżej.
SKILL.md
---
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ą.
szablon.md
# Spotkanie z KLIENT, DATA

Obecni
Ustalenia
Zadania, osoba, termin
Otwarte pytania

Nazwa 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-official

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

Kiedy najlepiej zadzwonić?
Administrator: Oleksandr Bondarenko (BondSoft)Polityka prywatnościRegulamin
Szczegóły prawne

Administratorem danych jest Oleksandr Bondarenko, prowadzący działalność gospodarczą pod firmą Oleksandr Bondarenko Software Solutions (BondSoft), ul. Jana Heweliusza 11, 80-890 Gdańsk, NIP 5833576264, e-mail: office@bondsoft.pl.

Dane przetwarzamy wyłącznie w celu kontaktu w sprawie Twojego zapytania i przedstawienia oferty — na podstawie Twojej zgody (art. 6 ust. 1 lit. a RODO oraz art. 398 ustawy Prawo komunikacji elektronicznej) oraz naszego prawnie uzasadnionego interesu polegającego na obsłudze zapytania (art. 6 ust. 1 lit. f RODO).

Podanie danych jest dobrowolne, ale niezbędne do kontaktu zwrotnego. Zgodę możesz wycofać w każdej chwili, pisząc na office@bondsoft.pl — nie wpływa to na zgodność z prawem przetwarzania sprzed wycofania.

Masz prawo dostępu do danych, ich sprostowania, usunięcia, ograniczenia przetwarzania, przenoszenia oraz wniesienia skargi do Prezesa Urzędu Ochrony Danych Osobowych.

Pełna informacja: Polityka prywatności.

Napiszcie e-mail

Usługa, o której jest ten tekst

Automatyzacja i AI / OCR

Automatyzacja przepisywania dokumentów, OCR i reguły sprawdzania, a dane zostają u Was.