Skills
Jak działa
Umiejętność to katalog z plikiem SKILL.md, który zaczyna się od frontmatteru YAML z wymaganymi polami name i description. Progresywne ujawnianie działa na trzech poziomach: (1) przy starcie metadane (name + description) każdej umiejętności są wczytywane do system promptu, by agent wiedział, kiedy jej użyć; (2) gdy agent uzna umiejętność za istotną, czyta pełną treść SKILL.md do kontekstu; (3) w razie potrzeby agent nawiguje do dodatkowych plików dołączonych do katalogu (np. reference.md, forms.md) i czyta je dopiero wtedy, gdy są potrzebne. Umiejętność może też dołączać skrypty, które agent uruchamia jako narzędzia przez wykonywanie kodu — bez ładowania samego skryptu ani danych do kontekstu. Wymaga środowiska agenta z systemem plików i narzędziem do wykonywania kodu.
Rozwiązany problem
Agenci ogólnego przeznaczenia nie mają wbudowanej wiedzy proceduralnej specyficznej dla domeny, a wpisywanie jej na stałe w prompt lub system prompt jest kosztowne, nie skaluje się, nie jest wielokrotnego użytku ani przenośne między zadaniami i platformami. Agent Skills kapsułkują tę wiedzę w jeden, ładowany na żądanie zasób.
Komponenty
Wymagany plik w katalogu umiejętności; składa się z frontmatteru YAML oraz treści w Markdown.
Wymagane metadane wczytywane do system promptu przy starcie; sterują wykrywaniem i wyzwalaniem umiejętności.
Główna treść z instrukcjami, ładowana do kontekstu dopiero gdy umiejętność zostanie uznana za istotną.
Opcjonalne pliki referencyjne, szablony i dane dołączone do katalogu, czytane przez agenta wyłącznie na żądanie.
Oficjalna
Opcjonalny kod (np. Python) uruchamiany przez agenta jako narzędzie, dający deterministyczne wyniki bez ładowania skryptu do kontekstu.
Oficjalna
Implementacja
Jeśli pole description jest zbyt ogólne lub nie opisuje, kiedy użyć umiejętności, agent jej nie wyzwoli.
Zbyt szeroki opis sprawia, że agent ładuje umiejętność także w nieistotnych sytuacjach, marnując kontekst.
Umiejętności ze skryptami i progresywnym ujawnianiem zakładają środowisko z systemem plików i narzędziem wykonywania kodu; bez nich nie zadziałają w pełni.
Ewolucja
16 października 2025 Anthropic wprowadza Agent Skills w Claude, Claude Code, API i Agent SDK, wraz z gotowymi umiejętnościami do dokumentów (PDF, Word, Excel, PowerPoint).
18 grudnia 2025 Anthropic publikuje Agent Skills jako otwarty standard dla przenośności międzyplatformowej.
Hiperparametry (konfigurowalne osie)
Opis w frontmatterze decyduje, kiedy agent wyzwala umiejętność; słaby opis prowadzi do braku lub nadmiaru wyzwoleń.
Identyfikator umiejętności; część metadanych poziomu 1 i podstawa inwokacji (np. /nazwa).
Liczba i struktura dołączonych plików wyznacza, ile kontekstu agent czyta dopiero na żądanie.
Opcjonalne zawężenie narzędzi/uprawnień, z których umiejętność może korzystać.
Paradygmat wykonania
To paradygmat inżynierii kontekstu, nie trybu obliczeń modelu: umiejętności są ujawniane warunkowo, zależnie od zadania.
Agent porównuje metadane (name + description) każdej umiejętności w system prompcie z bieżącym zadaniem i warunkowo ładuje tylko istotne umiejętności.
Wymagania sprzętowe
Agent Skills to wzorzec inżynierii kontekstu / orkiestracji niezależny od akceleratora; wymaga jedynie środowiska agenta z systemem plików i wykonywaniem kodu.