Bolek › Poradniki › 6 listopada 2026
Jak napisać własny skill do Claude Code (SKILL.md)? Poradnik (2026)
Poradnik · · Maciej Głuszak · wersja .md
W skrócie: Skill to folder z plikiem SKILL.md, w którym opisujesz, kiedy go użyć i jakie wykonać kroki. Claude Code wybiera go po opisie albo uruchamiasz go ręcznie poleceniem z ukośnikiem i nazwą.
Wklej do Claude Code:
Zrób z tego, co przed chwilą robiliśmy, skill do Claude Code. Zapisz go jako plik SKILL.md w folderze .claude/skills/nazwa-skilla w tym projekcie. W opisie napisz, kiedy ma się uruchamiać, a w treści ponumeruj kroki i dopisz, czego unikać.
Aktualizacja: · sprawdzone na: Claude Code 2.1, Windows 11
Jeśli trzeci raz prosisz asystenta o to samo, napisz skill. W Bolku, asystencie AI na Windows, mamy ich kilkadziesiąt: maile, dokumenty, grafiki, nagrania z lektorem. Każdy zaczął jako prośba powtórzona zbyt wiele razy.

Gdzie leży skill
- Dla wszystkich projektów: folder `.claude/skills/nazwa-skilla` w katalogu domowym użytkownika.
- Dla jednego projektu: folder `.claude/skills/nazwa-skilla` w katalogu projektu.
- W środku jest plik SKILL.md. Obok możesz położyć pliki pomocnicze: przykłady, szablony, skrypty.
Jak wygląda plik
Na górze jest nagłówek między dwiema liniami z trzema myślnikami, potem treść:
``` --- name: mail-do-klienta description: Pisze maila do klienta po polsku. Użyj, gdy Użytkownik prosi o mail, odpowiedź na wiadomość lub follow-up. ---
- Zapytaj, do kogo i w jakiej sprawie, jeśli brakuje danych.
- Napisz maila krótszego niż 120 słów, z jednym wezwaniem do działania.
- Pokaż szkic i poczekaj na akceptację. Nigdy nie wysyłaj sam.
```
- description jest najważniejsze: według niego Claude Code decyduje, kiedy skill zastosować. Pisz tam, co skill robi i kiedy go użyć, z potocznymi słowami, których naprawdę używasz.
- name to nazwa w menu; bez niej bierze się nazwę folderu.
- Pole `disable-model-invocation: true` sprawia, że skill uruchomisz tylko Ty, ręcznie.
Jak go wywołać
Wpisz na początku wiadomości ukośnik i nazwę, na przykład `/mail-do-klienta`. Możesz też dopisać argument po spacji. Zwykłe zdanie z pasującym opisem też uruchomi skill.
Skill, CLAUDE.md czy polecenie
- CLAUDE.md to wiedza i zasady, które asystent ma znać zawsze (ładuje się na starcie).
- Skill to procedura wczytywana dopiero wtedy, gdy jest potrzebna – nie zajmuje miejsca w każdej rozmowie.
- Dawne własne polecenia z folderu `commands` działają dalej, a skille dają ten sam efekt z dodatkowymi plikami.
Pułapki
- Zbyt ogólny opis. „Pomaga z tekstami" odpali się zawsze albo nigdy. Wpisz konkretne sytuacje.
- Za długa treść. Trzymaj plik poniżej 500 linii; resztę przenieś do plików obok.
- Kroki bez kryterium końca. Dopisz, po czym poznać, że skill skończył dobrze.
- Sekrety w skillu. Skill bywa kopiowany i udostępniany – nie wpisuj w niego haseł ani kluczy.
Co dalej
Zacznij od jednego skilla na rzecz, którą robisz co tydzień. Po miesiącu zobaczysz, które opisy trzeba doprecyzować.
Te lekcje pochodzą z codziennej pracy z Bolkiem, asystentem AI na Windows. Własny Bolek – wdrożenie u Ciebie albo zostaw kontakt – odezwiemy się w ciągu 1 dnia roboczego.