Jak zainstalować skille Claude: Code, Desktop, Web (2026)

Instalacja skilla Claude w Claude Code to trzy komendy:

git clone https://github.com/anthropics/skills
cp -r skills/document-skills/docx ~/.claude/skills/
# restart Claude Code — skills are scanned at startup

To cała instalacja. Folder ląduje w ~/.claude/skills/, Claude czyta znajdujący się w nim SKILL.md przy następnym uruchomieniu i od tej pory skill aktywuje się automatycznie, gdy pojawi się pasujące zadanie.

Gdyby zawsze było tak łatwo, ten artykuł kończyłby się w tym miejscu. Nie kończy się, bo instalacja to akurat ta niezawodna część. Zawodzi wszystko dookoła: złe zagnieżdżenie katalogów, zapomniane restarty, a przede wszystkim skille, które instalują się bez zarzutu i nigdy się nie odpalają. Spośród skilli, które przetestowaliśmy do katalogu SkillProof, mniej więcej 45% miało jakiś problem z triggerowaniem prosto po instalacji. Każdy skill instalujemy i uruchamiamy, zanim trafi do katalogu, więc ten przewodnik powstał na bazie logów z testów, a nie z czytania README.

Jeśli jeszcze nie wiesz, czym w ogóle jest skill (w odróżnieniu od serwera MCP czy system promptu), przeczytaj najpierw Czym są skille Claude i wróć tutaj. Ten przewodnik zakłada, że masz już wybrany skill i chcesz, żeby działał.

Czego potrzebujesz przed instalacją

Lista jest krótka.

Do Claude Code potrzebujesz zainstalowanego Claude Code 2.x i git w PATH. To wszystko. Skille to zwykłe foldery z markdownem w środku; nie ma menedżera pakietów, kroku budowania ani rozwiązywania zależności. Jedyny wyjątek to skille wywołujące zewnętrzne narzędzia. Webapp Testing wymaga lokalnie zainstalowanego Playwrighta i właśnie dlatego w naszych testach dostał 4/5 za łatwość instalacji zamiast 5/5. O takich wymaganiach powie ci strona skilla; sam skill często nie — dopóki nie wywali się w połowie zadania.

Do Claude Desktop i claude.ai potrzebujesz płatnego planu (Pro, Max, Team lub Enterprise) i włączonego wykonywania kodu w ustawieniach, bo skille działają tam w sandboksie code execution. Potrzebujesz też skilla jako pliku zip, a nie folderu. Więcej o tym niżej.

Jedna rzecz, której nie potrzebujesz: zaufania do README. Autorzy opisują to, co skill miał robić w zamyśle. Zanim zainstalujesz cokolwiek z nieznanego repo, otwórz jego SKILL.md i przejrzyj go. To jest cały skill. Jeśli instrukcje wyglądają na cienkie, a opis we frontmatterze to jedno mgliste zdanie, właśnie zobaczyłeś zapowiedź swoich problemów z triggerowaniem.

Instalacja skilli w Claude Code

Każdy skill to folder z plikiem SKILL.md, opcjonalnie z plikami referencyjnymi i skryptami obok. Instalacja polega na umieszczeniu tego folderu w jednym z dwóch miejsc.

Globalnie czy per projekt: folder skilli Claude Code

Folder globalny to ~/.claude/skills/. Skille stąd są dostępne w każdym projekcie na twojej maszynie. To właściwy dom dla skilli ogólnego przeznaczenia: generowanie dokumentów, dyscyplina debugowania, pomocnicy do pisania. Naszym zdaniem 80% tego, co instalujesz, należy właśnie tutaj, bo większość skilli koduje umiejętność, a nie konwencję projektu.

Folder projektowy to .claude/skills/ wewnątrz repozytorium. Skille stąd aktywują się tylko w tym projekcie. Używaj go do konwencji zespołowych, konfiguracji specyficznej dla projektu albo czegokolwiek, co członkowie zespołu mają dostawać automatycznie, bo skille projektowe podróżują razem z repo. Ktoś je klonuje — ma skille. Bez doca onboardingowego.

Gdy ta sama nazwa skilla istnieje w obu miejscach, wygrywa kopia projektowa. To feature (projekt może nadpisać twoje globalne ustawienia domyślne) i czasami bug, na którym stracisz dwadzieścia minut — omawiamy go w sekcji o rozwiązywaniu problemów.

Ścieżki na macOS, Windows i Linuksie

macOS i Linux używają tej samej ścieżki: ~/.claude/skills/ globalnie, <project>/.claude/skills/ w zakresie projektu. Na macOS rozwija się to do /Users/<you>/.claude/skills/; na Linuksie do /home/<you>/.claude/skills/.

Na Windows folder globalny to %USERPROFILE%\.claude\skills\, czyli zwykle C:\Users\<you>\.claude\skills\. W PowerShellu ~ rozwiązuje się tak samo, więc ~\.claude\skills\ też zadziała. Zwróć uwagę, że folder na każdej platformie zaczyna się od kropki. Eksplorator Windows domyślnie go ukrywa, Finder na macOS też (Cmd+Shift+. pokazuje ukryte pliki) — dlatego polecamy robić instalacje z terminala, nawet jeśli na co dzień żyjesz w GUI.

Docelowa struktura musi wyglądać dokładnie tak:

~/.claude/skills/
  docx/
    SKILL.md
  frontend-design/
    SKILL.md

Folder skilla, a bezpośrednio w nim SKILL.md. Nie skills/docx/docx/SKILL.md. To podwójne zagnieżdżenie to najczęstszy błąd instalacyjny, jaki widujemy, a Claude nie zgłasza przy nim żadnego błędu: skill po prostu nie istnieje z jego perspektywy.

Jak zainstalować skill Claude z GitHuba

Większość skilli mieszka na GitHubie, zwykle po kilka w jednym repo. Schemat jest taki: klonujesz repo gdzieś tymczasowo, kopiujesz jeden folder, który cię interesuje, do swojego katalogu skilli, a klon możesz skasować.

Prawdziwy przykład na oficjalnym repo Anthropic — instalujemy DOCX, skill do dokumentów Worda, który w naszych testach dostał 9/10 za jakość outputu:

git clone https://github.com/anthropics/skills
cp -r skills/document-skills/docx ~/.claude/skills/

Zrestartuj Claude Code. Gotowe. W tym samym repo jest Frontend Design, najwyżej oceniony skill w naszej kategorii design (10/10 za output; różnica przed/po przy pracy nad UI to największa, jaką zmierzyliśmy):

cp -r skills/frontend-design ~/.claude/skills/

Zauważ, że ścieżki się różnią: document-skills/docx jest zagnieżdżony o poziom głębiej niż frontend-design. Repozytoria organizują skille tak, jak autor akurat miał ochotę danego dnia. Zawsze sprawdź, gdzie faktycznie leży SKILL.md, i skopiuj folder, który bezpośrednio go zawiera. Każdy wpis w naszej kategorii dokumentów i w całym katalogu pokazuje gotową, wypełnioną komendę kopiowania, bo sami mieliśmy dość ustalania tych ścieżek ręcznie.

Nie masz gita? Pobierz zip repo z GitHuba (Code → Download ZIP), rozpakuj i przenieś folder skilla na miejsce. Ten sam efekt, więcej klikania.

Marketplace'y pluginów

Część autorów dystrybuuje skille przez system pluginów Claude Code zamiast gołych folderów:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers

To prawdziwa komenda instalacji kolekcji Superpowers, w której mieszka Test-Driven Development — 9/10 za output w naszych testach i 5/5 za niezawodność triggerów. Pluginy ogarniają za ciebie aktualizacje, czego kopiowanie folderów nie robi, a z naszego doświadczenia dystrybucja przez plugin koreluje z dyscypliną utrzymania: autor, który postawił marketplace, to zwykle autor, który wypuszcza poprawki. Gdy skill oferuje obie ścieżki instalacji, bierz plugin.

Instalacja w Claude Desktop i na claude.ai

Claude Desktop i claude.ai nie czytają twojego systemu plików, więc metoda z folderem tu nie działa. Zamiast tego wgrywasz skill jako zip w ustawieniach capabilities.

Kroki, aktualne na połowę 2026:

1. Spakuj folder skilla tak, żeby SKILL.md leżał na najwyższym poziomie w archiwum (zipujesz sam folder, nie jego katalog nadrzędny).
2. W Claude Desktop lub na claude.ai otwórz Settings, potem Capabilities.
3. Włącz code execution, jeśli jeszcze nie jest włączone. Bez tego skille w ogóle nie pojawią się jako opcja.
4. W sekcji Skills wybierz upload i wskaż swój zip.

Skill jest wtedy dostępny w nowych rozmowach. Kuratorowane skille Anthropic (głównie zestaw dokumentowy) można też włączyć bezpośrednio przełącznikiem w tych samych ustawieniach, bez żadnego uploadu — jeśli skill, którego chcesz, tam jest, użyj przełącznika. Jest wersjonowany i utrzymywany za ciebie.

Dwa uczciwe zastrzeżenia z naszych testów. Po pierwsze, skille odpalające lokalne narzędzia z oczywistych względów nie zrobią tego w sandboksie claude.ai; skill, który steruje Playwrightem albo czyta twoją historię gita, to skill dla Claude Code, kropka. Po drugie, instalacje przez upload są per konto, nie per maszyna — co jest wygodne dokładnie do momentu, gdy utrzymujesz różne wersje w Claude Code i na claude.ai i dostajesz różne zachowania od „tego samego" skilla. Jeśli pracujesz w obu, trzymaj Claude Code jako źródło prawdy i pakuj zip na nowo przy każdej aktualizacji.

Jak sprawdzić, czy skill faktycznie się odpala

To krok, który pomija prawie każdy, a to właśnie tu instalacje naprawdę się sypią. Skill może być idealnie umieszczony, idealnie sformatowany i nigdy się nie aktywować, bo aktywacja zależy od tego, czy Claude dopasuje twoją prośbę do pola description we frontmatterze skilla. Jeśli ten opis jest mglisty, skill jest meblem.

Niezawodność triggerów testujemy osobno i to najsłabsze ogniwo ekosystemu: około 45% skilli, które przepuściliśmy przez testy, miało problemy z triggerowaniem — od „odpala się tylko, gdy zacytujesz nazwę skilla" po „nie odpala się nigdy". Właśnie dlatego trigger reliability to osobna 5-punktowa ocena na każdej karcie w SkillProof, a nie coś, co wliczamy w ogólny stopień.

Weryfikacja zajmuje dwie minuty:

1. Zrestartuj Claude Code (albo zacznij świeżą rozmowę na claude.ai).
2. Zapytaj Claude'a wprost: „Jakie skille masz dostępne?". Poprawnie zainstalowany skill pojawi się na liście. Jeśli go nie ma, masz problem ze ścieżką, nie z triggerem; wróć do struktury folderów.
3. Daj mu zadanie, które w oczywisty sposób powinno odpalić skill, sformułowane naturalnie, bez wymieniania nazwy skilla. Dla DOCX: „Stwórz dokument Worda z podsumowaniem tego projektu". Obserwuj, czy Claude zakomunikuje, że używa skilla.
4. Potem sformułuj to samo zadanie tak, jak naprawdę wpisałbyś je we wtorkowe popołudnie. To jest test, który się liczy. Mnóstwo skilli przechodzi krok 3 i oblewa krok 4.

Jeśli skill pojawia się w kroku 2, ale nie odpala w kroku 4, fix to zwykle edycja description w jego frontmatterze tak, żeby zawierał słowa, których naprawdę używasz. Wolno ci to zrobić; to twoja kopia. Nasz darmowy walidator skilli sprawdza SKILL.md pod kątem błędów frontmattera powodujących słabe triggerowanie i oflaguje opis, który jest za krótki albo zbyt ogólny, zanim stracisz sesję na bolesne odkrywanie tego samemu.

Dla skilli z oceną triggerów poniżej 5/5 w naszym katalogu notatki z testów na karcie mówią dokładnie, jakie sformułowanie je odpaliło. To często szybsze niż samodzielna naprawa frontmattera.

Aktualizacja i usuwanie skilli

Dla skilli instalowanych folderem nie ma komendy update. Aktualizacja to podmiana folderu:

cd skills && git pull
cp -r document-skills/docx ~/.claude/skills/

Jeśli po instalacji skasowałeś klon, klonujesz jeszcze raz i kopiujesz jeszcze raz. To autentycznie słaby punkt podejścia folderowego; nic nie powie ci, że jest aktualizacja. Skille instalowane pluginem wypadają lepiej, bo system pluginów zarządza wersjami. To kolejny powód, by wybierać ścieżkę pluginową, gdy jest dostępna.

Praktyczna uwaga, jeśli dostosowałeś frontmatter skilla, żeby naprawić triggerowanie: ślepa kopia nadpisze twoje zmiany. Zrób diff przed podmianą. My trzymamy dostosowane skille w małym własnym repo gita i scalamy zmiany z upstreamu świadomie — brzmi jak przesada dokładnie do pierwszego razu, gdy aktualizacja po cichu cofnie ci fix.

Usuwanie skilla to jedyny element całego tego systemu bez żadnych haczyków:

rm -rf ~/.claude/skills/docx

Restart Claude'a i po sprawie. Skille nie dotykają stanu systemu, niczego nie rejestrują, nie zostawiają po sobie konfiguracji. Na claude.ai usuwasz skill w ustawieniach capabilities. Tyle.

Rozwiązywanie problemów

Cztery tryby awarii pokrywają niemal każde zgłoszenie „zainstalowałem i nic się nie stało", jakie dostaliśmy.

Skill nigdy się nie odpala. Najpierw sprawdź, czy jest na liście, gdy pytasz Claude'a o dostępne skille. Jeśli jest na liście, ale śpi, opis we frontmatterze jest zbyt mglisty, by Claude dopasował do niego twoje prośby — to bug autorski, który dziedziczysz w momencie instalacji. Przepuść SKILL.md przez walidator skilli, a potem przepisz opis z konkretnymi frazami wyzwalającymi: nazwij formaty plików, czasowniki, sytuacje. „Helps with documents" nie odpala się na nic. „Use when the user wants to create, edit or convert .docx Word files" odpala się niezawodnie. Skoro i tak będziesz edytować frontmatter, nasz przewodnik po pisaniu własnego skilla Claude wyjaśnia, co sprawia, że opis działa — a te same zasady obowiązują przy naprawianiu cudzego.

Kolizje nazw. Dwa skille o tej samej nazwie folderu, jeden globalny i jeden projektowy — projektowy wygrywa po cichu. Albo dwa skille pokrywające tę samą domenę (powiedzmy dwa skille do code review) i triggerowanie staje się rzutem monetą. Gdy zachowanie wydaje się niespójne, sprawdź zarówno ~/.claude/skills/, jak i .claude/skills/ bieżącego projektu. Przy nakładaniu się domen zostaw jeden; nie ma tu systemu priorytetów do skonfigurowania, a w naszych testach nakładające się skille psują się nawzajem, nawet gdy każdy z osobna jest dobry.

Potrzebny restart. Skille są skanowane przy starcie, a nie obserwowane na żywo. Każda instalacja, aktualizacja czy usunięcie wymaga restartu Claude Code, żeby zadziałać. Oczywiste, gdy już wiesz; niewidzialne, dopóki nie wiesz. Szacujemy, że jedna trzecia zgłoszeń „zepsutej instalacji", które dostajemy, to właśnie to.

Uprawnienia. Jeśli Claude widzi skill na liście, ale sypie błędami przy jego użyciu, sprawdź, czy pliki są czytelne (chmod -R u+r ~/.claude/skills/<name> na macOS/Linux) i czy dołączone skrypty są wykonywalne. Foldery kopiowane z pobranych zipów albo synchronizowane przez narzędzia typu Dropbox czasem przyjeżdżają z pokiereszowanymi uprawnieniami. Na Windows pliki pobrane z internetu mogą nosić flagę blokady; prawy przycisk, Właściwości, Odblokuj.

I piąty, połowiczny tryb awarii: skille z prawdziwymi wymaganiami wstępnymi. Brand Guidelines instaluje się czysto, ale nie robi nic pożytecznego, dopóki nie uzupełnisz jego konfiguracji o swoją paletę i fonty — dlatego dostał 3/5 za łatwość instalacji, mimo że to dobry skill. Gdy karta na naszej stronie mówi „works with setup", właśnie to znaczy. Przeczytaj notatki z testów, zanim uznasz skill za zepsuty.

Instalacja 10 skilli naraz

Metoda kopiuj-wklej skaluje się liniowo i boleśnie: dziesięć skilli to dziesięć klonów albo dziesięć kopii, dziesięć testów triggerów i realna szansa, że dwa z nich się nakładają. Oficjalnego bulk-installera nie ma.

Nasza odpowiedź to pakiety SkillProof: kuratorowane zestawy przetestowanych skilli instalowane jedną komendą. Każdy pakiet ma zweryfikowaną konfigurację, w której każdy skill przeszedł nasze testy indywidualnie, a zestaw został sprawdzony grupowo pod kątem konfliktów triggerów — bo „dziesięć dobrych skilli" i „dziesięć skilli, które ze sobą współpracują" to dwa różne twierdzenia. Jeśli wolisz złożyć własny stack, darmowa ścieżka to osobiste repo gita z wybranymi folderami skilli i jednolinijkowe cp -r my-skills/* ~/.claude/skills/. Tracisz testy konfliktów, zyskujesz odtwarzalny setup, który postawisz na drugiej maszynie w trzydzieści sekund.

Tak czy inaczej, oprzyj się pokusie instalowania dwudziestu skilli na zapas. Wszystkie opisy skilli są czytane, gdy Claude decyduje, co aktywować, a zatłoczony folder pełen mglistych opisów pogarsza triggerowanie wszystkiego. Zainstaluj to, czego użyjesz w tym miesiącu. Dodawaj kolejne, gdy zadanie tego zażąda.

FAQ

Gdzie instalują się skille Claude? W Claude Code: ~/.claude/skills/ dla skilli globalnych, <project>/.claude/skills/ dla projektowych. Na Windows: %USERPROFILE%\.claude\skills\. Na claude.ai i w Claude Desktop skille wgrywa się jako zipy w Settings → Capabilities i są przypisane do konta, nie zapisane na dysku.

Czy po instalacji skilla trzeba restartować Claude Code? Tak, za każdym razem. Skille są skanowane raz, przy starcie. Instalacje, aktualizacje i usunięcia wchodzą w życie przy następnym uruchomieniu — to najczęstszy powód, dla którego świeża instalacja „nie działa".

Czy mogę zainstalować skille bez gita? Tak. Pobierz repo jako zip z GitHuba, rozpakuj i skopiuj folder skilla do ~/.claude/skills/. Git tylko ułatwia aktualizacje; do niczego nie jest wymagany.

Dlaczego mój zainstalowany skill nigdy się nie aktywuje? Zakładając, że ścieżka jest w porządku, description we frontmatterze jego SKILL.md jest zbyt mglisty, by Claude dopasował do niego twoje prośby. Mniej więcej 45% testowanych przez nas skilli ma ten problem. Zedytuj opis, dodając konkretne frazy wyzwalające, albo sprawdź nasz walidator skilli i notatki z testów skilla na SkillProof w poszukiwaniu znanych obejść.

Czy instalowanie skilli Claude jest bezpieczne? Skill to instrukcje plus opcjonalne skrypty, które Claude może wykonać, więc traktuj go jak każdy kod, który uruchamiasz: przeczytaj SKILL.md przed instalacją, uważaj na nieutrzymywane repozytoria i preferuj skille przetestowane przez kogoś. Każdy skill w naszym katalogu zainstalowaliśmy i uruchomiliśmy przed dodaniem, a werdykt na karcie odzwierciedla to, co faktycznie się wydarzyło.