Jak stworzyć własne Claude Skills – przewodnik krok po kroku

Ile razy dzisiaj skopiowałeś ten sam długi prompt do ChatGPT? Ile razy przepisywałeś instrukcje "przeanalizuj ten kod pod kątem bezpieczeństwa" albo "wygeneruj testy jednostkowe"?

Claude Skills rozwiązuje ten problem. Zamiast za każdym razem pisać wieloakapitowy prompt, zapisujesz go raz jako "umiejętność" i uruchamiasz jednym kliknięciem. Makra w Excelu, tyle że dla AI.

Poniżej znajdziesz konkretny przewodnik – od instalacji po tworzenie własnych umiejętności. Bez teorii, same wykonalne kroki.

Zanim zaczniesz – co będzie Ci potrzebne

Żeby korzystać z Claude Skills, musisz mieć:

• Konto Anthropic – darmowe lub płatne (Skills działają na obu planach)
• Claude Code zainstalowany – to dedykowany edytor kodu od Anthropic, dostępny na Windows, Mac i Linux
• Podstawowa znajomość edytora kodu – nie musisz być programistą, ale powinieneś wiedzieć, jak otwierać pliki i foldery

Jeśli używasz VS Code lub innego edytora – na razie Claude Skills działają tylko w Claude Code. Anthropic zapowiedział rozszerzenia dla innych środowisk, ale to dopiero w planach.

Krok 1: Instalacja i pierwsze uruchomienie Claude Code

Pobierasz Claude Code ze strony claude.ai/code. Instalator waży około 150 MB i działa standardowo – klikasz "Next" kilka razy i gotowe.

Po pierwszym uruchomieniu:

1. Logujesz się kontem Anthropic (tym samym, którego używasz do Claude w przeglądarce)
2. Claude Code synchronizuje Twoje ustawienia – jeśli masz zapisane konwersacje w Claude, zobaczysz je w panelu bocznym
3. W lewym dolnym rogu zobaczysz ikonę "Skills" – to Twój panel zarządzania umiejętnościami

Pierwsza synchronizacja zajmuje 10-20 sekund. Jeśli widzisz panel Skills – jesteś gotowy.

Krok 2: Przetestuj gotowe Skills

Anthropic przygotował kilka przykładowych umiejętności, żebyś zobaczył, jak to działa. Klikasz ikonę Skills i widzisz listę:

• Code Review – analizuje kod pod kątem błędów, bezpieczeństwa i best practices
• Generate Tests – tworzy testy jednostkowe dla wybranego fragmentu kodu
• Explain Code – wyjaśnia, co robi dany kawałek kodu (przydatne przy pracy z legacy code)
• Refactor – proponuje ulepszenia w strukturze kodu

Przetestuj jeden z nich, żeby zobaczyć mechanikę:

1. Otwierasz dowolny plik z kodem (JavaScript, Python, cokolwiek)
2. Zaznaczasz fragment kodu
3. Klikasz prawym przyciskiem myszy → "Run Skill" → wybierasz "Code Review"
4. Claude analizuje kod i wyświetla wyniki w panelu bocznym – konkretne sugestie, nie ogólniki

Cała operacja zajmuje 3-5 sekund. Żadnego kopiowania, wklejania, formatowania – po prostu zaznaczasz i klikasz.

Krok 3: Stwórz swoją pierwszą własną umiejętność

Gotowe Skills są OK, ale prawdziwa moc to tworzenie własnych – dopasowanych do Twojego workflow. Powiedzmy, że często piszesz dokumentację API. Zamiast za każdym razem tłumaczyć Claude'owi, jak ma to zrobić, stworzysz Skill "API Documentation".

Otwierasz kreator Skills

W panelu Skills klikasz przycisk "+" (prawy górny róg) → "Create New Skill". Pojawia się formularz z czterema polami:

• Name – nazwa umiejętności (np. "API Documentation")
• Description – krótki opis, co robi (dla Ciebie, nie dla AI)
• Prompt Template – tu wpisujesz instrukcje dla Claude'a
• Input Type – co Skill przyjmuje na wejściu (zaznaczony kod, cały plik, folder)

Piszesz szablon promptu

W polu "Prompt Template" wpisujesz dokładnie to, co normalnie pisałbyś do Claude'a – tyle że raz, a nie za każdym razem. Przykład dla dokumentacji API:

"Przeanalizuj poniższy kod i wygeneruj dokumentację API w formacie Markdown. Uwzględnij: nazwy endpointów, metody HTTP, parametry (typy i opisy), przykładowe requesty i responses, kody błędów. Styl: zwięzły, techniczny, bez zbędnych wstępów."

Możesz używać zmiennych – np. {{SELECTED_CODE}} (zaznaczony fragment) lub {{FILE_PATH}} (ścieżka do pliku). Claude automatycznie podstawi wartości przy uruchomieniu.

Wybierasz typ wejścia

W "Input Type" masz trzy opcje:

• Selection – Skill działa na zaznaczonym fragmencie kodu
• File – analizuje cały otwarty plik
• Folder – przetwarza wszystkie pliki w folderze (uwaga: może zużyć sporo tokenów)

Dla dokumentacji API wybierasz "File" – zwykle dokumentujesz cały plik z endpointami, nie pojedyncze funkcje.

Zapisujesz i testujesz

Klikasz "Save". Twój nowy Skill pojawia się na liście. Teraz test:

1. Otwierasz plik z kodem API (np. routes.js w Node.js)
2. Klikasz prawym przyciskiem → "Run Skill" → "API Documentation"
3. Claude generuje dokumentację w panelu bocznym
4. Kopiujesz wynik do pliku README.md lub docs/api.md

Jeśli wynik nie jest taki, jak chcesz – edytujesz Skill (ikonka ołówka obok nazwy), poprawiasz prompt i testujesz ponownie. Iteracja zajmuje 30 sekund.

Krok 4: Zaawansowane techniki – warunki i kontekst

Kiedy opanujesz podstawy, możesz dodać do Skills więcej inteligencji. Dwa przydatne triki:

Kontekst z wielu plików

Jeśli Twój Skill potrzebuje informacji z kilku plików (np. testy jednostkowe powinny znać strukturę głównego kodu), używasz zmiennej {{WORKSPACE_CONTEXT}}. Claude automatycznie dołącza relevantne pliki z projektu.

Przykład promptu dla testów:

"Wygeneruj testy jednostkowe dla funkcji w {{SELECTED_CODE}}. Uwzględnij edge cases i błędy. Framework: Jest. Kontekst projektu: {{WORKSPACE_CONTEXT}}"

Claude przeanalizuje strukturę projektu i dostosuje testy do Twojego stacku – np. zobaczy, że używasz TypeScript i wygeneruje typowane mocki.

Warunki w promptach

Możesz dodać logikę "jeśli-to-tamto" w promptach. Przykład – Skill do code review, który zmienia styl w zależności od języka:

"Przeanalizuj kod pod kątem: {{#if language == 'Python'}}PEP 8, type hints, docstrings{{else}}ESLint rules, JSDoc, error handling{{/if}}. Wypisz tylko konkretne problemy, bez pochwał."

Claude rozpoznaje język pliku i dostosowuje kryteria. Składnia {{#if}} działa jak w Handlebars – jeśli znasz ten template engine, poczujesz się jak w domu.

Krok 5: Organizacja i współdzielenie Skills

Kiedy stworzysz 10-15 Skills, lista robi się nieczytelna. Claude Code pozwala je organizować:

Foldery i kategorie

W panelu Skills klikasz "Organize" → tworzysz foldery (np. "Code Quality", "Documentation", "Refactoring"). Przeciągasz Skills do odpowiednich kategorii. Proste jak w systemie plików.

Skróty klawiszowe

Najczęściej używane Skills możesz przypisać do skrótów. Klikasz prawym na Skill → "Assign Shortcut" → wciskasz kombinację (np. Ctrl+Shift+R dla code review). Teraz uruchamiasz go bez otwierania menu.

Eksport i import

Skills zapisują się jako pliki JSON w folderze ~/.claude-code/skills/. Możesz je:

• Skopiować na inny komputer (synchronizacja przez Git, Dropbox, cokolwiek)
• Udostępnić zespołowi (wrzucasz plik JSON na Slack, kolega importuje)
• Backupować (bo to tylko tekstowe pliki – łatwo wersjonować)

Import: "Skills" → "Import" → wybierasz plik JSON → gotowe.

Praktyczne przykłady Skills dla różnych zadań

Poniżej kilka gotowych szablonów, które możesz skopiować i dostosować:

Skill: Tłumaczenie komentarzy na polski

Prompt: "Przetłumacz wszystkie komentarze w kodzie na polski. Zachowaj oryginalną strukturę kodu, zmień tylko tekst w komentarzach. Styl: techniczny, zwięzły."

Input Type: File

Przydatne, gdy pracujesz z kodem od zagranicznych zespołów, a chcesz rozumieć komentarze bez przełączania się do tłumacza.

Skill: Security Audit

Prompt: "Znajdź potencjalne luki bezpieczeństwa w kodzie: SQL injection, XSS, CSRF, hardcoded secrets, niezwalidowane inputy. Wypisz tylko zagrożenia z konkretną lokalizacją (linia kodu) i sugestią poprawki."

Input Type: Selection lub File

Nie zastąpi profesjonalnego audytu, ale wyłapie oczywiste błędy przed code review.

Skill: Generowanie commit message

Prompt: "Na podstawie zmian w kodzie wygeneruj commit message w formacie Conventional Commits (type: description). Typ: feat/fix/refactor/docs. Opis: co i dlaczego zmieniono, max 50 znaków."

Input Type: Selection

Zaznaczasz zmieniony fragment, uruchamiasz Skill – dostajesz gotowy commit message. Oszczędza myślenia o formatowaniu.

Skill: Optymalizacja wydajności

Prompt: "Przeanalizuj kod pod kątem wydajności. Znajdź: pętle O(n²), zbędne alokacje pamięci, nieefektywne zapytania do bazy, brakujące indeksy. Zaproponuj konkretne poprawki z uzasadnieniem."

Input Type: File

Szczególnie przydatne w Pythonie i JavaScript, gdzie łatwo napisać wolny kod, który dopiero pod obciążeniem pokazuje problemy.

Ograniczenia i pułapki – co musisz wiedzieć

Claude Skills to nie magia. Kilka rzeczy, które mogą Cię zaskoczyć:

Zużycie tokenów

Każde uruchomienie Skill zużywa tokeny – tak jak normalna konwersacja z Claude. Jeśli uruchomisz Skill na folderze z 50 plikami, możesz spalić dzienny limit (szczególnie na darmowym planie). Rozwiązanie: używaj typu "Selection" lub "File" zamiast "Folder" tam, gdzie to możliwe.

Brak dostępu offline

Skills wymagają połączenia z API Anthropic. Bez internetu – nie działają. To nie są lokalne skrypty, tylko zapytania do modelu Claude w chmurze.

Nie wszystkie języki są równe

Claude (model Sonnet 4.5, który obsługuje Skills) najlepiej radzi sobie z: Python, JavaScript, TypeScript, Java, C++, Rust. Jeśli piszesz w egzotycznym języku (np. Fortran, COBOL) – wyniki mogą być słabsze. Anthropic trenował model głównie na popularnych stackach.

Prywatność kodu

Kod, który wysyłasz do Skills, trafia na serwery Anthropic. Jeśli pracujesz z wrażliwymi danymi (np. kod klienta objęty NDA), sprawdź politykę prywatności Anthropic lub używaj Skills tylko na projektach open source. Anthropic deklaruje, że nie trenuje modeli na danych użytkowników płatnych planów – Ty musisz ocenić ryzyko.

Integracja z resztą workflow – co dalej?

Claude Skills to kawałek większego ekosystemu. Jeśli chcesz pójść dalej:

• Claude API – możesz uruchamiać Skills programatycznie (np. w CI/CD pipeline). Anthropic udostępnił endpoint /skills/run w wersji beta API
• Integracja z Git – niektórzy użytkownicy tworzą pre-commit hooki, które uruchamiają Skill "Security Audit" przed każdym commitem
• Rozszerzenia dla innych edytorów – Anthropic zapowiedział pluginy dla VS Code i JetBrains, ale na razie (marzec 2026) są tylko w closed beta

Jeśli interesuje Cię automatyzacja pracy z AI w szerszym kontekście, sprawdź nasz przewodnik po używaniu ChatGPT do programowania – znajdziesz tam porównanie różnych narzędzi i workflow.

A jeśli dopiero zaczynasz przygodę z AI w kodzie, przeczytaj jak stworzyć własnego asystenta AI w 10 minut – to dobry punkt startowy przed głębszym nurkowaniem w narzędzia takie jak Claude Code.

FAQ – najczęstsze pytania o Claude Skills

Czy Claude Skills działają na darmowym planie?

Tak, ale z limitem tokenów. Na darmowym planie masz około 50 zapytań dziennie (zależnie od długości kodu). Jeśli uruchamiasz Skills na dużych plikach, limit może się szybko wyczerpać. Plan Pro (20$/miesiąc) daje 5x więcej tokenów i priorytetowy dostęp do API.

Czy mogę używać Skills z innymi modelami (np. GPT-4o)?

Nie. Skills są zamknięte w ekosystemie Claude – działają tylko z modelami Anthropic (obecnie Sonnet 4.5 i Opus 4). Jeśli chcesz podobnej funkcjonalności w ChatGPT, musisz użyć Custom GPT – to nieco inny mechanizm, ale cel podobny.

Jak długo trwa wykonanie Skill?

Zależy od rozmiaru kodu i złożoności promptu. Typowo: zaznaczony fragment (50-100 linii) – 3-5 sekund, cały plik (500 linii) – 10-15 sekund, folder z kilkoma plikami – 30-60 sekund. Jeśli Skill działa dłużej niż minutę, prawdopodobnie wysyłasz za dużo kontekstu – spróbuj zawęzić zakres.

Czy Skills mogą modyfikować kod automatycznie?

Nie bezpośrednio. Skill generuje sugestie w panelu bocznym – Ty decydujesz, czy je zaakceptować. Możesz skopiować wynik i wkleić do kodu, ale Claude nie zapisze zmian za Ciebie. To świadomy wybór Anthropic – chcieli uniknąć sytuacji, w której AI nadpisuje kod bez Twojej zgody.

Czy mogę sprzedawać własne Skills?

Anthropic nie zabrania, ale też nie ułatwia – nie ma marketplace'u jak w przypadku Custom GPT w OpenAI. Jeśli stworzysz wartościowy zestaw Skills, możesz go sprzedawać jako plik JSON (np. na Gumroad), ale musisz sam zadbać o dystrybucję i wsparcie. Kilka osób już to robi – np. pakiet "Skills for Django Developers" za 29$.

Podsumowanie – czy warto?

Claude Skills eliminują powtarzalność w pracy z AI. Zamiast przepisywać te same prompty 10 razy dziennie, zapisujesz je raz i uruchamiasz kliknięciem. Oszczędzasz czas i zmniejszasz ryzyko błędów – prompt jest zawsze ten sam, nie zależy od tego, jak dobrze pamiętasz instrukcje.

Największą wartość zobaczysz, jeśli:

• Regularnie prosisz AI o te same typy zadań (code review, dokumentacja, testy)
• Pracujesz w zespole i chcesz standaryzować workflow z AI
• Masz własne "best practices" i chcesz, żeby AI ich przestrzegało bez przypominania

Jeśli używasz AI okazjonalnie (raz na tydzień, różne zadania) – może to być overkill. Jeśli AI jest częścią Twojego codziennego workflow – Skills zwracają się w pierwszy dzień.

Jeden krok na start: Zainstaluj Claude Code, stwórz jeden Skill dla zadania, które robisz najczęściej (np. code review lub tłumaczenie komentarzy) i przetestuj przez tydzień. Jeśli zaoszczędzisz 10 minut dziennie – wiesz, że to działa. Jeśli nie – nic nie straciłeś poza 15 minut na setup.

Źródła

• Analytics Vidhya – Claude Skills Explained
• Claude Code – oficjalna strona
• Anthropic Documentation