
Samouczek Claude Skills: Zbuduj swój pierwszy SKILL.md w 10 minut (2026)
Skills to prawdopodobnie najważniejsza funkcja Claude Code, której jeszcze nie używasz. Claude skill to folder z plikiem SKILL.md, który Claude automatycznie ładuje w momencie, gdy Twój prompt pasuje do jego opisu — bez kopiowania i wklejania promptów, bez rozdętego CLAUDE.md i bez pamiętania, który szablon wybrać. Opublikowaliśmy 4 skills w folderze .claude/skills/agent/ tego repozytorium, a wraz z Skills 2.0 oraz Anthropic Marketplace, które zadebiutują na początku 2026 roku, format ten wreszcie nabiera rozpędu. Oto wzorzec, który sprawdza się, gdy już ominiesz typowe pułapki.
Kluczowe wnioski
- Claude skill to folder zawierający plik
SKILL.mdz frontmatterem YAML, który Claude automatycznie ładuje, gdy jest to stosowne.- Skills znajdują się w
~/.claude/skills/(osobiste) lub.claude/skills/(projektowe) — Claude skanuje oba przy uruchomieniu.- Używaj Skills do powtarzalnych przepływów pracy; MCP do danych zewnętrznych w czasie rzeczywistym; subagentów do wieloetapowego planowania; hooków do deterministycznych zdarzeń.
- Najszybszą drogą do Twojego pierwszego skilla jest poproszenie Claude, by wywołał własny skill
skill-creator— napisze on SKILL.md za Ciebie.
Czym są Claude Skills?
Claude skill to folder zawierający plik SKILL.md z frontmatterem YAML (name, description, opcjonalnie allowed-tools), który Claude Code automatycznie ładuje do kontekstu, gdy Twój prompt pasuje do opisu. Skille pakują wielokrotnego użytku przepływy pracy, takie jak /commit czy /explain-code, bez rozdymania systemowego promptu.
Zgodnie z oficjalną dokumentacją Anthropic, każdy folder skillu zawiera trzy rzeczy: obowiązkowy SKILL.md, opcjonalne dołączone skrypty (od helpera w Pythonie po konfigurację JSON) oraz opcjonalne dokumenty referencyjne ładowane wraz z treścią główną. To wszystko. Bez etapu budowania, bez instalacji, bez manifestu.
Sprytnym rozwiązaniem jest progresywne ujawnianie. Przy starcie Claude skanuje wyłącznie pole description każdego skillu. Treść główna — instrukcje, przykłady, wzorce wywołań narzędzi — pozostaje na dysku, dopóki Twój prompt faktycznie nie dopasuje się do opisu. Możesz więc mieć zainstalowanych 50 skilli i nie ponosić żadnych kosztów tokenowych, dopóki któryś się nie uruchomi.
Możesz myśleć o skillach jak o przepisach z książki kucharskiej, do których Claude zagląda, gdy zobaczy składniki w Twoim prompcie. Skill to folder, który Claude czyta na żądanie, a nie prompt, o którego wklejeniu musisz pamiętać. Na tym właśnie polega cała idea.
Minimalny SKILL.md wygląda tak:
---
name: Summarize file
description: Use when the user asks for a 3-sentence summary of a file or function.
---
Read the file at $ARGUMENTS. Summarize purpose, key dependencies, and the
single most surprising thing about it. Three sentences max.Dziesięć linijek. Prawdziwy skill. Gotowy do działania.
Szybki start: Zbuduj swoją pierwszą umiejętność w 10 minut
Aby zbudować swoją pierwszą umiejętność Claude w 10 minut: (1) utwórz ~/.claude/skills/explain-code/, (2) dodaj plik SKILL.md zawierający name, description oraz treść przepływu pracy, (3) uruchom ponownie Claude Code, aby przeskanował nowy katalog, (4) wywołaj ją za pomocą promptu pasującego do opisu.
Oto pełny przebieg.
Krok 1: Utwórz katalog
mkdir -p ~/.claude/skills/explain-codeUmiejętności osobiste (przeznaczone tylko dla Ciebie) umieszcza się w ~/.claude/skills/. Umiejętności projektowe (udostępniane zespołowi przez git) umieszcza się w .claude/skills/ w katalogu głównym repozytorium. Wybierz osobiste dla przepływów pracy używanych na co dzień; wybierz projektowe, gdy chcesz, aby dziedziczył je każdy współtwórca repozytorium.
Krok 2: Napisz SKILL.md
Umieść ten plik w ~/.claude/skills/explain-code/SKILL.md:
---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
---
You are explaining code to a developer who is new to this codebase.
1. Read the file or snippet at $ARGUMENTS.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies or side effects.
5. End with one question the reader should ask before changing this code.To cała umiejętność. Frontmatter to umowa; treść to scenariusz.
Krok 3: Uruchom ponownie Claude Code
Wykrywanie na żywo to funkcja Skills 2.0 — starsze wersje Claude Code wymagają ponownego uruchomienia, aby wykryć nowy katalog. Jeśli nie masz pewności, której wersji używasz, jednorazowe ponowne uruchomienie nic nie kosztuje.
Krok 4: Uruchom go
Otwórz projekt i wpisz prompt:
walk me through what auth/middleware.ts doesClaude dopasowuje Twój prompt do pola description, znajduje explain-code i po cichu ładuje treść SKILL.md do kontekstu. W logu narzędzi zobaczysz „Using skill: explain-code". Gotowe.
Pro tip: Nie chce Ci się pisać pliku samodzielnie? Otwórz Claude Code i powiedz
Use the skill-creator skill to scaffold an explain-code skill for me.Dołączony przez Anthropicskill-creatorto metaskill, który przeprowadza z Tobą wywiad, dobiera rozsądneallowed-toolsi zapisuje SKILL.md we właściwym folderze. Najszybsza droga do Twojego pierwszego skilla, kropka.
To właśnie jest obietnica 10 minut: pięć minut pisania, jeden restart, jeden prompt testowy.

Wewnątrz SKILL.md: Referencja frontmattera
Frontmatter pliku SKILL.md to YAML ujęty w ograniczniki ---. Wymagane są dwa pola: name (≤64 znaki, używane jako nazwa polecenia slash) oraz description (tekst wyzwalacza, który Claude dopasowuje do Twojego promptu). Pola opcjonalne kontrolują dostęp do narzędzi, wywoływanie modelu, wzorce glob dla plików oraz kontekst wykonania.
Oto pełna referencja, pochodząca z dokumentacji Anthropic dotyczącej skills:
| Pole | Wymagane? | Typ | Kiedy stosować |
|---|---|---|---|
name | tak | string ≤64 znaki | zawsze, staje się nazwą polecenia slash |
description | tak | string ≤1024 znaki | zawsze, Claude skanuje to pole, aby zdecydować, czy skill pasuje |
allowed-tools | nie | tablica wzorców narzędzi | gdy chcesz ograniczyć skill do konkretnych narzędzi (np. Bash(git *), Read, Grep) |
disable-model-invocation | nie | boolean | gdy skill ma być wywoływany tylko przez użytkownika (polecenie slash, nigdy automatycznie) |
user-invocable | nie | boolean | gdy chcesz oznaczyć skill, który powinien pojawiać się jako /skill-name w palecie poleceń slash |
argument-hint | nie | string | gdy chcesz podać użytkownikowi podpowiedź, co powinno zawierać $ARGUMENTS |
model | nie | string | gdy chcesz przypisać skill do konkretnego modelu (np. claude-opus-4-7) |
context | nie | default lub fork | (Skills 2.0) gdy chcesz uruchomić skill w rozwidlonym oknie kontekstu, aby nie zanieczyszczał głównego wątku |
globs | nie | tablica wzorców glob | gdy chcesz automatycznie sugerować skill, gdy pliki pasujące do wzorców znajdują się w zasięgu |
references | nie | tablica ścieżek do plików | gdy chcesz dołączyć dokumenty referencyjne ładowane razem z treścią skilla |
bundled-files | nie | tablica ścieżek do plików | gdy chcesz dołączyć skrypty, które skill może wykonywać |
tags | nie | tablica stringów | gdy chcesz organizować skille w listingach marketplace |
Wiersz context: fork zasługuje na wyróżnienie. To prymityw Skills 2.0, który uruchamia skill w izolowanym oknie kontekstu — przydatny dla długotrwałych skilli badawczych lub wszystkiego, co generuje dużo pośrednich tokenów, których nie chcesz w głównym wątku. Jeśli ten koncept jest Ci nowy, nasz przewodnik po inżynierii kontekstu omawia związane z nim kompromisy.
Maksymalistyczny frontmatter SKILL.md, z wypełnionymi wszystkimi polami:
---
name: Deploy preview
description: Use when the user wants to deploy a preview build of the current branch to staging.
allowed-tools: ["Bash(git status:*)", "Bash(npm run build:*)", "Bash(vercel:*)"]
disable-model-invocation: true
user-invocable: true
argument-hint: <branch-name or 'current'>
model: claude-opus-4-7
context: fork
globs: ["package.json", "vercel.json"]
references: ["./deploy-runbook.md"]
bundled-files: ["./scripts/preflight.sh"]
tags: ["deploy", "vercel", "preview"]
---Wskazówka: Największy błąd w polu
description: pisanie go dla ludzi. Pisz dla Claude'a — konkretne frazy wyzwalające, a nie teksty marketingowe. Źle: "Potężny skill do automatyzacji Gita." Dobrze: "Użyj, gdy użytkownik chce zatwierdzić zmiany, napisać wiadomość commita lub otworzyć PR."
Dwie prawdziwe umiejętności, od początku do końca
Dwa wzorce umiejętności pokrywają 80% rzeczywistych zastosowań: (1) wywoływana przez użytkownika umiejętność /commit z ustawieniami disable-model-invocation: true i allowed-tools: Bash(git *) dla deterministycznych akcji; (2) automatycznie wywoływana umiejętność /explain-code z domyślnym frontmatterem, którą Claude uruchamia, gdy prompty pasują do jej opisu.
Większość poradników pokazuje fragmenty kodu. Oto dwa kompletne pliki, które możesz już dziś skopiować do ~/.claude/skills/.
Umiejętność /commit (wywoływana przez użytkownika)
---
name: Commit
description: Use when the user wants to stage and commit code changes with an AI-written conventional-commit message.
disable-model-invocation: true
user-invocable: true
allowed-tools:
- "Bash(git status:*)"
- "Bash(git diff:*)"
- "Bash(git add:*)"
- "Bash(git commit:*)"
---
1. Run `git status` and `git diff` to see what's staged and unstaged.
2. Group changes into one logical commit. If there are multiple unrelated
changes, ask the user which to include.
3. Draft a Conventional Commits message: `type(scope): subject` (≤72 chars),
blank line, body explaining *why*, not *what*.
4. Show the message to the user. Ask "Commit this?" Wait for explicit yes.
5. On confirmation, run `git add` for the included files and `git commit -m`.
6. Print the resulting commit hash.Prompt testowy: /commit
Co się dzieje: Claude sprawdza stan gita, tworzy wiadomość, prosi o potwierdzenie i dopiero wtedy uruchamia git commit. Flaga disable-model-invocation: true oznacza, że umiejętność nigdy nie uruchamia się automatycznie w odpowiedzi na niejasny prompt typu „zapisz moje zmiany" – działa wyłącznie po wpisaniu /commit. Biała lista allowed-tools ogranicza ją do podkomend gita; fizycznie nie jest w stanie uruchomić rm -rf ani wypchnąć zmian na zdalne repozytorium. To jedna z umiejętności, które sami używamy produkcyjnie w naszym pipeline.
W przypadku deterministycznych akcji po commicie (uruchamianie lintera, regeneracja typów, pingowanie webhooka Slacka) lepiej sięgnąć po haki Claude Code – umiejętności są probabilistyczne, a haki uruchamiają się za każdym razem.
Umiejętność /explain-code (wywoływana przez model)
---
name: Explain code
description: Use when the user asks for a plain-English walkthrough of a code snippet, function, or file. Use $ARGUMENTS for the path or snippet.
argument-hint: <file path or pasted snippet>
model: claude-opus-4-7
---
1. Read the file or snippet at $ARGUMENTS. If $ARGUMENTS is empty, ask
the user which file to explain.
2. State the file's purpose in one sentence.
3. Walk through the control flow line by line in plain English.
4. Flag any non-obvious dependencies, side effects, or hidden assumptions.
5. End with one question the reader should ask before modifying this code.Testowy prompt: walk me through what auth/middleware.ts does
Co się dzieje: zauważ, że użytkownik nie wpisał /explain-code. Claude dopasowuje "walk me through" do pola description, znajduje umiejętność i automatycznie ją wywołuje. To właśnie jest ta magia — pole description zajmuje się routingiem. Pole model: claude-opus-4-7 przypisuje tę umiejętność do Opusa niezależnie od tego, jaki model ustawisz jako domyślny, dzięki czemu szczegółowe analizy kodu zawsze trafiają do inteligentniejszego modelu. (Więcej o uruchamianiu Claude Code z innymi modelami.)
Po co dwa wzorce? Umiejętność nr 1 jest wywoływana przez użytkownika i ograniczona do konkretnych narzędzi — przewidywalna, bezpieczna, idealna do gita lub wdrożeń. Umiejętność nr 2 jest wywoływana automatycznie i ma otwarty zakres — to magia umiejętności, ale zaufaj swojemu polu
description. Umiejętności wywoływane przez użytkownika dają przewidywalność; umiejętności wywoływane przez model dają magię. Wybieraj osobno dla każdej umiejętności, a nie dla całego repozytorium.
Więcej przykładowych umiejętności znajdziesz w oficjalnym repozytorium anthropics/skills oraz na utrzymywanej przez społeczność liście awesome-claude-skills.
Skills vs MCP vs Subagents vs Hooks: kiedy czego używać
Używaj Skills dla powtarzalnych przepływów pracy, które Claude powinien uruchamiać automatycznie lub które wywołujesz jako polecenia slash. Używaj serwerów MCP, gdy potrzebujesz danych zewnętrznych w czasie rzeczywistym (bazy danych, API, systemy plików poza katalogiem roboczym). Używaj subagentów dla wieloetapowych planów, które Claude powinien delegować do świeżego kontekstu. Używaj hooks dla deterministycznych zdarzeń (pre-commit, post-tool-use), które muszą się zawsze wyzwolić — nigdy probabilistycznie.
Szybkie ramy: skills to przepływy pracy, Model Context Protocol to dane, subagenci to plany, hooks to zdarzenia. Każdy z nich działa na innej warstwie Claude Code, a niewłaściwa warstwa to niewłaściwe narzędzie. Według samego wpisu Anthropic Skills explained, właśnie takie ramy chcą, żebyś przyswoił.
| Pytanie | Skills | MCP | Subagents | Hooks |
|---|---|---|---|---|
| Wyzwalane przez | dopasowanie promptu lub /slashcmd | model decyduje o wywołaniu narzędzia | model deleguje zadanie | zdarzenie Claude Code (pre-tool-use, post-edit) |
| Znajduje się w | .claude/skills/ | serwer zewnętrzny (stdio lub SSE) | .claude/agents/ | blok hooks w settings.json |
| Najlepsze do | powtarzalne przepływy pracy, szablony promptów z logiką | dane w czasie rzeczywistym, API stron trzecich, dostęp do systemu plików poza cwd | wieloetapowe planowanie, praca równoległa, izolowane konteksty | deterministyczne zdarzenia, które muszą się zawsze wyzwolić |
| Determinizm | probabilistyczne (Claude wybiera) | probabilistyczne (Claude wybiera) | probabilistyczne (Claude wybiera) | deterministyczne (zawsze się wyzwala) |
| Koszt tokenów | niski (przy skanowaniu ładuje się tylko description) | średnio-wysoki (definicje narzędzi + odpowiedzi) | wysoki (świeży kontekst przy każdej delegacji) | brak (wykonanie shella poza pasmem) |
| Kiedy NIE używać | dane w czasie rzeczywistym, zdarzenia deterministyczne | statyczne przepływy pracy, logika promptów | jednorazowe akcje deterministyczne | logika rozgałęziona, cokolwiek probabilistycznego |
Komponują się. Skill może wywołać narzędzie MCP przez allowed-tools. Hook może się wyzwolić po zakończeniu skilla. Subagent może korzystać z skilli, do których dano mu dostęp. Najczystszy model mentalny: najpierw wybierz właściwą warstwę, potem pozwól im się nakładać. Skills to prymityw inżynierii kontekstu, po który sięgasz, gdy chcesz przepływ pracy, który Claude może wybrać; automatyzujesz za pomocą hooks, gdy chcesz czegoś, czego Claude nie może pominąć.
Najgorszy sposób na niewłaściwe użycie każdego z nich: Skills do danych na żywo (użyj MCP); MCP do jednorazowych szablonów promptów (użyj Skills); subagenci do deterministycznych edycji plików (użyj hooks); hooks do logiki rozgałęzień (użyj Skills). Skills to przepływy pracy, MCP to dane, subagenci to plany, hooks to zdarzenia. Wybieraj według warstwy, a nie modnego słowa.
Gdzie mieszkają Skills: osobiste, projektowe, pluginowe, korporacyjne
Skills Claude instalują się w czterech zakresach: osobistym (~/.claude/skills/, tylko dla Ciebie), projektowym (.claude/skills/ w katalogu głównym repozytorium, dla zespołu przez git), pluginowym (dystrybuowane przez Anthropic Marketplace lub dowolny URL pluginu) oraz korporacyjnym (wdrażane przez IT za pomocą MDM/polityki administracyjnej). Claude skanuje wszystkie cztery przy uruchomieniu.
| Zakres | Ścieżka | Udostępnianie | Najlepsze do |
|---|---|---|---|
| Osobisty | ~/.claude/skills/ | nieudostępniany | własne codzienne przepływy pracy (commit, review, PR-write) |
| Projektowy | .claude/skills/ (katalog główny repo) | git, każdy współtwórca repozytorium | konwencje zespołowe, wzorce specyficzne dla bazy kodu |
| Pluginowy | instalowany przez /plugin install <url> | Anthropic Marketplace lub URL | wielokrotne użycie między repozytoriami, dystrybucja do społeczności |
| Korporacyjny | wdrażany przez administratora organizacji (zarządzane ustawienia) | egzekwowany w całej organizacji | przepływy pracy wymagane przez compliance, narzędzia z blokadą bezpieczeństwa |
| Wbudowany (wbudowane) | dostarczany z Claude Code | nd. | skills dokumentowe (pdf, docx, pptx, xlsx), /debug, /simplify |
Wbudowane skills dokumentowe łatwo przeoczyć — Claude Code już fabrycznie zawiera skills pdf, docx, pptx i xlsx, a do tego niewielką bibliotekę wbudowanych poleceń takich jak /debug, /simplify i podobne. (Siostrzane narzędzie Claude Design dostarcza własne wbudowane skills przepływów pracy do generowania projektów; ten sam model, inna domena.)
Kiedy warto dystrybuować przez plugin zamiast przez projekt? Pluginy wygrywają, gdy ten sam przepływ pracy przydaje się w wielu repozytoriach — skill /release, którego używasz w pięciu bazach kodu klientów, powinien być pluginem, a nie kopiowany do .claude/skills/ każdego repozytorium. Skills projektowe wygrywają w przypadku konwencji specyficznych dla bazy kodu (szablon PR Twojego zespołu, własny runner testów). Anthropic Marketplace oraz /plugin install z dowolnego URL sprawiają, że pluginy są właściwym rozwiązaniem dla wielokrotnego użycia między repozytoriami. Zgodnie z dokumentacją pluginów, wykrywanie i aktualizacje są obsługiwane automatycznie.

Zaawansowane wzorce: $ARGUMENTS, dynamiczne wstrzykiwanie powłoki, context: fork
Najważniejsze są trzy zaawansowane wzorce umiejętności: $ARGUMENTS pozwala użytkownikom przekazywać parametry do umiejętności wywoływanych przez użytkownika (/translate $ARGUMENTS); dynamiczne wstrzykiwanie powłoki (z allowed-tools: Bash(...)) umożliwia umiejętności uruchamianie skryptów i przekazywanie wyników do kontekstu; natomiast context: fork (Skills 2.0) uruchamia umiejętność w izolowanym oknie kontekstu. Biała księga Complete Guide od Anthropic jest kanonicznym źródłem informacji o context: fork według stanu na maj 2026 roku.
$ARGUMENTS dla sparametryzowanych umiejętności
---
name: Translate
description: Translate the most recent message into the target language.
user-invocable: true
argument-hint: <target-language, e.g. spanish, japanese, brazilian portuguese>
---
Translate the user's previous message into $ARGUMENTS. Preserve tone,
preserve markdown formatting, return only the translation.Przykładowy prompt: /translate spanish. Claude w czasie wykonania podmienia spanish w miejsce $ARGUMENTS. Najczystszy sposób na uczynienie umiejętności wielofunkcyjną bez pisania wariantów.
Dynamiczne wstrzykiwanie powłoki przez allowed-tools
---
name: Review last commit
description: Use when the user wants a code review of the last git commit.
allowed-tools: ["Bash(git diff HEAD~1:*)", "Bash(git log -1:*)"]
---
Run `git diff HEAD~1` and `git log -1`. Review the diff for bugs, security
issues, and style violations. Output a 5-bullet review.Skill wywołuje powłokę, przekazuje diff przez potok do kontekstu i go analizuje. Ogranicz allowed-tools do konkretnych poleceń (Bash(git diff HEAD~1:*)), nigdy do samego Bash — uprawnienie do gołego Bash to wersja tego wzorca, w której łatwo strzelić sobie w stopę pod kątem bezpieczeństwa.
context: fork (Skills 2.0)
---
name: Deep research
description: Use when the user wants a multi-source research summary on a topic.
context: fork
---
Research the topic in $ARGUMENTS using available web tools. Produce a
2-page summary with citations. Do not pollute the main thread.Forkowanie daje skillowi własne okno kontekstu, dzięki czemu 50 tysięcy tokenów pośrednich notatek z badań nie przenika do Twojej głównej sesji. Przydatne przy długich badaniach, planowaniu dużych refaktoryzacji lub w każdym przypadku, który generuje dużo jednorazowych tokenów. Tylko w Skills 2.0 — starsze wersje Claude Code ignorują to pole.
Rozwiązywanie problemów: dlaczego Twoja umiejętność się nie uruchamia
Umiejętności zwykle nie uruchamiają się z jednego z czterech powodów: (1) pole description jest zbyt ogólne, aby Claude mógł dopasować je do Twojego promptu, (2) katalog znajduje się w niewłaściwej ścieżce (.claude/skills/ zamiast claude/skills/), (3) Claude Code nie został ponownie uruchomiony po dodaniu umiejętności (dotyczy tylko wersji sprzed Skills 2.0) lub (4) nazwa umiejętności jest w konflikcie z umiejętnością wbudowaną lub o wyższym priorytecie. Zgodnie z najczęściej wyszukiwanymi w Google trybami awarii w trackerze zgłoszeń Claude Code na GitHubie, te cztery przyczyny odpowiadają za około 95% zgłoszeń typu „dlaczego to nie działa".
Tryb awarii 1: „Mój skill w ogóle się nie pojawia”
Najczęstszą przyczyną jest błędna ścieżka — .claude/skills/ (z kropką) vs claude/skills/ (bez kropki) to literówka, którą każdy z nas popełnił o 1 w nocy. Uruchom ls -la ~/.claude/skills/, aby potwierdzić, że katalog istnieje i ma kropkę w nazwie. Jeśli istnieje, a Claude nadal go nie widzi, uruchom ponownie Claude Code. Wersje sprzed Skills 2.0 skanują katalogi tylko przy starcie.
Tryb awarii 2: „Claude nie wywołuje automatycznie mojego skilla”
Pole description jest zbyt ogólne lub napisane dla ludzi, a nie dla Claude’a. Przepisz je, używając konkretnych fraz wyzwalających, które odzwierciedlają sposób, w jaki użytkownicy faktycznie formułują swoje prośby. Po zbudowaniu 4 skilli dla tego repo pułapką, w którą wpadłem, było zostawianie opisów w stylu „Przydatny skill do SEO.” Bezużyteczne. Przepisz na: „Użyj, gdy użytkownik chce dodać schemat JSON-LD, meta tagi lub frontmatter SEO do posta w Markdownie.” Trafność wyzwalania wzrosła z ok. 30% do ok. 95%. Trafność wyzwalania stoi lub leży w polu description. Pisz je dla Claude’a, nie dla swojego CV.
Tryb awaryjny 3: „Opis został obcięty w palecie poleceń slash”
Albo Twoje description przekracza 1024 znaki, albo Twoje name przekracza 64 znaki. Oba pola mają sztywne limity. Rozwiązanie: podziel skill na dwa węższe albo przenieś rozbudowane szczegóły do treści pliku SKILL.md. Frontmatter służy do routingu, a nie do dokumentacji.
Tryb awarii 4: „Wykrywanie zmian na żywo nie działa”
Claude Code sprzed wersji Skills 2.0 wymaga pełnego restartu po każdej edycji pliku SKILL.md. Jeśli iterujesz nad skillem, a Twoje zmiany nie są uwzględniane, prawdopodobnie korzystasz ze starszej wersji. Albo zaktualizuj Claude Code do wersji zawierającej Skills 2.0 (wykrywanie na żywo), albo przyzwyczaj się do restartowania po każdym zapisie. Irytujące, ale tanie.
Umiejętności poza Claude: Otwarty standard Agent Skills
Tak, umiejętności to otwarty standard. Standard Agent Skills dostępny pod adresem agentskills.io definiuje format SKILL.md niezależnie od jakiegokolwiek dostawcy. Codex CLI od OpenAI i ChatGPT Desktop przyjęły ten standard w grudniu 2025 roku; ten sam plik SKILL.md, który piszesz dla Claude Code, działa w Codex po niewielkich modyfikacjach frontmatteru.
Oto macierz wsparcia między narzędziami według stanu na maj 2026 roku: Claude Code ma pełne wsparcie dla Agent Skills (implementacja referencyjna). Codex CLI od OpenAI ma pełne wsparcie. ChatGPT Desktop ma częściowe wsparcie — name, description i treść działają, ale pełna zgodność allowed-tools nie została jeszcze osiągnięta. Gemini CLI ogłosiło wsparcie na początku 2026 roku, ale w momencie pisania tego tekstu jeszcze go nie udostępniło. Cursor stanowi wyjątek — używa własnego formatu Cursor rules i nie czyta natywnie plików SKILL.md, choć istnieją shimy tworzone przez społeczność.
Co pisać już dziś, aby Twoje umiejętności przetrwały ten rok: utrzymuj pola name i description w czystej, niezależnej od narzędzia formie. Jeśli celujesz w wiele narzędzi, izoluj frontmatter specyficzny dla dostawcy w przestrzeni nazw (claude: lub codex:). Przenośna warstwa — name, description, treść, $ARGUMENTS — działa wszędzie; zaawansowane pola, takie jak context: fork, pozostają specyficzne dla Claude, dopóki inni dostawcy nie udostępnią odpowiedników. Anthropic dąży również do głębszej integracji z marketplace'em, zgodnie z ujawnioną mapą drogową Claude Code, więc przenośność będzie stawać się coraz łatwiejsza.
Trzy miejsca, w których warto szukać przykładowych umiejętności: anthropics/skills (oficjalne), awesome-claude-skills (społecznościowe) oraz agentskills.io (strona ze specyfikacją standardu). Umiejętności nie są już funkcją Claude. To otwarty standard, który Claude wdrożył jako pierwszy.
Często zadawane pytania
Czym różni się umiejętność Claude od serwera MCP?
Umiejętność Claude to plik SKILL.md zawierający instrukcje przepływu pracy, który Claude wczytuje, gdy Twój prompt pasuje do jego opisu. Serwer MCP to osobny proces, który Claude wywołuje, aby pobrać dane na żywo (bazy danych, API, systemy plików wykraczające poza katalog roboczy). Używaj Skills do przepływów pracy, a MCP do danych. Można je łączyć — umiejętności (skills) mogą wywoływać narzędzia MCP.
Czy Claude Skills są darmowe?
Tak, Skills to wbudowana funkcja Claude Code — bez dodatkowych opłat. Płacisz jedynie za tokeny modelu zużyte podczas działania umiejętności. Umiejętności instalowane z Anthropic Marketplace mogą być płatne (obecnie to rzadkość), ale oficjalne repozytorium anthropics/skills oraz społecznościowe awesome-listy są całkowicie darmowe i można je swobodnie kopiować oraz wykorzystywać.
Gdzie instalowane są umiejętności Claude?
Umiejętności osobiste trafiają do ~/.claude/skills/{skill-name}/, a umiejętności projektu do .claude/skills/{skill-name}/ w katalogu głównym repozytorium. Umiejętności wtyczek instaluje się poleceniem /plugin install <url> i są one przechowywane w katalogu wtyczek. Umiejętności enterprise są wdrażane przez dział IT Twojej organizacji za pośrednictwem zarządzanych ustawień. Claude Code przy uruchamianiu skanuje wszystkie cztery zakresy.
Jak utworzyć umiejętność Claude od podstaw?
Utwórz folder w ~/.claude/skills/, dodaj plik SKILL.md z frontmatterem YAML (name, description), a następnie instrukcjami dotyczącymi przebiegu pracy, i uruchom ponownie Claude Code. Najszybszy sposób: otwórz Claude Code i poproś o wywołanie wbudowanej umiejętności skill-creator — w mniej niż minutę wygeneruje dla Ciebie szkielet pliku SKILL.md.
Dlaczego mój skill Claude się nie uruchamia?
Cztery najczęstsze przyczyny: (1) description jest zbyt ogólny, aby Claude mógł dopasować go do Twojego promptu — przepisz go, używając konkretnych fraz wyzwalających; (2) skill znajduje się w niewłaściwej ścieżce (powinien być w .claude/skills/, a nie claude/skills/); (3) w wersjach Claude Code sprzed Skills 2.0 wymagany jest restart; (4) nazwa skillu koliduje z wbudowanym skillem. Zweryfikuj to za pomocą ls -la ~/.claude/skills/.
Czy ChatGPT lub Cursor mogą korzystać z umiejętności Claude?
ChatGPT Desktop i Codex CLI obsługują ten sam standard Agent Skills co Claude — ten sam plik SKILL.md działa w obu środowiskach, wymagając jedynie drobnych zmian w nagłówku frontmatter. Cursor korzysta z własnego formatu Cursor rules i nie odczytuje natywnie plików SKILL.md. Gemini CLI ogłosiło wsparcie na początku 2026 roku, ale do maja 2026 roku nie zostało ono jeszcze wdrożone.
Czym jest umiejętność skill-creator?
skill-creator to metaumiejętność dołączona do repozytorium anthropics/skills, która pomaga Claude tworzyć dla Ciebie nowe pliki SKILL.md. Powiedz Claude, co ma robić dana umiejętność, a skill-creator przeprowadzi z Tobą wywiad dotyczący opisu, wybierze rozsądne allowed-tools i zapisze plik SKILL.md we właściwym folderze. Najszybszy możliwy szkielet.
Co robi disable-model-invocation?
Ustawienie disable-model-invocation: true w frontmatterze Twojego skilla uniemożliwia Claude automatyczne uruchamianie go na podstawie dopasowania promptu. Skill staje się wtedy wywoływalny wyłącznie przez użytkownika — pojawia się w palecie komend ukośnikowych jako /skill-name i działa tylko wtedy, gdy zostanie jawnie wywołany. Używaj go w przypadku destrukcyjnych lub deterministycznych akcji, takich jak /commit czy /deploy.
Zbuduj kilka skilli, wdróż je w projekcie i zobacz, co się przyjmie. Jeśli Twój zespół napotyka w wielu repozytoriach na całą serię pułapek typu „skill się nie uruchamia" i chcesz, żeby ktoś z zewnątrz rzucił okiem na Waszą konfigurację .claude/skills/, odezwij się — chętnie przejdziemy przez to razem.