Skills w Claude Code nie są promptami. I to robi całą różnicę.
Łukasz Ślusarski
5 min czytania
Przez pierwsze dwa tygodnie pracy ze Skills robiłem to źle.
Traktowałem je jak prompty, tylko lepsze. Zamiast pisać „jesteś ekspertem od kodu, pracujesz w agencji, używasz WordPress i Bricks Builder” na początku każdej rozmowy, wrzucałem to do SKILL.md i wywoływałem przez /. Byłem z siebie zadowolony. Byłem też w połowie drogi do zrozumienia czym Skills naprawdę są.
Żeby zobaczyć różnicę, cofnę się o krok.
Czym jest prompt
Prompt to instrukcja którą dajesz Claude’owi na początku rozmowy. „Jesteś ekspertem od SEO. Piszesz po polsku. Ton: profesjonalny.” Claude czyta to i dostosowuje odpowiedzi. Dobry prompt robi różnicę. Kiepski prompt daje kiepskie wyniki.
Problem z promptami jest jeden. Znikają po zamknięciu okna. Następnego dnia zaczynasz od zera. Tłumaczysz Claude’owi jeszcze raz kim jesteś, co robisz, jakie masz preferencje. Firma znowu ma amnezję.
To jest problem skalowalności, nie jakości. Nawet najlepiej napisany prompt nie pomaga jeśli trzeba go wklejać za każdym razem.
Potrzebujesz pomocy z tym tematem?
Pomagam firmom wdrażać nowoczesne rozwiązania. Umów bezpłatną 30-minutową rozmowę.
Umów bezpłatną rozmowę →Czym jest Skill
Skill to nie prompt przechowywany gdzie indziej. To instrukcja operacyjna dla konkretnego procesu, zainstalowana raz i aktywna zawsze.
Różnica jest taka jak między powiedzeniem komuś „pracuj starannie” a wręczeniem mu procedury: kiedy dostajesz brief od klienta, robisz X, potem Y, zatrzymujesz się w miejscu Z i pytasz o potwierdzenie, dopiero potem przechodzisz do W.
Prompt opisuje jak być. Skill opisuje co robić.
Kiedy wywołujesz /code-review, Claude nie staje się „ekspertem od code review”. Claude dostaje precyzyjną listę: sprawdź walidację wejść, obsługę błędów, SQL injection, czytelność nazw zmiennych, zgodność z konwencjami projektu. W tej kolejności. Ze stop condition jeśli znajdzie więcej niż trzy krytyczne problemy. Z outputem w konkretnym formacie który twój pull request template już czeka.
To jest inna kategoria narzędzia.
Dlaczego to zmienia sposób pracy
Mam w ważnych projektach lokalny plik .claude/skills/projekt-klient/SKILL.md. Zawiera konwencje kodu (angielski), konwencje komentarzy (polski), stack (WordPress 6.4, PHP 8.2, Bricks Builder), ważne pliki konfiguracyjne, zasady PR, sposób komunikacji z zespołem po stronie klienta.
Każda osoba która otwiera ten projekt i wywołuje ten Skill ma pełny kontekst. Bez tłumaczenia. Bez pytania mnie o dostępy do 1Password. Bez godziny onboardingu przy nowym projekcie.
To samo dotyczy procesów. Mam Skill do przygotowywania specyfikacji z briefu. Mam Skill do code review pod kątem bezpieczeństwa WordPressa. Mam Skill do planowania architektury przed implementacją. Każdy z nich to praca którą kiedyś robiłem od nowa przy każdym projekcie albo oddelegowywałem z nadzieją że ktoś zapamięta jak to się u nas robi.
Skills to cyfowe SOP. Standard Operating Procedure. Tylko zamiast PDF który leży w folderze na Dysku i nikt nie pamięta że istnieje, Skills są aktywne podczas pracy.
Zrób to z ekspertem
Bezpłatna 30-minutowa konsultacja — bez zobowiązań.
Zarezerwuj termin →
Trzy warstwy które Claude czyta
Jest jeszcze jedna rzecz którą warto rozumieć żeby Skills miały sens jako narzędzie, nie magia.
Claude nie wczytuje wszystkich Skills przy każdej sesji. Działa w trzech warstwach.
Pierwsza to metadata, około 40 tokenów. Nazwa, opis, kiedy używać. Claude skanuje to w tle i decyduje czy Skill jest releventny dla tego co robisz. Możesz mieć zainstalowanych 50 Skills i nie płacisz za nie uwagą modelu dopóki ich nie potrzebujesz.
Druga warstwa to pełny SKILL.md, czytany kiedy Skill jest aktywowany, przez ciebie lub automatycznie. Tu jest właściwa instrukcja operacyjna.
Trzecia warstwa to referencje i skrypty w podkatalogach. Ładowane na żądanie, tylko kiedy instrukcja po nie sięga. Szablony, przykłady, kod Python który pobiera dane z API. Nie zajmują miejsca w kontekście jeśli nie są potrzebne.
To jest architektura progresywnego ujawniania. Skills są bezkosztowe kiedy śpią i precyzyjne kiedy działają.
Co Skills nie są
Nie są narzędziem do przechowywania wiedzy. Jeśli chcesz żeby Claude „wiedział” o twojej firmie, dokumentacja jest lepsza. Skill nie jest bazą wiedzy, jest procedurą działania.
Nie zastępują dobrego promptu w jednorazowych zadaniach. Jeśli coś robisz raz i więcej nie wrócisz, Skill jest przerostem formy. Prompt wystarczy.
Nie są też szkoleniem modelu. Claude nie „uczy się” z twoich Skills. Każda sesja zaczyna się od zera, Skills dają kontekst na początku tej sesji. To różnica ważna jeśli myślisz o prywatności danych.
Kiedy to ma sens
Przez rok pracy w agencji zebrałem listę procesów które robiłem regularnie i za każdym razem od nowa: brief do spec, code review WordPress, deploy checklist, przygotowanie standupu, analiza zaległych tasków z Notion. Każdy z tych procesów trwał dłużej niż powinien bo musiałem albo pamiętać o wszystkich krokach, albo tłumaczyć Claude’owi od początku o co chodzi.
Skills zmieniły to nie dlatego że są magiczne. Zmieniły to dlatego że zmusiły mnie do czegoś co powinienem był zrobić wcześniej: zapisania jak te procesy naprawdę działają, krok po kroku, z decyzjami które trzeba podjąć i stop conditions gdzie muszę zadać pytanie zamiast zgadywać.
Jak piszesz Skill, musisz wiedzieć co robisz. To jest wartość dodatkowa której się nie spodziewałem.
W kolejnym artykule pokażę gdzie szukać Skills które już istnieją i jak odróżnić te dobre od tych które nie warto instalować. Jest ich 200 000 na głównym marketplace. To nie jest powód do radości, to jest problem nawigacyjny.
Artykuł jest częścią serii o Skills w Claude Code. Pierwszą część znajdziesz tutaj: Skills w Claude Code: Twoja firma też ma amnezję.
]]>Zostań w pętli
Nowe artykuły, narzędzia i case study — prosto na maila.
