Jak napisać własną komendę slash w Claude Code (skill)

Claude Code

Jak napisać własną komendę slash w Claude Code (skill)

W skrócie

Jeśli w Claude Code, oficjalnym narzędziu CLI od Anthropic, wpisujesz raz po raz ten sam długi prompt, warto zamienić go we własną komendę slash. To kilka minut pracy, a oszczędza mnóstwo powtarzania. W nowszych wersjach komendy slash i skille to w praktyce jedno i to samo - pokazujemy najprostszą drogę oraz to, co dają rozbudowane skille.

Jak to wygląda w praktyce

Masz prompt, który sprawdza się za każdym razem: może to instrukcja pisania commita w stylu Twojego zespołu, może szablon przeglądu kodu, może rutynowy deploy. Za każdym razem wklejasz go ręcznie, czasem z drobnymi literówkami, i tracisz czas. Chciałbyś wywołać go jednym słowem, na przykład /commit albo /deploy, i ewentualnie przekazać mu argument, jak numer zgłoszenia.

Dlaczego Claude Code tak działa

Claude Code czyta komendy użytkownika z plików na dysku. Najważniejsza zmiana w nowszych wersjach: komendy zostały scalone ze skillami. Plik .claude/commands/deploy.md oraz skill .claude/skills/deploy/SKILL.md tworzą tę samą komendę /deploy i działają tak samo. Twoje istniejące pliki w .claude/commands/ dalej działają bez zmian.

Różnica jest taka, że skille dają więcej: własny katalog na pliki pomocnicze, nagłówek YAML sterujący tym, czy komendę wywołujesz Ty, czy może ją uruchomić sam Claude, oraz możliwość automatycznego wczytania skilla, gdy pasuje do sytuacji. W treści komendy możesz użyć placeholdera $ARGUMENTS, który podstawia to, co wpiszesz po nazwie - na przykład /fix-issue 123 wstawi 123 w miejsce placeholdera.

Jak to rozwiązać krok po kroku

1. Wybierz zasięg. Komenda widoczna tylko w jednym projekcie idzie do .claude/commands/ w repozytorium; komenda dostępna wszędzie - do ~/.claude/commands/.
2. Utwórz plik Markdown o nazwie komendy, na przykład .claude/commands/commit.md. Sama nazwa pliku (bez rozszerzenia) staje się nazwą komendy, czyli /commit.
3. Wpisz do pliku treść promptu, którą chcesz uruchamiać. To zwykły tekst po polsku, na przykład instrukcja, jak sformatować wiadomość commita zgodnie z konwencją zespołu.
4. Jeśli komenda ma przyjmować argument, wstaw w treści placeholder $ARGUMENTS. Przy wywołaniu /fix-issue 123 Claude Code podstawi 123 w to miejsce.
5. Aby skorzystać z możliwości skilli, utwórz zamiast tego katalog .claude/skills/nazwa/ z plikiem SKILL.md. W nagłówku YAML tego pliku możesz dodać pola takie jak description, allowed-tools czy disable-model-invocation (to ostatnie sprawia, że komendę uruchamiasz tylko Ty, a nie sam Claude).
6. Dorzuć pliki pomocnicze, jeśli są potrzebne. Skill może mieć własny katalog ze skryptami czy szablonami, do których odwołuje się jego instrukcja - komenda w .claude/commands/ tego nie oferuje.
7. Sprawdź dostępność. Wpisz / w sesji - Twoja nowa komenda powinna pojawić się na liście podpowiedzi obok komend wbudowanych.

Jak sprawdzić, że zadziałało

W sesji wpisz / i zacznij pisać nazwę swojej komendy - powinna pokazać się na liście. Uruchom ją i sprawdź, że Claude Code wykonuje dokładnie ten prompt, który zapisałeś w pliku. Jeśli użyłeś $ARGUMENTS, wywołaj komendę z argumentem (na przykład /fix-issue 123) i potwierdź, że wartość trafiła we właściwe miejsce. Dla skilla z disable-model-invocation sprawdź, że Claude nie uruchamia go sam, tylko na Twoje wyraźne wywołanie.

Wróć do listy: 100 najczęstszych problemów z Claude Code

Szkolenie Claude Code - od zera do zespołu agentów AI -->

Szkolenie Claude Code - od zera do zespołu agentów AI

Tryb planowania, tryby uprawnień, komendy, MCP, hooki i systemy multi-agent - wszystko na żywym kodzie podczas trzydniowego szkolenia. Prowadzi Łukasz Matuszewski. Szkolenie ma terminy gwarantowane - odbędzie się niezależnie od liczby zgłoszeń.

Sprawdź szkolenie Claude Code

To szkolenie może być dofinansowane dla Ciebie z KFS lub BUR.

★★★★★Średnia ocena naszych szkoleń w Google: 5/5