Przejdź do treści

Claude Skills: czym są umiejętności, jak działają i jak napisać własną

Adam Marzec
Okładka artykułu o Claude Skills: trzy karty ułożone schodkowo reprezentujące poziomy ładowania umiejętności, od krótkiej etykiety przez instrukcje po dodatkowe pliki, w tle wiersz terminala z komendą instalacji pluginu

Dokładnie rok temu, 16 października 2025, Anthropic pokazał Skills, czyli mechanizm dokładania agentowi nowych umiejętności w postaci zwykłych folderów z plikami. Rok później to już otwarty standard z własną specyfikacją, a repozytorium anthropics/skills zebrało na GitHubie ponad 181 tysięcy gwiazdek. Skills działają w aplikacji Claude, w Claude Code i w API, więc nie dziwi, że Polacy wpisują w Google „claude skills co to” albo „claude skills github”. Ten tekst odpowiada na te pytania: format SKILL.md, trzy poziomy ładowania, włączanie na każdej platformie i przepis na pierwszą własną umiejętność.

Szerszą perspektywę na ten ekosystem, od planów po porównania modeli, masz w linkowanym wyżej hubie. Tu zostajemy przy jednym: jak działa katalog z plikiem SKILL.md, że agent sam wie, kiedy po niego sięgnąć. Od razu uczciwie: opisuję to na podstawie dokumentacji i pomocy Anthropic z odczytem z 16 października 2026, bez testów na własnym koncie. Tam, gdzie źródła milczą, piszę „nie podano”.

Najważniejsze informacje

PytanieKrótko
Czym są skills?Katalog z plikiem SKILL.md: instrukcje, skrypty i zasoby ładowane, gdy zadanie tego wymaga. Od 18 grudnia 2025 otwarty standard.
Jak działa ładowanie?Nazwa i opis zawsze w kontekście (ok. 100 tokenów), treść po wywołaniu (poniżej 5 tys.), pliki dopiero przy potrzebie.
Gdzie działają?Aplikacja Claude (Customize > Skills), Claude Code (katalogi na dysku), API (parametr container, endpoint /v1/skills), Agent SDK.
Gotowe umiejętnościRepo anthropics/skills: ponad 181 tysięcy gwiazdek i 19 katalogów skilli (odczyt 16.10.2026), w tym docx, pdf, pptx i xlsx.
Własna umiejętnośćŁatwa na start: katalog i SKILL.md z dwoma polami frontmatteru. Skrypty dochodzą później.
Plany i kosztyFree, Pro i Max wg pomocy z 16.10.2026, Team domyślnie, Enterprise przez politykę właściciela. W API code execution tool.

Claude Skills co to jest

Skill to katalog, w którym siedzi plik SKILL.md z instrukcjami dla modelu, a obok niego mogą leżeć skrypty, szablony i dokumenty referencyjne. Anthropic porównuje umiejętność do poradnika wdrożeniowego dla nowego pracownika: zamiast budować osobnego, pociętego agenta dla każdego zadania, dokładasz mu folder z wiedzą, jak wykonać konkretną pracę. W dokumentacji API czytamy wprost, że skills to „filesystem-based resources”: wiedza proceduralna zapisana na dysku, nie w wadze modelu.

Mechanizm ogłoszono 16 października 2025, a reakcja była głośna. Wątek „Claude Skills” na Hacker News zebrał 816 punktów i 427 komentarzy, a Simon Willison napisał tego samego dnia, że skills mogą być poważniejszą sprawą niż MCP. Po dwóch miesiącach, 18 grudnia 2025, Anthropic opublikował format jako otwarty standard Agent Skills na agentskills.io, co otworzyło drogę do przenoszenia umiejętności między narzędziami różnych producentów.

Plik SKILL.md zaczyna się od frontmatteru YAML z dwoma polami: name (nazwa) i description (opis tego, co umiejętność robi i kiedy jej użyć). Te dwa pola to jedyny element, który model widzi zawsze. Reszta pliku to zwykły markdown z instrukcjami, czytanym dopiero przy konkretnym zadaniu. Jeśli wiesz już, czym jest agent AI, łatwo uchwycisz sedno: skills nie zmieniają modelu, tylko dokładają mu instrukcje wykonywane w trakcie pracy.

Łatwo pomylić dwie warstwy. Skills w aplikacji Claude to ta sama technologia, którą Claude używa pod spodem, gdy tworzy dla ciebie pliki Excela albo prezentacje: umiejętności dokumentowe działają tam bez żadnej konfiguracji. Skills w Claude Code i w API to mechanizm dla ciebie, sposób, żeby wpajać agentowi własne procedury. Format jest ten sam, różni się tylko to, kto umiejętność napisał.

Jak działają Claude Skills

Cały spryt siedzi w tak zwanym progressive disclosure, czyli doładowywaniu wiedzy etapami. Na poziomie pierwszym, na starcie sesji, do promptu systemowego wchodzi tylko nazwa i opis każdej zainstalowanej umiejętności. Dokumentacja API wycenia to na około 100 tokenów na skill, więc można mieć ich dziesiątki bez widocznego kosztu. Model skanuje te opisy przy każdym zapytaniu i sam decyduje, czy któraś pasuje.

Poziom drugi startuje, gdy opis zadania trafi w opis umiejętności: Claude czyta pełną treść SKILL.md z dysku poleceniem powłoki i dopiero wtedy instrukcje wchodzą do okna kontekstu. Dokumentacja podaje granicę poniżej 5 tysięcy tokenów na tę treść. Poziom trzeci to pliki dołączone do katalogu, na przykład FORMS.md z instrukcjami wypełniania formularzy albo skrypt fill_form.py: ich zawartość kosztuje dokładnie zero tokenów, dopóki model ich naprawdę nie otworzy. Kod skryptu w ogóle nie wchodzi do kontekstu, bo liczy się tylko jego wynik.

Trzeci poziom ma też drugie dno: skrypty. Sortowanie listy przez generowanie tokenów jest droższe i mniej pewne niż uruchomienie programu, więc umiejętności wołają zwykły kod, na przykład skrypt wyciągający pola formularza z PDF-a. Wynik jest wtedy powtarzalny, a agent oszczędza kontekst na samo rozmawianie.

Ładowanie ma jednak pułapkę: treść umiejętności zostaje w kontekście między turami rozmowy, więc każdy wiersz SKILL.md to koszt wracający przy każdej kolejnej wiadomości. Dokumentacja Claude Code radzi pisać zwięźle: co zrobić, bez narracji o tym, dlaczego.

Jak włączyć skills w Claude

W aplikacji Claude na stan z 16 października 2026 pomoc wskazuje sekcję Customize > Skills na claude.ai. Tam włącza się przykładowe umiejętności i wgrywa własne pliki zip. Pomoc wypisuje wprost plany Max, Pro i Free; Team ma funkcję domyślnie włączoną na poziomie organizacji, a w Enterprise właściciel musi najpierw odblokować „Code execution and file creation” oraz „Skills” w Organization settings > Plugins & skills i może wgrać umiejętności dla całej firmy. Komunikat premierowy i dokumentacja deweloperska wymieniają tylko Pro, Max, Team i Enterprise, więc dostęp planu Free to nowość z pomocy. Ile kosztują poszczególne plany, opisuje osobno tekst o cenach Claude.

W Claude Code wszystko siedzi na dysku i żadnych uploadów nie ma. Umiejętność osobista ląduje w ~/.claude/skills/nazwa/SKILL.md i działa we wszystkich twoich projektach na tej maszynie, projektowa w .claude/skills/ w repozytorium, więc trafia do zespołu przez gita. Gotowe zestawy Anthropic instaluje się pluginami:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Od wersji Claude Code 2.1.273 działa też synchronizacja z konta claude.ai: umiejętności włączone w ustawieniach konta ściągają się do ~/.claude/skills/synced/ i odświeżają w trakcie sesji, co ok. 10 minut przy pracy i co ok. 40 minut bezczynności. W menu /skills takie pozycje widnieją w grupie „claude.ai sync”, a umiejętności pdf i xlsx synchronizują się zawsze: dokumenty Excel i PDF robione w przeglądarce i w terminalu korzystają z tej samej biblioteki umiejętności.

Szczegóły konfiguracji w terminalu opisuje osobny tekst o Claude Code, a tu jedna różnica na start. Wbudowane umiejętności dokumentowe (pptx, xlsx, docx, pdf) w Claude Code nie są dostępne; za to do Claude Code dołącza skill claude-api z aktualną dokumentacją API. Jeśli zaś wolisz kolejkę po stronie serwera, w API umiejętności podaje się w parametrze container razem z narzędziem code execution: gotowe włącza się po skill_id (pptx, xlsx, docx, pdf), a własne wgrywa przez endpoint /v1/skills. Więcej o tym środowisku w materiale o Claude API. Kontener jest odseparowany od sieci: żadnych zapytań na zewnątrz i żadnej instalacji pakietów w trakcie działania.

Jedna rzecz może zaskoczyć: umiejętności nie przenoszą się między platformami. To, co wgrasz do claude.ai, nie pojawi się w API, a skills z katalogów Claude Code są osobne od obu.

Claude Skills na GitHubie: repo, katalog, gotowe zestawy

Oficjalne źródło jest jedno: github.com/anthropics/skills, opisane jako „Public repository for Agent Skills”. Repo utworzono 22 września 2025, czyli niecały miesiąc przed premierą, a na odczyt z 16 października 2026 miało ponad 181 tysięcy gwiazdek i ponad 21,5 tysiąca forków. W katalogu skills/ leży 19 umiejętności, od kreatywnych (algorithmic-art, canvas-design, theme-factory), przez techniczne (mcp-builder, webapp-testing, skill-creator), po biurowe (internal-comms, brand-guidelines) i dokumentowe (docx, pdf, pptx, xlsx). Są tam też katalogi spec/ ze specyfikacją standardu i template/ z pustym szablonem.

Z licencjami bywa różnie i repo tego nie ukrywa. Większość przykładów jest na Apache 2.0, ale umiejętności dokumentowe, te, które napędzają tworzenie plików w aplikacji Claude, są „source-available”, nie open source. Na poziomie całego repo pole licencji w ogóle nie jest wypełnione, więc zanim weźmiesz coś do własnego projektu, sprawdź licencję konkretnego katalogu, nie całego repozytorium.

Czy jest więc „claude skills marketplace”? Nazwy takiej Anthropic nie używa. Po update z 18 grudnia 2025 firma prowadzi katalog umiejętności, konektorów i pluginów pod adresem claude.com/connectors, z wyróżnionymi umiejętnościami partnerów: Notion opublikowało własny zestaw. W Claude Code rolę marketplace’u pełni mechanizm pluginów, w którym rejestruje się repozytorium komendą /plugin marketplace add. Frazy „claude skills library” i „claude skills repo” z autouzupełniania prowadzą więc do tych samych dwóch miejsc: repozytorium z przykładami i katalogu w aplikacji.

Jak napisać własną umiejętność

Najprostsza działająca umiejętność to dwa kroki: katalog i jeden plik. W Claude Code wystarczy:

mkdir -p ~/.claude/skills/podsumowanie-zmian
nano ~/.claude/skills/podsumowanie-zmian/SKILL.md

Plik zaczyna się od frontmatteru, a reszta to instrukcje:

---
name: podsumowanie-zmian
description: Podsumowuje niezacommitowane zmiany w repozytorium git i oznacza ryzykowne fragmenty. Użyj, gdy rozmowa dotyczy bieżącej pracy w repo.
---

# Podsumowanie zmian

1. Uruchom git diff i git status.
2. Zbierz zmiany w krótkie podsumowanie po polsku.
3. Oznacz ryzykowne fragmenty: sekrety, migracje, usunięte testy.

Reguły pól są twarde. Name mieści się w 64 znakach i składa się z małych liter, cyfr i łączników; słowa „anthropic” i „claude” są zarezerwowane. Description ma maksymalnie 1024 znaki (w API) i to on decyduje o wszystkim: model porównuje z nim każde zapytanie, więc musi mówić i co umiejętność robi, i kiedy jej użyć. W Claude Code dochodzi pole when_to_use z frazami wyzwalającymi; całość opisu jest ucinana na 1536 znakach w liście umiejętności.

Opis to miejsce, gdzie umiejętności wygrywają i przegrywają. Jeśli Claude nie włącza się sam, dokumentacja każe poprawiać właśnie description, nie treść. Testowanie wygląda więc tak: kilka różnych promptów, które powinny umiejętność odpalić, zajrzenie w tok myślenia, czy model ją załadował, iteracja opisu. Claude Code pilnuje katalogów skilli na żywo, więc zmiana w SKILL.md działa bez restartu sesji, a komenda /skills pokazuje, co jest załadowane. Zanim cokolwiek wgrasz do aplikacji Claude, spakuj katalog do zipa z folderem w korzeniu archiwum (my-skill.zip zawierający my-skill/SKILL.md), bo pliki wrzucone luzem struktury nie przejdą.

Nie musisz pisać od ręki. Umiejętność skill-creator z oficjalnego repo prowadzi przez generowanie struktury w rozmowie, a nowość z pomocy Anthropic pozwala umiejętność nagrać: wysyłasz wideo z ekranu (do około 10 minut), Claude uruchamia zadanie Cowork, ogląda nagranie i proponuje plik do przejrzenia. Wideo i audio nie są przechowywane, zostaje zestaw zrzutów w zadaniu. Na poważniejszy warsztat: gdy SKILL.md puchnie, rozdziela się treść na dodatkowe pliki, na przykład REFERENCE.md, a powtarzalne operacje zamienia w skrypty.

Czy Claude Skills są bezpieczne

Tu nie ma miejsca na przymykanie oka. Umiejętność to instrukcje, które agent wykona w środowisku z dostępem do plików i powłoki, więc złośliwy skill może kierować Claude’a do wycieku danych albo działań niezgodnych z opisem. Dokumentacja Anthropic pisze to czarno na białym i zaleca traktowanie instalacji umiejętności jak instalacji oprogramowania: tylko zaufane źródła, a przy mniej pewnych pełny audyt plików, ze szczególną uwagą na zależności, obrazy, skrypty i polecenia łączące się z zewnętrznymi adresami.

Skala ryzyka zależy od środowiska. W API kontener jest odcięty od sieci, więc umiejętność nie wyśle niczego na zewnątrz. W Claude Code skills mają pełny dostęp sieciowy, jak każdy program na twoim komputerze. Aplikacja Claude zależy od ustawień: pomoc o tworzeniu plików opisuje pełny, ograniczony albo zerowy dostęp do sieci, zależnie od konfiguracji użytkownika i organizacji. Duże organizacje dostają jeszcze Skill content scanning dla umiejętności wgrywanych w claude.ai i Cowork, z przepływem akceptacji przed publikacją.

Moja praktyczna reguła po lekturze dokumentacji: umiejętności własne albo z oficjalnego repo traktuję jak własny kod, a wszystko z cudzych zestawów czytam w całości przed pierwszym uruchomieniem. To jedyny moment, gdy ktoś faktycznie przeczyta te instrukcje przed wykonaniem.

Claude Skills a MCP: jaka jest różnica

To dwa różne narzędzia, które się uzupełniają, a nie konkurują. Skill to wiedza proceduralna w plikach markdown z ewentualnymi skryptami: uczy agenta, jak wykonać pracę, i działa wprost na plikach, bez żadnego serwera. MCP to protokół podłączania zewnętrznych narzędzi i danych: serwery MCP dają agentowi dostęp do rzeczy spoza jego środowiska, od bazy danych po aplikacje firmowe. Jeśli to rozróżnienie jest dla ciebie nowe, na technetblogu jest osobny tekst o MCP.

Sam Anthropic stawia je w jednej linii: blog inżynierski zapowiadał badanie, jak skills mogą uzupełniać serwery MCP, ucząc agenta bardziej złożonych przepływów pracy wokół narzędzi zewnętrznych. W praktyce: MCP podłącza narzędzie, a skill uczy, co z nim robić krok po kroku. Dlatego w oficjalnym repo leży mcp-builder, umiejętność pomagająca budować serwery protokołu.

Najczęstsze pytania

Claude Skills co to jest?

Katalogi z plikiem SKILL.md, które dokłają Claude’owi wiedzę proceduralną: instrukcje, skrypty i zasoby ładowane na żądanie. Format od grudnia 2025 jest otwartym standardem Agent Skills, a ładowanie jest trzystopniowe: od dwupola w froncie po pełną treść i pliki. Nie potrzebujesz nic instalować: w aplikacji Claude umiejętności dokumentowe działają same przy tworzeniu plików.

Claude Skills GitHub: gdzie jest oficjalne repozytorium?

Pod adresem github.com/anthropics/skills. Repo zostało utworzone 22 września 2025, a na 16 października 2026 miało ponad 181 tysięcy gwiazdek i 19 katalogów z umiejętnościami. Znajdziesz tam też specyfikację i szablon (katalogi spec/ i template/).

Czy istnieje marketplace Claude Skills?

Oficjalnie Anthropic prowadzi katalog skills, konektorów i pluginów pod adresem claude.com/connectors (od 18 grudnia 2025), a w Claude Code umiejętności instaluje się przez mechanizm pluginów z repozytoriów zarejestrowanych komendą /plugin marketplace add. Nazwy „marketplace” firma unika, choć społeczność jej używa.

Gdzie jest biblioteka Claude Skills?

To samo miejsce co w pytaniu wyżej: repo anthropics/skills z 19 przykładami i katalog w aplikacji, do którego docierasz przez Customize > Skills. W Team i Enterprise dochodzi trzecia biblioteka: organizacyjna, zasilana umiejętnościami opublikowanymi przez administratorów, z opcjonalnym przeglądem przed publikacją. Liczb pobrań ani liczby umiejętności społecznościowych Anthropic nie publikuje.

Co to jest Claude Skills LLM Council?

Nie jest to funkcja Claude. „LLM council” to osobny, otwarty projekt Andreja Karpathy’ego (repo llm-council z listopada 2025), w którym kilka modeli odpowiada na pytanie i ocenia nawzajem swoje odpowiedzi. Frazy łączące to pojęcie ze skills biorą się z szumu wyszukiwań, bo obie rzeczy dotyczą agentów, a Anthropic nie ogłaszał umiejętności o tej nazwie.

Czy wszystkie Claude Skills pochodzą od Anthropic?

Nie. Od Anthropica masz umiejętności wbudowane w aplikację (dokumentowe pptx, xlsx, docx, pdf), przykłady z repo i skille dołączone do Claude Code (między innymi claude-api). Reszta ekosystemu to umiejętności własne i partnerskie, jak zestaw Notion, oraz społecznościowe kolekcje, za których jakość odpowiadają autorzy. W Enterprise administratorzy filtrują to między innymi skanowaniem zawartości umiejętności.

Źródła

Powiązane artykuły