# Umiejętności agentów AI: czym są i jak napisać skuteczną

> Umiejętności agentów AI zamieniają powtarzane instrukcje w pliki ładowane przez agenta na żądanie. Sprawdź, jak działa SKILL.md, poznaj przykłady i dowiedz się, jak napisać własną umiejętność.

Last updated: 2026-09-28T10:00:00

Canonical URL: https://crevio.co/pl/blog/ai-agent-skills

*Ostatnia aktualizacja: wrzesień 2026 r.*

**Jeśli więcej niż dwa razy wyjaśniałeś agentowi AI zasady zwrotów, to znaczy, że już napisałeś umiejętność agenta. Tyle że za każdym razem ją usuwasz.** Umiejętności agentów AI rozwiązują ten problem: to krótkie pliki zawierające procedurę, które agent odczytuje tylko wtedy, gdy zadanie tego wymaga. Zapisz zasady raz, a każda kolejna rozmowa będzie się od nich zaczynać.

Ten poradnik jest przeznaczony dla właścicieli firm i osób zarządzających, które wykorzystują agenta AI w codziennej pracy i mają dość ciągłego tłumaczenia mu tych samych rzeczy. Wyjaśniamy, czym właściwie jest umiejętność, jak agenci decydują o jej załadowaniu, które zadania jej potrzebują oraz pokazujemy kompletny przykład do skopiowania.

- **Umiejętność to folder z plikiem SKILL.md**: zawiera nazwę, krótki opis i instrukcje. Skrypty oraz pliki referencyjne są opcjonalne
- **Agenci na początku odczytują tylko opis** (około 100 tokenów na umiejętność). Reszta jest ładowana, gdy zadanie pasuje do opisu, więc duża biblioteka pozostaje tania w użyciu
- **To otwarty standard.** Ta sama umiejętność działa w Claude, ChatGPT i Codex, Gemini CLI, Cursor, GitHub Copilot oraz dziesiątkach innych agentów
- **Opis jest najważniejszym elementem.** Niejasny opis oznacza, że umiejętność nigdy się nie uruchomi albo uruchomi się przy niewłaściwym zadaniu
- **Umiejętności firm trzecich to instalowany kod.** Audyt z lutego 2026 r. wykazał krytyczne problemy z bezpieczeństwem w 13,4% publicznych umiejętności

## Czym są umiejętności agentów AI?

**Umiejętności agentów AI to wielokrotnego użytku pakiety instrukcji, które uczą agenta wykonywania konkretnego zadania w określony przez Ciebie sposób.** Każda umiejętność to folder zawierający plik `SKILL.md`. Plik zaczyna się krótkim nagłówkiem (zawierającym `name` i `description`), po którym następują instrukcje napisane prostym językiem: kroki, zasady, format wyniku i sytuacje nietypowe.

Pomysł pochodzi od Anthropic, które [przedstawiło Agent Skills w październiku 2025 r.](https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills), opisując je jako „uporządkowane foldery z instrukcjami, skryptami i zasobami, które agenci mogą wykrywać i dynamicznie ładować”. W grudniu 2025 r. firma opublikowała ten format jako otwarty standard na stronie [agentskills.io](https://agentskills.io/home), a od tego czasu przyjęła go większość najważniejszych agentów.

![Wpis techniczny Anthropic przedstawiający Agent Skills, opublikowany 16 października 2025 r.](https://crevio.co/vite/assets/anthropic-agent-skills-announcement-fr3rjecj.png)

Tego określenia używa się też luźniej w odniesieniu do „rzeczy, które potrafią agenci AI” albo umiejętności potrzebnych do zarządzania agentami. To prawdziwe, ważne tematy, ale gdy w 2026 r. osoby budujące lub kupujące agentów mówią o „umiejętnościach”, prawie zawsze mają na myśli właśnie to: zapakowaną procedurę, którą agent może wczytać, a potem odłożyć.

### Co znajduje się w folderze umiejętności

Specyfikacja [Agent Skills](https://agentskills.io/specification) celowo utrzymuje strukturę w niewielkim rozmiarze:

| Element | Wymagany? | Co zawiera |
|---|---|---|
| `SKILL.md` | Tak | Nagłówek z `name` i `description`, a następnie instrukcje |
| `scripts/` | Nie | Kod, który agent może uruchomić, np. generator raportów lub walidator |
| `references/` | Nie | Dłuższe dokumenty: pełne zasady, cennik, przewodnik po stylu |
| `assets/` | Nie | Szablony, przykładowe pliki, tabele pomocnicze |

Nagłówek ma ścisłe limity. `name` może mieć maksymalnie 64 znaki: małe litery, cyfry i łączniki. `description` może mieć maksymalnie 1024 znaki i zgodnie ze specyfikacją „powinien opisywać zarówno działanie umiejętności, jak i moment, w którym należy jej użyć”.

![Strona specyfikacji Agent Skills pokazująca wymagany plik SKILL.md oraz opcjonalne foldery scripts, references i assets](https://crevio.co/vite/assets/agentskills-specification-idwfflfk.png)

## Jak agenci ładują umiejętności

Najciekawsza część tego formatu polega na tym, że agent nie odczytuje wszystkich umiejętności naraz. Ładuje je na trzech poziomach, co specyfikacja nazywa **progresywnym ujawnianiem**.

![Schemat trzech poziomów ładowania przez agenta: nazwa i opis zawsze, instrukcje SKILL.md po dopasowaniu zadania oraz pliki referencyjne lub skrypty tylko wtedy, gdy wymaga tego dany krok](https://crevio.co/vite/assets/how-agents-load-skills-g1wbt1jh.svg)

1. **Wykrywanie.** Na początku każdej sesji agent odczytuje tylko nazwę i opis każdej zainstalowanej umiejętności — około 100 tokenów na każdą
2. **Aktywacja.** Gdy Twoja prośba pasuje do opisu, agent odczytuje cały plik `SKILL.md`. Specyfikacja zaleca, aby miał on mniej niż 5000 tokenów i 500 wierszy
3. **Wykonanie.** Agent stosuje instrukcje i otwiera plik referencyjny albo uruchamia skrypt tylko wtedy, gdy dany krok do niego odsyła

Dzięki temu firma może mieć zainstalowane dziesiątki umiejętności bez spowalniania agenta i płacenia za kontekst, którego nigdy nie użyje. To również dlatego opis ma tak duże znaczenie: przed podjęciem decyzji agent widzi tylko jego treść. W [poradniku tworzenia umiejętności](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices) Anthropic pisze, że agent może wybierać spośród „ponad 100 dostępnych umiejętności”, korzystając z tego jednego pola.

## Umiejętności a prompty, narzędzia i pamięć

Umiejętności częściowo pokrywają się z kilkoma rozwiązaniami, których możesz już używać. Różnica polega na tym, co każde z nich przechowuje i kiedy pojawia się w kontekście agenta.

| | Co zawiera | Kiedy agent to widzi | Do czego służy |
|---|---|---|---|
| **Prompt** | Jedno polecenie | Tylko w tej rozmowie | Zadania jednorazowe |
| **Instrukcje niestandardowe** | Stałe preferencje | Zawsze, w każdej rozmowie | Ton, imię, strefa czasowa |
| **Pamięć** | Fakty, których agent się dowiedział | Gdy sobie o nich przypomni | „Listopad to nasz najbardziej pracowity miesiąc” |
| **Narzędzie lub integracja** | Dostęp do systemu | Gdy agent musi wykonać działanie | Odczytywanie zamówień, wysyłanie e-maili |
| **Umiejętność** | Procedurę | Tylko gdy zadanie pasuje | „Jak obsługujemy zwroty” |

Najczęściej mylone są umiejętności i narzędzia. **Narzędzie daje agentowi klucz, a umiejętność mówi mu, co zrobić po wejściu do środka.** Umiejętność mówiąca „sprawdź zamówienie w naszym sklepie” jest bezużyteczna, jeśli agent nie ma dostępu do sklepu. Z kolei dostęp do sklepu jest ryzykowny bez umiejętności określającej, co agent może tam robić, a czego nie. Zwykle potrzebujesz obu tych elementów.

Umiejętności i pamięć odróżniają też agenta, który za każdym razem zaczyna od zera, od agenta, który doskonali się w miarę używania — to rozróżnienie opisaliśmy w artykule [Pracownik AI a agent AI](/pl/blog/ai-employee-vs-ai-agent).

## Gdzie dziś działają umiejętności agentów AI

Ponieważ jest to otwarty standard, napisana przez Ciebie umiejętność nie jest przypisana do jednego produktu. Lista klientów na [agentskills.io](https://agentskills.io/home) obejmuje Claude i [Claude Code](/pl/blog/claude-code), ChatGPT i Codex, Gemini CLI, Cursor, GitHub Copilot, VS Code, OpenCode, Goose, Databricks, Snowflake oraz ponad 30 innych narzędzi.

Później pojawiły się publiczne katalogi. Na stronie [skills.sh](https://skills.sh/) znajdziesz społecznościowe umiejętności instalowane jednym poleceniem — od umiejętności pisania i prowadzenia researchu po rozwiązania stworzone z myślą o konkretnych narzędziach.

![skills.sh — publiczny katalog społecznościowych umiejętności agentów z rankingiem instalacji](https://crevio.co/vite/assets/skills-sh-directory-f00n0in6.png)

Duża część tej biblioteki została napisana przez programistów z myślą o agentach programistycznych. Umiejętności przydatne w prowadzeniu firmy rzadko trafiają do rankingów, bo zawierają informacje znane tylko Tobie: zasady, sposób komunikacji i dane.

## Przykłady umiejętności agentów AI dla małej firmy

Tak może wyglądać podstawowa biblioteka umiejętności w firmie sprzedającej produkty lub usługi cyfrowe:

| Umiejętność | Co zawiera | Uruchamia się, gdy |
|---|---|---|
| `handling-refund-requests` | Zasady zwrotów, reguły zatwierdzania, ton odpowiedzi | Klient prosi o zwrot pieniędzy |
| `writing-weekly-report` | Które liczby sprawdzać, w jakiej kolejności, co uznać za „istotne” | Pytasz, jak minął tydzień |
| `writing-in-brand-voice` | Używane słowa, słowa zakazane, przykładowe e-maile | Trzeba przygotować treść skierowaną do klienta |
| `launching-a-product` | Lista kontrolna premiery, sekwencja e-maili, zasady cenowe | Mówisz: „uruchommy X” |
| `qualifying-leads` | Kto pasuje do profilu klienta, o co zapytać, kiedy umówić rozmowę | Pojawia się nowy lead |
| `pricing-a-custom-quote` | Cennik, stawki minimalne, dozwolone rabaty | Potencjalny klient pyta: „ile to kosztuje?” |

Zwróć uwagę, czego tu nie ma: „napisz wpis na bloga” ani „streść ten PDF”. Model już dobrze radzi sobie z takimi zadaniami. Umiejętność zasługuje na miejsce w bibliotece wtedy, gdy przechowuje kontekst, którego agent nie może odgadnąć.

## Które zadania zasługują na umiejętność, a które nie

Zanim cokolwiek napiszesz, oceń zadanie, odpowiadając na dwa pytania: jak często się powtarza i czy agent popełnia błędy bez Twojego kontekstu?

![Macierz dwa na dwa: umiejętność warto napisać tylko dla zadań, które często się powtarzają i przy których agent popełnia błędy bez Twojego kontekstu](https://crevio.co/vite/assets/what-deserves-a-skill-bje0433g.svg)

Zespoły PostHog opublikowały 226 umiejętności w wewnętrznym katalogu i doszły do podobnego wniosku w [artykule o tworzeniu umiejętności](https://posthog.com/newsletter/writing-agent-skills): twórz umiejętności do pracy, która się powtarza, z którą agenci domyślnie sobie nie radzą albo która wymaga nieoczywistego kontekstu. Wszystko inne to narzut utrudniający agentowi wybór.

## Jak napisać umiejętność agenta AI

Nie musisz programować. Przydatna umiejętność to dobrze napisana procedura z precyzyjnym nagłówkiem.

### Krok 1: Najpierw wykonaj zadanie razem z agentem

Anthropic radzi zacząć od prawdziwej rozmowy, a nie od pustego pliku. Wykonaj zadanie, na bieżąco poprawiaj agenta i zwracaj uwagę na to, co musisz mu wyjaśnić. Te poprawki staną się treścią umiejętności.

### Krok 2: Najpierw napisz opis

Opis decyduje o tym, czy umiejętność kiedykolwiek się załaduje. Napisz go w trzeciej osobie, określ, co robi umiejętność, i wymień wyrażenia, które rzeczywiście mogą pojawić się w prośbie:

- **Słabo:** „Pomaga w obsłudze klientów”.
- **Dobrze:** „Obsługuje prośby o zwrot pieniędzy za produkty cyfrowe. Użyj, gdy klient prosi o zwrot, mówi, że zakup nie działa, albo wspomina o obciążeniu zwrotnym”.

### Krok 3: Zapisz cele i zasady, nie scenariusz

Określ cel, twarde zasady, kroki, format wyniku i sytuacje nietypowe. Precyzyjnie opisz ograniczenia, ale pozostaw swobodę w formułowaniu odpowiedzi. Warto przytoczyć ostrzeżenie PostHog: „Nadmiar szczegółowych instrukcji zamienia umiejętność w workflow i odbiera agentowi inteligencję, za którą płacisz”.

### Krok 4: Przenieś długie materiały do plików referencyjnych

Jeśli pełne zasady zajmują trzy strony, umieść je w pliku `references/refund-policy.md` i dokładnie określ, kiedy agent ma go otworzyć. Zachowaj jeden poziom zagnieżdżenia: pliki odsyłające do innych plików często są odczytywane tylko częściowo.

### Krok 5: Przetestuj umiejętność na trzech prawdziwych prośbach

Wykonaj trzy realistyczne prośby, w tym jedną, która *nie powinna* uruchomić umiejętności. Jeśli uruchamia się przy niewłaściwym zadaniu albo nie reaguje na oczywiste dopasowanie, problem prawie zawsze tkwi w opisie.

### Kompletny przykład do skopiowania

```
---
name: handling-refund-requests
description: Handles refund requests for digital products (courses, templates, downloads). Use when a customer asks for a refund, says a purchase did not work, disputes a charge, or mentions a chargeback.
---

# Handling refund requests

## Goal
Resolve the request in one reply and keep the customer where possible.
Never refund outside policy without the owner's approval.

## Policy
- Courses: full refund within 14 days if under 30% of lessons completed
- Templates and downloads: no refund after download; offer a fix or an exchange
- Duplicate purchases: always refund the duplicate

## Steps
1. Look up the order: product type, purchase date, usage
2. Compare against the policy above
3. Within policy: draft the refund and the reply, then ask for approval
4. Outside policy: draft a reply offering the fix or exchange. Do not promise a refund
5. Chargeback, lawyer, or angry repeat contact: stop and hand it to the owner

## Reply style
Short and warm. Use their first name. Apologize once, not three times.
Sign off as "The Studio Team".

## Edge cases
- Bought the wrong course: offer a free swap before a refund
- Payment failed but they were charged: treat as a duplicate
```

To mniej niż 250 słów i zastępuje rozmowę, którą w przeciwnym razie trzeba byłoby przeprowadzać co tydzień.

## Czego nikt nie mówi o umiejętnościach agentów

Sam format jest prosty. Niespodzianki pojawiają się dopiero po kilku miesiącach korzystania z biblioteki umiejętności.

**Wraz z rozwojem biblioteki umiejętności zaczynają się ze sobą zderzać.** W artykule PostHog przytoczono obserwację Databricks: „W miarę dodawania kolejnych umiejętności agenci coraz częściej wybierają niewłaściwą”. Dwie umiejętności z podobnymi opisami („e-maile do klientów” i „odpowiedzi działu wsparcia”) będą nieprzewidywalnie wybierać między sobą. Połącz je albo spraw, by każdy opis wskazywał sytuacje, których nie obejmuje druga umiejętność.

**Umiejętności po cichu się dezaktualizują.** Zmienia się okres na zwrot, ceny lub nazwa narzędzia, a umiejętność nadal z przekonaniem stosuje stare zasady. Umieść wszystkie zmienne informacje w jednym pliku referencyjnym, który rzeczywiście aktualizujesz — tak jak w [bazie wiedzy agenta AI](/pl/blog/ai-agent-knowledge-base) — i sprawdzaj umiejętności za każdym razem, gdy zmieniają się podstawowe zasady.

**Umiejętności firm trzecich to oprogramowanie, nie tekst.** Firma Snyk przeskanowała w lutym 2026 r. 3984 publiczne umiejętności i [wykryła luki bezpieczeństwa w 36,82% z nich, a krytyczne problemy w 13,4%](https://snyk.io/blog/toxicskills-malicious-ai-agent-skills-clawhub/), w tym 76 potwierdzonych złośliwych ładunków służących do kradzieży danych uwierzytelniających, instalowania backdoorów lub wyprowadzania danych. Zalecenie Anthropic jest jednoznaczne: instaluj umiejętności tylko z zaufanych źródeł, a każdą inną najpierw przeczytaj. O tym samym ryzyku pisaliśmy w artykule o [alternatywach dla OpenClaw](/pl/blog/openclaw-alternatives), gdzie umiejętności społecznościowe były jednym z głównych powodów do obaw.

**Umiejętność nie przyznaje uprawnień.** Instrukcja „zrealizuj zwrot pieniędzy” nic nie da bez dostępu do systemu płatności, a dostęp bez ograniczeń stanowi jeszcze większe zagrożenie. Niezależnie od treści umiejętności, operacje związane z pieniędzmi, wysyłką i usuwaniem danych powinny wymagać zatwierdzenia. To ta sama zasada, którą stosujemy w przypadku [przekazywania pracy agentom AI w małej firmie](/pl/blog/ai-agents-for-small-business): wszystko, co opuszcza firmę, agent powinien przygotować, ale nie wysyłać.

## Jak Crevio wykorzystuje umiejętności

[Crevio](https://crevio.co/) to narzędzie AI do budowania firmy: opisujesz, co chcesz sprzedawać, a agent tworzy sklep, obsługuje płatności, pisze treści marketingowe i pomaga rozwijać firmę. Umiejętności pozwalają agentowi zachowywać wiedzę między rozmowami.

![Strona główna Crevio: AI, które buduje sklep, obsługuje płatności, tworzy marketing i zwiększa sprzedaż](https://crevio.co/vite/assets/crevio-homepage-nvib9pqi.png)

W praktyce wygląda to tak:

- **Umiejętności są dostępne od razu.** Agent ma umiejętności dotyczące cold mailingu, lead magnetów, cen, [audytów SEO](/pl/blog/ai-agents-for-seo), kreacji reklamowych, postów w mediach społecznościowych oraz pracy z plikami PDF, arkuszami kalkulacyjnymi, dokumentami i prezentacjami
- **Możesz instalować i przesyłać własne umiejętności.** Strona Skills w ustawieniach zawiera marketplace umiejętności społecznościowych. Możesz też przesłać własną umiejętność jako `.zip`, folder lub pojedynczy plik `SKILL.md`. Przesłane umiejętności pozostają prywatne na Twoim koncie
- **Agent tworzy umiejętności na podstawie doświadczenia.** Po długim i złożonym zadaniu Crevio analizuje jego przebieg i zapisuje trwałe elementy jako umiejętność. Pojawiają się one w sekcji „Nabyte przez Twoją AI”, gdzie możesz je przeczytać lub usunąć
- **Możesz uczyć, pokazując.** Funkcja „Naucz zadania” rejestruje, jak wykonujesz coś na komputerze agenta, a Crevio zamienia nagranie w umiejętność wielokrotnego użytku

Uczciwe zastrzeżenie: umiejętność napisana przez agenta dla samego siebie jest tylko tak dobra, jak rozmowa, na podstawie której powstała. Przeczytaj zapisane treści, zwłaszcza jeśli dotyczą pieniędzy lub klientów. Crevio ma bezpłatny plan, więc możesz wypróbować bibliotekę umiejętności bez podawania karty.

## Najczęściej zadawane pytania

### Czy umiejętności agentów to to samo co MCP?

Nie. MCP (Model Context Protocol) to jeden z kilku sposobów na [połączenie agenta z aplikacjami firmowymi](/pl/blog/connect-ai-agents-to-business-apps), takimi jak CRM czy skrzynka odbiorcza. Umiejętność to pisemna procedura, która mówi agentowi, jak korzystać z dostępnych zasobów. Te rozwiązania współpracują ze sobą: MCP zapewnia dostęp, a umiejętność określa, kiedy i jak z niego korzystać.

### Czy do napisania umiejętności agenta AI trzeba programować?

Nie. Większość przydatnych umiejętności biznesowych to zwykły Markdown: nagłówek, cel, zasady i kroki. Skrypty są opcjonalne i warto je dodawać tylko do czynności, które za każdym razem muszą przebiegać identycznie, takich jak generowanie sformatowanego raportu lub sprawdzanie obliczeń.

### Czy umiejętności Claude to to samo co umiejętności agentów?

W praktyce tak. Anthropic stworzyło ten format dla Claude, a następnie opublikowało go jako otwarty standard Agent Skills. Umiejętność napisana dla Claude zazwyczaj działa w każdym agencie obsługującym ten standard, o ile nie zależy od narzędzia dostępnego wyłącznie w jednym produkcie.

### Ile umiejętności powinien mieć agent?

Tyle, ile masz odrębnych, powtarzalnych procedur — i ani jednej więcej. Koszt ładowania jest niewielki, ale nakładające się opisy sprawiają, że agent może wybrać niewłaściwą umiejętność. Jeśli dwie umiejętności mogłyby sensownie odpowiadać na tę samą prośbę, połącz je.

## W skrócie

Umiejętności agentów AI odróżniają agenta, którym zarządzasz, od agenta, którego wyszkoliłeś. Zacznij od procedury, którą ciągle musisz tłumaczyć, napisz opis tak, jakby wszystko od niego zależało, a resztę pozostaw krótką. Najlepsza biblioteka umiejętności nie jest największa. To ta, w której każdy plik opisuje coś, czego masz już dość powtarzania.

## Powiązane wpisy na blogu

- [Pracownik AI a agent AI: różnica, która naprawdę ma znaczenie](/pl/blog/ai-employee-vs-ai-agent)
- [Agenci AI dla małych firm: które zadania przekazać im w pierwszej kolejności](/pl/blog/ai-agents-for-small-business)
- [Najlepsi agenci AI do Slacka w 2026 r. (porównanie 11 narzędzi)](/pl/blog/best-ai-agents-for-slack)