SKILL.md: czym jest i jak dziala u agentow AI

SKILL.md agenci AI: jesli ta fraza obila Ci sie o uszy, oto najkrotsze wyjasnienie. SKILL.md to krotki plik tekstowy, ktory uczy agenta AI jednego powtarzalnego zadania: kiedy z niego korzystac i jak je wykonac. Mowiac prosto: to spisana instrukcja obslugi, dzieki ktorej agent powtarza ta sama prace tak samo dobrze za kazdym razem. Ten artykul jest dla wlascicieli i menedzerow malych i srednich firm uslugowych, ktorzy chca zrozumiec agentow AI bez nauki programowania. Wyjasniam, co to jest SKILL.md, do czego sluzy w praktyce, czym rozni sie od promptu i integracji MCP, jak wyglada w srodku oraz jak stworzyc wlasny skill w 5 krokach. Na koncu: koszty, ryzyka dla danych i to, od czego zaczac.

TL;DR: SKILL.md to instrukcja obslugi dla agenta AI: jeden krotki plik uczy go jednego zadania. Ma dwie czesci: naglowek YAML (kiedy uzyc skilla) i instrukcje w Markdown (jak wykonac prace). Agent wczytuje pelna tresc tylko wtedy, gdy opis pasuje do polecenia. Wniosek dla firmy: zanim zautomatyzujesz powtarzalne zadanie, musisz umiec je opisac, a skill to wlasnie taki opis.

SKILL.md w 30 sekund

Pomysl o skillu jak o przepisie w firmowej kuchni: skladniki, sprzet i kroki, dzieki ktorym kazdy kucharz powtorzy ten sam efekt. Skill agenta AI dziala tak samo: opis mowi, kiedy skill pasuje do polecenia, a instrukcja prowadzi przez prace krok po kroku.

Skill to folder, a jego sercem jest jeden plik SKILL.md z dwiema czesciami: naglowkiem YAML (nazwa i opis, ktore decyduja o wykryciu) i instrukcja w Markdown (ktora mowi, jak wykonac zadanie). Obok leza opcjonalne zasoby (skrypty, szablony, materialy), doczytywane tylko w razie potrzeby, wiec pelna instrukcja laduje sie dopiero wtedy, gdy skill jest potrzebny.

Format nie jest wynalazkiem jednej firmy. Funkcja skilli zadebiutowala w Claude Code 16 pazdziernika 2025 roku, a 18 grudnia 2025 roku Anthropic udostepnil Agent Skills jako otwarty standard. Ten sam plik czytaja dzis Claude Code, OpenAI Codex, Cursor, Gemini CLI i ponad 40 innych produktow, wiec raz spisany opis zadania nie przywiazuje firmy do jednego dostawcy.

Agent skills: co to jest skill agenta AI

Agent skills to nazwa calego mechanizmu: biblioteki skilli, z ktorych agent korzysta podczas pracy. Kazdy skill uczy go jednej umiejetnosci (odpowiadanie na zapytania, kwalifikacja leadow, podsumowania rozmow), a agent wybiera ten, ktorego opis najlepiej pasuje do polecenia. Gdy zaden nie pasuje, pracuje na ogolnej wiedzy modelu.

Skill a prompt: jaka roznica

Zwykly prompt to jednorazowe polecenie, ktore znika razem z rozmowa. Skill to instrukcja wielokrotnego uzytku: zapisana w pliku, wersjonowana i poprawiana jak firmowy dokument. Prompt mowi, co zrobic raz; skill mowi, jak robic dana rzecz za kazdym razem. Regula: jesli prosisz o to samo trzeci raz, zapisz tresc jako skill.

Skill a MCP i integracje: jaka roznica

Integracje (w swiecie agentow znane jako MCP, czyli Model Context Protocol) daja agentowi rece: dostep do kalendarza, CRM albo bazy zlecen. Skill daje mu procedure: w jakiej kolejnosci uzyc narzedzi i na co uwazac. Narzedzie bez procedury to agent, ktory zgaduje; procedura bez narzedzi to lista bez wykonania.

SKILL.md agenci AI: jak dziala skill w praktyce

Mechanizm ma dwa ruchy: wykrywanie i ladowanie. Najpierw agent porownuje Twoje polecenie z krotkimi opisami wszystkich skilli i wybiera najlepiej pasujacy. Potem wczytuje pelna tresc wybranego pliku, a reszte pomija. Dzieki temu pelne instrukcje nie zapychaja pamieci ani nie podnosza kosztu kazdego zapytania.

Wiele narzedzi pozwala wywolac skilla wprost, wpisujac nazwe po ukosniku (na przyklad /pierwszy-kontakt), co pomaga wymusic konkretna procedure. Wniosek: jakosc pola description decyduje, czy agent siegnie po wlasciwy skill, wiec dobry opis to polowa sukcesu.

Anatomia pliku SKILL.md

Plik otwiera naglowek YAML (frontmatter): kilka linii metadanych miedzy znacznikami kresek. Obowiazkowe sa dwa pola: name (nazwa malymi literami, do 64 znakow) oraz description (zdanie o tym, kiedy skilla uzyc, do 1024 znakow). Opis napisz jezykiem wyzwalaczy (uzyj, gdy...), bo to jego agent czyta przy wykrywaniu.

Pod naglowkiem zaczyna sie instrukcja w Markdown: naglowki, listy i przyklady, ktore prowadza przez zadanie. Dobra instrukcja podaje kolejnosc krokow, kryteria dobrego wyniku oraz granice (czego skill nie robi i kiedy pytac czlowieka). W tym samym folderze moga lezec skrypty, materialy referencyjne i szablony; w pliku glownym trzymasz minimum, reszte agent dobiera sam.

Minimalny przyklad SKILL.md

Ponizszy przyklad ma 19 linii: naglowek z nazwa i opisem oraz 5 krokow skilla do pierwszego kontaktu.

---
name: pierwszy-kontakt
description: Uzyj, gdy klient pisze pierwszy raz.
  Zbiera potrzeby, proponuje termin, zapisuje podsumowanie.
---

# Pierwszy kontakt

1. Przywitaj klienta i zapytaj o potrzeby.
2. Dopytaj o termin i budzet.
3. Zaproponuj 2 terminy spotkania.
4. Zapisz podsumowanie wedlug szablonu.
5. Jesli brakuje danych, popros o uzupelnienie.

## Szablon podsumowania

- Klient: imie, telefon
- Potrzeba: jednym zdaniem
- Termin: data i godzina

Dwie rzeczy warte uwagi: opis nazywa moment uzycia (pierwszy kontakt klienta), a instrukcja to same decyzje, zero teorii. Wiecej szczegolow daja otwarta specyfikacja formatu i strona standardu agentskills.io, a gotowe przyklady pokazuja publiczna kolekcja przenosnych skilli.

Jak stworzyc skill AI krok po kroku

Stworzenie skilla to spisanie zadania, ktore juz wykonujesz, nie programowanie. Calosc zamyka sie w 5 krokach i zajmuje od 1 do 3 godzin.

Wybierz jedno zadanie, ktore robisz co najmniej 3 razy w tygodniu i za kazdym razem tak samo: zapytania, kwalifikacja leadow, podsumowania.
Opisz efekt jednym zdaniem, na przyklad: podsumowanie ma klienta, potrzebe i termin. To zdanie bedzie kryterium jakosci.
Rozpisz od 3 do 7 krokow i dopisz, co robic, gdy czegos brakuje (jesli brak telefonu, popros o niego).
Napisz description formula kiedy i dla kogo (wystarczy 200 znakow z limitu 1024).
Przetestuj na 3 przykladach (latwym, typowym, trudnym) i doprecyzuj kroki, w ktorych agent zabladzil.

Checklista przed startem: jeden skill robi jedna rzecz; opis mowi, kiedy go uzywac; kroki sa ponumerowane; zaden krok nie wymaga zgadywania; w pliku nie ma hasel ani danych klientow.

SKILL.md w malej firmie: koszty, ryzyka i start

Sam plik nie kosztuje nic: to tekst, ktory piszesz raz i poprawiasz jak cennik. Placisz za prace agenta, ale ladowanie na zadanie oznacza, ze kosztuja tylko instrukcje realnie wczytane. Przy pelnej automatyzacji (na przyklad asystent do pierwszego kontaktu) wdrozenie trwa od 1 do 3 tygodni, a pakiet Start zaczyna sie od 1 200 zl.

Ryzyka sa trzy. Po pierwsze, w skillu nie trzymasz wrazliwych danych: hasel, kluczy API ani danych klientow (agent pobiera je z narzedzi w momencie pracy). Po drugie, instrukcja mowi, kiedy pytac czlowieka, bo skill bez granic potrafi sam wyslac wiadomosc albo zmienic dane. Po trzecie, RODO: przy danych osobowych potrzebujesz umowy powierzenia z dostawca modelu; wiecej o tym w tekscie chatbot a RODO.

Od czego zaczac w tym tygodniu? Wybierz jedno codzienne zadanie (najczesciej pierwsze odpowiedzi na zapytania) i opisz je na stronie: kroki, przyklad wyniku i liste zakazow. Taki opis to zalazek skilla i dokladnie to, o co pytam przed wdrozeniem chatbota krok po kroku. Po inspiracje zajrzyj do malo znanych zastosowan AI w biznesie.

SKILL.md: najczestsze pytania

Co to jest SKILL.md?

SKILL.md to plik w formacie Markdown, ktory uczy agenta AI jednego zadania. Zawiera naglowek YAML z nazwa i opisem (informacja, kiedy ze skilla korzystac) oraz instrukcje krok po kroku (informacja, jak prace wykonac). Format opisuje otwarty standard Agent Skills, opublikowany przez Anthropic 18 grudnia 2025 roku.

Do czego sluzy plik SKILL.md w agentach AI?

Plik SKILL.md sluzy do tego, by agent AI wykonywal powtarzalne zadanie tak samo dobrze za kazdym razem. Zamiast zgadywac, agent laduje spisana procedure: kolejnosc krokow, kryteria jakosci i granice, po ktorych ma zapytac czlowieka. W firmie sprawdza sie tam, gdzie dzis dziala instrukcja dla pracownika: zapytania, leady, podsumowania rozmow.

Czym rozni sie skill od zwyklego promptu?

Prompt to jednorazowe polecenie, ktore znika razem z rozmowa; skill to instrukcja zapisana w pliku i uzywana wielokrotnie. Prompt mowi, co zrobic raz, a skill mowi, jak robic dana rzecz za kazdym razem, niezaleznie od uzytkownika. Prosta regula: jesli prosisz agenta o to samo trzeci raz, tresc powinna stac sie skillem.

Gdzie zyja skille: Claude Code, Cursor, Codex?

Skille zyja w folderach roboczych agenta: w Claude Code w katalogu skills, w podobnych miejscach w Cursorze i OpenAI Codex, a standard jest wspolny dzieki otwartej specyfikacji Agent Skills. Raz napisany skill dziala w ponad 40 narzedziach, choc szczegoly wywolania (na przyklad komendy po ukosniku) roznia sie miedzy programami.

Jak stworzyc wlasny skill AI?

Wybierz jedno powtarzalne zadanie, opisz efekt koncowy jednym zdaniem i rozpisz od 3 do 7 krokow w kolejnosci wykonania. Dopisz pola name i description (kiedy skilla uzywac), a potem przetestuj instrukcje na 3 prawdziwych przykladach i popraw miejsca, gdzie agent zabladzil. Calosc zajmuje od 1 do 3 godzin, bez programowania.

Czy SKILL.md jest bezpieczny dla danych firmy (RODO)?

Tak, pod warunkiem ze skill nie zawiera wrazliwych danych: hasel, kluczy API ani danych klientow. Agent pobiera je z narzedzi w momencie pracy, a instrukcja mowi tylko, jak je przetwarzac i kiedy zapytac czlowieka. Jesli skill dotyka danych osobowych, dopilnuj umowy powierzenia z dostawca modelu i klauzuli na stronie.

SKILL.md agenci AI w jednym zdaniu: to krotki, standardowy plik, ktory uczy agenta jednego powtarzalnego zadania i laduje sie tylko wtedy, gdy jest potrzebny. Dla malej firmy nie jest to technologia do kupienia, tylko sposob myslenia: opisuj powtarzalne zadania tak dokladnie, jakbys pisal instrukcje dla nowego pracownika. Zacznij od jednego zadania w tym tygodniu, a gdy opis zadziala na papierze, porozmawiajmy o automatyzacji.

Sprawdz, co da sie zautomatyzowac w Twojej firmie: bezplatna diagnoza procesu w 48 godzin.