Skille (Agent Skills)

Definicja

Skill to folder z instrukcją dla agenta AI, jak wykonać konkretne zadanie. Sercem jest plik SKILL.md, który zawiera:

nazwę,
krótki opis, kiedy go użyć,
instrukcję krok po kroku.

W folderze mogą być też skrypty, wzory dokumentów i materiały pomocnicze. Agent na starcie zna tylko nazwy i opisy skilli, a pełną instrukcję wczytuje dopiero wtedy, gdy zadanie do niej pasuje.

Format opracowało Anthropic i udostępniło jako otwarty standard Agent Skills. Obsługuje go wiele narzędzi, między innymi:

Claude i Claude Code,
ChatGPT i Codex,
Gemini CLI,
GitHub Copilot,
Cursor.

Co to w zasadzie jest?

Spisana procedura „jak my to robimy”, którą agent potrafi sam odszukać i zastosować.
Coś jak segregator z instrukcjami stanowiskowymi: agent nie czyta wszystkich naraz, tylko otwiera właściwą.
Skill uczy agenta, jak coś zrobić. MCP daje mu dostęp do narzędzi i danych. Te dwie rzeczy się uzupełniają.
Ten sam skill można zwykle przenieść między narzędziami, bo format jest wspólny.
Skill może zawierać kod, który agent uruchomi. To zwiększa możliwości, ale też ryzyko.

Praktyczne zastosowania (konkretne scenariusze)

Scenariusz 1: Raport w firmowym formacie

Cel: każdy raport z agenta ma ten sam układ i styl.
Wejście: dane do raportu.
Kroki: skill opisuje strukturę, ton, zakazane sformułowania i dołącza wzór dokumentu → agent stosuje go za każdym razem.
Rezultat: spójne raporty bez powtarzania instrukcji w każdym prompcie.
Zabezpieczenie: właściciel skilla aktualizuje go po zmianie standardu.

Scenariusz 2: Procedura obsługi zapisu na szkolenie

Cel: powtarzalna obsługa zgłoszeń.
Wejście: mail z zapisem.
Kroki: skill mówi, co sprawdzić, gdzie dopisać uczestnika i jaki szkic odpowiedzi przygotować.
Rezultat: agent robi to samo co doświadczony pracownik, w tej samej kolejności.
Zabezpieczenie: odpowiedź do klienta zatwierdza człowiek.

Scenariusz 3: Kontrola dostępności dokumentu

Cel: wstępne sprawdzenie dokumentu przed publikacją.
Wejście: plik DOCX lub PDF.
Kroki: skill zawiera listę kontrolną (nagłówki, teksty alternatywne, kontrast, język dokumentu) i skrypt do odczytu struktury.
Rezultat: lista uwag do poprawy.
Zabezpieczenie: wynik traktowany jako wstępny; ocenę zgodności robi człowiek.

Typowe błędy i pułapki

Za ogólny opis skilla: agent nie wie, kiedy go użyć, albo używa go wszędzie.
Jeden ogromny skill „do wszystkiego” zamiast kilku krótkich.
Instalowanie cudzych skilli bez przeczytania instrukcji i skryptów.
Brak właściciela i daty aktualizacji: skill się starzeje razem z procedurą.

Ryzyka i jak je ograniczać

Ryzyko 1: Złośliwy skill

Ryzyko: skill z internetu zawiera ukryte polecenia albo szkodliwy skrypt.
Jak ograniczać: instaluj tylko ze sprawdzonych źródeł, czytaj zawartość, uruchamiaj w środowisku z ograniczonymi uprawnieniami (sandboxing).

Ryzyko 2: Nieaktualna procedura

Ryzyko: agent konsekwentnie stosuje stare zasady.
Jak ograniczać: właściciel, data w pliku, przegląd przy każdej zmianie procesu.

Ryzyko 3: Przecenianie skilla

Ryzyko: zespół uznaje, że skoro jest skill, wynik nie wymaga sprawdzenia.
Jak ograniczać: punkt kontroli człowieka zapisany w samym skillu.

Checklista “zanim użyjesz”

Czy opis jasno mówi, kiedy skill ma być użyty?
Czy instrukcja jest krótka i podzielona na kroki?
Czy wiesz, co robią dołączone skrypty?
Kto jest właścicielem i kiedy była ostatnia aktualizacja?
Gdzie w procedurze jest zatwierdzenie człowieka?

Diagram

flowchart LR
    A[Zadanie]
    B[Agent zna nazwy i opisy skilli]
    C[Wczytuje pasujący SKILL.md]
    D[Wykonuje kroki i skrypty]
    E[Człowiek sprawdza wynik]
    A --> B --> C --> D --> E

Diagram pokazuje, że agent wczytuje pełną instrukcję skilla dopiero wtedy, gdy zadanie do niej pasuje, a wynik nadal sprawdza człowiek.