Claude Skills wyjaśnione: trzy poziomy progresywnego ujawniania

Claude Skill to fizycznie folder. Nie usługa hostowana, nie plik binarny, nie blok tekstu wklejany na początku rozmowy — katalog zawierający plik SKILL.md i cokolwiek jeszcze jest potrzebne do zadania. Niemal wszystko, co interesujące w Skills, wynika z tej jednej decyzji, ponieważ folder to coś, co agent może otwierać selektywnie. Promptu nie można otworzyć selektywnie. Albo znajduje się w rozmowie, albo nie.

Dokumentacja Anthropic opisuje to rozwiązanie jako zorganizowane niczym przewodnik wdrożeniowy, który stworzyłbyś dla nowego członka zespołu, a ta analogia sięga dalej, niż początkowo się wydaje. Nikt nie czyta przewodnika wdrożeniowego od deski do deski przed rozpoczęciem pracy. Ludzie czytają stronę odpowiadającą pytaniu, które mają przed sobą, i ufają, że reszta będzie na miejscu, gdy jej potrzebują. Umiejętność opiera się na tym samym założeniu: że większość procedury może przez większość czasu pozostawać na dysku.

Najpierw system plików, możliwości w drugiej kolejności

Claude działa w maszynie wirtualnej z dostępem do systemu plików. To warunek wstępny tego, by umiejętność była katalogiem, a nie wpisem konfiguracyjnym, ponieważ pozwala agentowi wylistować folder, odczytać plik i podążyć za odwołaniem do innego pliku za pomocą tych samych operacji, których użyłby człowiek. W tym kontekście umiejętność pakuje instrukcje, metadane i opcjonalne zasoby, takie jak skrypty i szablony.

Rezultatem jest zdolność większa niż jakikolwiek pojedynczy plik w folderze. Instrukcje mówią, jak wykonać zadanie. Dołączony skrypt może wykonać jego część bez opisywania go prozą. Dokument referencyjny może zawierać materiał, do którego się zagląda, zamiast go zapamiętywać. Tym, co czyni te trzy rzeczy systemem, a nie stosem, jest kolejność, w jakiej stają się widoczne — to część, którą Anthropic nazywa progressive disclosure — ładowanie informacji etapami w miarę potrzeby, zamiast zużywania kontekstu z góry.

Poziom 1: dwa pola, które są zawsze ładowane

Każda umiejętność rozpoczyna się od frontmattera YAML zawierającego nazwę i opis. Claude wczytuje te metadane przy uruchomieniu i dołącza je do promptu systemowego. To jedyna część umiejętności obecna, zanim ktokolwiek o cokolwiek poprosi, a dopóki umiejętność nie zostanie wywołana, kontekst zajmują wyłącznie jej nazwa i opis.

Opis pełni trzy funkcje jednocześnie, a rozdzielenie ich wyjaśnia, dlaczego tak wiele umiejętności jest po cichu ignorowanych. Jest etykietą, mówiącą, jak dana rzecz się nazywa. Jest wpisem indeksowym — tekstem, z którym porównywane jest żądanie, gdy Claude decyduje, czy dana umiejętność jest istotna. Jest też określeniem zakresu, dlatego zgodnie z wytycznymi Anthropic musi mówić zarówno, co dana umiejętność robi, jak i kiedy jej używać. Opis, który radzi sobie tylko z pierwszą z tych funkcji, nie daje mechanizmowi dopasowującemu niczego do dopasowania.

Weź dwie wersje tej samej umiejętności. Jedna jest opisana jako wypełnianie i walidowanie formularzy PDF, do użycia, gdy żądanie dotyczy wypełnienia lub sprawdzenia formularza PDF. Druga jest opisana jako pomoc z dokumentami. Pierwsza nazywa działanie i sytuację; druga nie nazywa ani jednego, ani drugiej. Umiejętność, której opis nie nazywa ani działania, ani sytuacji, będzie leżeć nieprzeczytana na dysku, podczas gdy agent wykona zadanie okrężną drogą — nie dlatego, że umiejętność zawiodła, lecz dlatego, że nigdy nie została znaleziona.

Poziom 2: treść, czytana gdy opis pasuje

Gdy żądanie odpowiada opisowi, otwiera się drugi poziom: treść SKILL.md. To procedura — przepływy pracy, najlepsze praktyki, wskazówki — napisana dla agenta, który już zdecydował, że ta umiejętność jest właściwym narzędziem do zadania. To tutaj zespół zapisuje kroki, które w przeciwnym razie powtarzałby w każdej rozmowie, i tutaj znajdują się odsyłacze do bardziej szczegółowych materiałów.

Kolejność ma tu znaczenie tak samo jak na poziomie 1. Treść nie jest wczytywana przy starcie ani na wszelki wypadek. Pojawia się po podjęciu decyzji, co oznacza, że decyzję musi dać się podjąć na podstawie samego poziomu 1. Umiejętność z niejasnym opisem nie ma jak nadrobić tego na poziomie 2, ponieważ poziom 2 nigdy nie jest czytany.

Poziom 3: pliki, które otwierają się, ponieważ coś na nie wskazało

Trzeci poziom to reszta folderu: dodatkowe pliki, do których odwołuje się SKILL.md. Przykładem Anthropic jest FORMS.md zawierający zaawansowane wskazówki dotyczące wypełniania formularzy, trzymany poza głównymi instrukcjami, aby te instrukcje pozostały krótkie, a szczegóły były dostępne tylko wtedy, gdy zadanie tego wymaga. Skrypty i szablony również należą do tego poziomu.

Efekt strukturalny polega na tym, że umiejętność może zawierać bardzo dużo materiału, nie wczytując go całego naraz. Folder może przechowywać główny plik z instrukcjami, szczegółowe źródło referencyjne, zestaw szablonów i skrypt, a dane zadanie może sięgać tylko do jednego z nich. Wszystko, na co nic nie wskazuje, pozostaje na dysku, a dysk nie jest w agencie zasobem deficytowym. Kontekst jest.

To także tutaj format podnosi pułap, na który napotykają prompty. Prompt musi być wystarczająco krótki, by warto było go wklejać. Materiały dołączone do skilla są ograniczone pojemnością katalogu, ponieważ do modelu trafia tylko ta część, której zadanie faktycznie dotyczyło.

Dlaczego kolejność to projekt, a nie detal

Wynikają z tego trzy konsekwencje i razem są one powodem, dla którego warto to zrozumieć, a nie tylko znać.

• Kontekst to budżet, a treść ładowana zawsze to stały koszt. Wszystko w prompcie systemowym jest opłacane przy każdym żądaniu, w tym przy żądaniach, które nie mają nic wspólnego z tą umiejętnością. Stopniowe ujawnianie zamienia stały koszt w warunkowy: opis zawsze, instrukcje, gdy są istotne, odwołania, gdy są przywoływane.

• Opis jest interfejsem. To jedyna część umiejętności, która z pewnością zostanie zobaczona, więc właśnie tutaj autor musi pomyśleć o wyzwalaniu, a nie tylko o treści.

• Umiejętność ma trzy tempa utrzymania. Metadane zmieniają się, gdy umiejętność powinna uruchamiać się inaczej, treść zmienia się, gdy zmienia się przepływ pracy, a odwołania zmieniają się, gdy zmienia się materiał źródłowy. Utrzymywanie ich osobno zapobiega temu, by aktualizacja odwołania zamieniła się w przepisanie instrukcji.

Koszt jest lustrzanym odbiciem korzyści. Każda granica poziomu to miejsce, w którym model musi podjąć właściwą decyzję. Zbyt wąski opis oznacza, że umiejętność nigdy nie zadziała, a folder staje się martwym balastem. Zbyt szeroki oznacza, że zadziała przy pracy, do której nie została stworzona, a jej instrukcje stają się obciążeniem dla niepowiązanych zadań. Stopniowe ujawnianie sprawia, że opis staje się nośny w sposób, w jaki długi prompt, zawsze obecny, nigdy nie jest.

Co Anthropic już dostarcza i skąd pochodzą Twoje własne umiejętności

Anthropic udostępnia gotowe Skills dla PowerPoint, Excel, Word i PDF — prezentacje, arkusze kalkulacyjne, dokumenty i sformatowane pliki PDF. Są dostępne w claude.ai, Claude API, Claude Platform on AWS i Microsoft Foundry, z zastrzeżeniem, że w Foundry wymagają wdrożenia Hosted on Anthropic.

To najszybszy sposób, aby zobaczyć mechanizm, zamiast o nim czytać. Kolejność ładowania jest identyczna jak w przypadku wszystkiego, co napiszesz samodzielnie; różnica między gotową umiejętnością a własną polega na tym, kto utworzył folder, a nie na tym, jak trafia ona do modelu.

Własne umiejętności (Custom Skills) można tworzyć w Claude Code, przesyłać przez Claude API lub dodawać w ustawieniach claude.ai. Anthropic podaje dla nich korzyści, których można oczekiwać od wszystkiego, co można wykorzystać ponownie: specjalizowanie Claude’a w zadaniach dziedzinowych, tworzenie wskazówek raz zamiast powtarzania ich oraz łączenie kilku umiejętności do pracy wieloetapowej. Ostatnia z tych korzyści wynika najbardziej bezpośrednio z architektury, ponieważ jeśli każda umiejętność to folder otwierany na żądanie, zestaw umiejętności kosztuje bardzo niewiele, dopóki praca faktycznie ich nie potrzebuje.

Umiejętność to nie prompt ani konektor.

W rozmowie trzy rzeczy bywają ze sobą mylone, a kolejność wczytywania sprawia, że łatwo utrzymać te rozróżnienia.

Prompt funkcjonuje na poziomie rozmowy. Jest obecny od pierwszego zwrotu, zabarwia wszystko w tej rozmowie i znika wraz z rozmową. Umiejętność działa na żądanie: istnieje przed rozpoczęciem rozmowy, większość z niej nigdy nie trafia do rozmowy, a część, która trafia, robi to, ponieważ opis został dopasowany. To różnica między mówieniem agentowi, jak ma się zachowywać, a dawaniem mu czegoś, co może pobrać.

Konektor to kwestia zasięgu. Konektory to dostęp do aplikacji, co oznacza, że określają, czego agent może dotknąć; umiejętność (skill) określa, jak agent powinien coś zrobić, gdy już może tego dotknąć. Zespół może mieć doskonałe konektory i nadal tworzyć niespójne dokumenty, ponieważ dostęp to nie procedura. Może też mieć doskonałe umiejętności i nadal nie widzieć danych, ponieważ procedura to nie dostęp.

Dokumentacja Anthropic traktuje Skills i Model Context Protocol jako różne warstwy, a mechanizm trójpoziomowy pokazuje, dlaczego ten podział jest czysty. Kolejność ładowania dotyczy tego, kiedy informacje docierają, a nie skąd pochodzą.

Gdzie wpisuje się darowizna – w jednym akapicie

22 października 2026 r. Anthropic przekazała standard Agent Skills fundacji Agentic AI Foundation działającej w ramach Linux Foundation — nazwę, logo, organizację GitHub oraz domenę agentskills.io — a inżynierowie z Anthropic, Google, OpenAI i innych firm utrzymują go jako osoby prywatne. Nic z tego nie zmienia opisanego powyżej mechanizmu. Format folderów, frontmatter YAML, kolejność ładowania i gotowe umiejętności dokumentowe są dokładnie takie same jak dzień wcześniej. Zmieniło się tylko to, kto jest właścicielem nazwy — co ma ogromne znaczenie dla długoterminowej stabilności standardu, a nie ma żadnego znaczenia dla tego, jak napiszesz umiejętność dzisiaj po południu.

Przeczytanie umiejętności przed jej instalacją

Jeśli trzy poziomy są architekturą, tworzą też krótką listę kontrolną do przeglądu. Najpierw przeczytaj opis, ponieważ to on decyduje, czy cokolwiek innego kiedykolwiek się wydarzy: powinien nazywać to, co robi umiejętność, i kiedy należy jej używać, słowami, których prośba prawdopodobnie by użyła. Drugi przeczytaj SKILL.md, ponieważ to jest procedura, której będzie przestrzegać agent, i powinna czytać się jak instrukcje dla kompetentnego kolegi, a nie streszczenie tego, co masz nadzieję, że się stanie. Po trzecie przeczytaj to, do czego się odwołuje. Następnie przeczytaj skrypty.

Ostatni punkt nie jest paranoją. Format pozwala umiejętności przenosić instrukcje wraz z opcjonalnymi zasobami, a zasoby mogą obejmować kod wykonywalny. Instalowana umiejętność nie jest więc tylko tekstem, który kształtuje rozmowę; to folder, z którego zdolny agent będzie otwierał pliki i na ich podstawie działał. Model poziom po poziomie mówi dokładnie, gdzie szukać, co oferuje więcej niż większość instalowanych rzeczy.

Warto wskazać jedną granicę czytelnikom, którzy trafiają tu z naszych własnych stron. OrcaRouter kieruje wywołania modeli, a my nie hostujemy żadnych aplikacji Anthropic ani jej powierzchni skilli — skill działa tam, gdzie znajduje się system plików agenta, a to nie jest nasza warstwa. To, co robimy, leży poniżej wyboru modelu: ponad 200 modeli pod jednym kluczem zgodnym z OpenAI, cena katalogowa dostawcy przekazywana bez marży i automatyczne przełączanie awaryjne między dostawcami, gdy jeden jest niedostępny. Skill decyduje, jak zadanie powinno zostać wykonane. Router decyduje, który model to robi, i żadna z tych warstw nie powinna potrzebować wiele wiedzieć o drugiej.

Progressive disclosure uczciwie podchodzi do ograniczenia, które rozwiązuje. Kontekst jest skończony, procedury są długie, a większość dowolnej procedury jest nieistotna dla zadania, które masz przed sobą. Nazwa, treść i zestaw plików to nie skomplikowany projekt; to najmniejszy z możliwych, który pozwala agentowi przenosić ogrom wiedzy, trzymając tylko tę część, której potrzebuje.

Dlatego właśnie najistotniejsza linijka w dobrze zbudowanej umiejętności jest zarazem najkrótsza. Wszystko inne w folderze to biblioteka. Opis to katalog kartkowy, a gdy katalog jest błędny, biblioteka równie dobrze może nie istnieć.