# Jak napisać własny skill do Claude Code (SKILL.md)? Poradnik (2026)

> Skill to zapisany przepis dla Claude Code: gdzie leży plik SKILL.md, co wpisać w opisie, jak go wywołać i czym różni się od pliku CLAUDE.md.

- Typ: Poradnik
- Data: 2026-11-06
- Aktualizacja: 2026-11-06
- Autor: Maciej Głuszak
- Adres: https://bolekrobot.pl/poradniki/wlasny-skill-claude-code

**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: 2026-11-06 · 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.

![Robot z kartą przepisu i zakładką obok regału z segregatorami](https://bolekrobot.pl/poradniki/media/wlasny-skill-claude-code/ilustracja.jpg)

## 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.
---
1. Zapytaj, do kogo i w jakiej sprawie, jeśli brakuje danych.
2. Napisz maila krótszego niż 120 słów, z jednym wezwaniem do działania.
3. 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ć.

---

Bolek – asystent AI na Windows: https://bolekrobot.pl/
