Czym jest umiejętność agenta (SKILL.md) i jak ją sprawdzić

Umiejętność to folder z plikiem SKILL.md, który leży tam, gdzie twój agent kodujący go szuka. Agent czyta ten plik tylko wtedy, gdy twoje żądanie do niego pasuje. Do tego czasu umiejętność kosztuje około stu tokenów, podczas gdy prompt podróżuje z każdą wiadomością, do której go wkleisz.

Prawdopodobnie spotkałeś to słowo w README: „zainstaluj umiejętność, a potem poproś agenta o...”. Nie ma w tym nic tajemniczego. Poniżej: co jest w środku, kiedy trafia do okna kontekstu i jak obejrzeć umiejętność, zanim wpuścisz ją na swój komputer.

Czym jest umiejętność i czym różni się od promptu#

Dokumentacja Agent Skills firmy Anthropic (sprawdzona 30 października 2026) opisuje umiejętność jako zasób wielokrotnego użytku oparty na systemie plików: katalog z plikiem SKILL.md oraz opcjonalnymi skryptami, szablonami i plikami referencyjnymi. SKILL.md zaczyna się od małego nagłówka YAML (nazwa i opis), a następnie zawiera zwykłe instrukcje.

Pomyśl o nowym współpracowniku. Prompt to ty stojący za jego krzesłem i powtarzający zasady każdego ranka. Umiejętność to segregator na półce z etykietą na grzbiecie: „Styl komunikatów commit. Przeczytaj, gdy ktoś poprosi cię o commit.” Sięga po niego tylko wtedy, gdy jest potrzebny.

Dwa pola nagłówka są wymagane, a format ma swoje zasady. W formacie Skills firmy Claude name ma najwyżej 64 znaki: małe litery, cyfry i myślniki, i nie może zawierać słów „anthropic” ani „claude”. description nie może być puste, ma limit 1 024 znaków i musi mówić zarówno, co robi umiejętność, jak i kiedy jej użyć.

Jak umiejętność trafia do okna kontekstu#

Dokumentacja nazywa to stopniowym ujawnianiem: agent czyta umiejętność w trzech etapach, a za każdy etap płaci się tylko wtedy, gdy zostanie osiągnięty.

• Poziom 1, zawsze ładowany. Nazwa i opis każdej zainstalowanej umiejętności, około 100 tokenów na umiejętność.
• Poziom 2, po wyzwoleniu. Treść SKILL.md, poniżej 5 000 tokenów.
• Poziom 3, tylko gdy potrzebny. Dołączone pliki i skrypty. Gdy agent uruchamia skrypt, kod skryptu nie trafia do kontekstu, tylko jego wynik.

Liczby tokenów to przybliżenia z dokumentacji, nie dokładne zliczenia.

Oto dlaczego ma to znaczenie dla twojego rachunku. Załóżmy, że masz zainstalowanych 20 umiejętności. 20 × 100 = 2 000 tokenów jedzie z pierwszą wiadomością. Agent wysyła swój kontekst ponownie na każdym kroku (przykład 20 kroków pokazuje dlaczego), więc sesja 50 kroków niesie 50 × 2 000 = 100 000 tokenów wejściowych samych etykiet umiejętności. Na DeepSeek-V4-Flash to $0.0015 przy obecnych cenach.

Teraz odwrotnie. Gdyby te dwadzieścia umiejętności było wklejonych jako jeden wielki prompt, każda treść siedziałaby w każdym żądaniu: do 20 × 5 000 = 100 000 tokenów na żądanie, nie na sesję. Ta różnica to cały sens ładowania na żądanie. Jeśli termin „okno kontekstu” jest wciąż mglisty, ten wyjaśniacz omawia, co je wypełnia.

Umiejętności żyją w kontekście, więc model stojący za agentem potrzebuje na nie miejsca. DeepSeek-V4-Flash na CheapTokens (id deepseek-ai/DeepSeek-V4-Flash-0731) ma okno kontekstu 380K i do 32 768 tokenów wyjściowych na odpowiedź, jedną cenę o każdej porze dnia oraz API zgodne z OpenAI i Anthropic. Dla agenta terminalowego postępuj według jak podłączyć Claude Code do CheapTokens; dla każdego innego narzędzia zacznij od dokumentacji. Strona samego modelu jest tutaj.

Napisz minimalną umiejętność w dwie minuty#

Czytanie jest łatwiejsze po napisaniu jednej. Ta umiejętność sprawia, że agent pisze komunikaty commit w ustalonym formacie. W Claude Code osobiste umiejętności żyją w ~/.claude/skills/, a umiejętności projektowe w .claude/skills/, więc umiejętność projektowa może podróżować z repozytorium.

mkdir -p ~/.claude/skills/commit-message-style
nano ~/.claude/skills/commit-message-style/SKILL.md   # or any editor

Wklej to do pliku:

---
name: commit-message-style
description: Writes git commit messages in this project's format. Use when the user asks to commit, to write a commit message, or to summarize staged changes.
---

# Commit message style

1. Run `git diff --staged` and read it.
2. First line: `type(scope): summary`, at most 72 characters. Types: feat, fix, docs, refactor, test.
3. Blank line, then up to three bullets that say why the change was made, not what changed.
4. Do not put file names in the first line.

Teraz otwórz agenta w repozytorium z przygotowanymi zmianami i poproś: „napisz komunikat commit dla tego, co przygotowałem”. Agent widzi opis, decyduje, że pasuje, czyta cztery zasady i ich przestrzega. Jeśli zignoruje umiejętność, najpierw spójrz na description: musi nazywać sytuację, tutaj „commit”, słowami, których naprawdę byś użył.

Jeden haczyk: umiejętności nie synchronizują się między claude.ai, API i Claude Code. Umiejętność stworzoną w jednym miejscu trzeba dodać do pozostałych osobno.

Skill, AGENTS.md, MCP: co jest czym#

Te trzy rzeczy są ciągle mylone. Plik zasad taki jak AGENTS.md lub CLAUDE.md jest czytany na początku sesji i zawiera fakty o projekcie (jak ten plik może pójść źle w folderze Pobrane). Serwer MCP daje agentowi nowe narzędzia i dane, do których może dotrzeć (MCP po ludzku). Umiejętność to procedura: jak wykonać jeden rodzaj zadania, ładowana, gdy to zadanie się pojawi.

Sprawdź umiejętność od strony trzeciej przed instalacją#

Umiejętność to tekst, którego agent przestrzega, a czasem kod, który uruchamia. Dokumentacja mówi, aby używać umiejętności tylko ze zaufanych źródeł, audytować każdy dołączony plik (SKILL.md, skrypty, zasoby) i szukać nieoczekiwanych połączeń sieciowych lub dostępu do plików. Umiejętności, które pobierają zewnętrzne adresy URL, są bardziej ryzykowne. W Claude Code umiejętność ma taki sam dostęp do sieci jak każdy program na twoim komputerze, więc traktuj instalację jak instalowanie oprogramowania.

Dobrym okazem jest universal-modder, zestaw narzędzi do modowania gier. Jego README (sprawdzone 30 października 2026) opisuje zestaw umiejętności na licencji MIT w formacie Agent Skills, CLI w Pythonie o nazwie um, serwer MCP do generowania zasobów przez fal oraz wspólną bazę wiedzy z notatkami z terenu. Główna umiejętność, mod-any-game, obejmuje rekonesans, inżynierię wsteczną, generowanie zasobów, testowanie w grze i pakowanie. README wymienia Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot i OpenCode jako obsługiwane narzędzia i mówi, że zestaw odmawia obchodzenia anti-cheatu lub DRM. W Claude Code instaluje się przez /plugin marketplace add rehan-remade/universal-modder, a generowanie zasobów wymaga osobnego klucza API fal.

Zauważ, co zawiera ta lista: umiejętności, program wiersza poleceń i serwer. Przeczytanie jednego SKILL.md objęłoby tylko wycinek tego, co instalujesz. Przejdź więc przez elementy:

Kluczowa zasada jest w jak bezpiecznie przechowywać klucz API. Strona repozytorium nie pokazuje daty ostatniego commita, więc sprawdź, jak niedawno projekt był aktualizowany, zanim na nim polegniesz.