Skills, subagenci, MCP i wtyczki w Claude Code: co wybrać

Obecnie w Claude Code istnieje pięć sposobów na wykonanie tego samego przeglądu kodu: polecenie slash, skill, subagent, wtyczka albo po prostu prompt na czacie. Żaden z tych sposobów nie jest domyślnie lepszy od pozostałych — wybór zależy od zadania, budżetu tokenów i od tego, kto poza tobą będzie z niego korzystać.

Ten poradnik to coś, co sam chciałbym dostać rok temu. Drzewo 4 pytań, gotowa macierz „zadanie → warstwa” i 5 częstych błędów, które marnują tokeny u co drugiego vibe codera, z którym pracuję.

Informacje o pracy z usługą znajdziesz w dokumentacji Ailoot.

Czym są skills, subagenci, MCP i wtyczki — w jednym zdaniu?#

Zanim dokonasz wyboru, rozróżnijmy te pojęcia. Wszystkie cztery warstwy mają jeden cel — rozszerzyć to, co Claude potrafi od razu. Każda z nich ma jednak własną naturę.

Skill to katalog z plikiem SKILL.md, który opisuje, kiedy i jak stosować określoną metodykę. Anthropic porównuje skill do instrukcji dla nowego pracownika: nie dyktujesz mu codziennie każdego kroku, tylko dajesz procedurę.

Subagent to osobna sesja Claude’a z własnym kontekstem, uruchamiana z głównej rozmowy. Ma jedną kluczową cechę: izolację. Subagent może przeczytać 30 plików, przygotować podsumowanie i przekazać głównemu czatowi tylko je. Kontekst głównej rozmowy pozostaje czysty.

MCP (Model Context Protocol) to otwarty standard Anthropic służący do łączenia Claude’a z zewnętrznymi systemami. W poście na blogu z 13 listopada 2025 roku Anthropic wyjaśnił tę różnicę najjaśniej, jak to możliwe:

Wtyczka to gotowy zestaw skills, subagentów, hooków i poleceń przygotowany przez kogoś innego i udostępniany na marketplace. Zainstaluj ją jedną linijką za pomocą /plugin install, a od razu dostaniesz wszystko. Jeśli skill jest twoją własną procedurą, wtyczka jest procedurą kupioną od innej firmy.

Krótko mówiąc: skills to przepisy, subagenci to wyspecjalizowani współpracownicy, a MCP udostępnia zewnętrzne narzędzia, dzięki którym Claude może łączyć się z usługami i danymi. Koszt tokenów jest różny: skill jest najtańszy (ładuje się po uruchomieniu), a MCP znacznie droższy (każdy podłączony serwer stale zajmuje miejsce w oknie kontekstu).

Po co 4 warstwy, skoro można użyć jednego CLAUDE.md?#

W opisanym projekcie CLAUDE.md to obszerna mapa zasad: gdzie umieszczać różne rzeczy, jak publikować i jakie ustalenia obowiązują. Bez tego pliku Claude zaczynałby każdą nową sesję od zera.

CLAUDE.md ma jednak swoje granice. Wyjaśnię to na trzech sytuacjach, w których przestaje działać.

Sytuacja 1: zasada działa tylko czasami. CLAUDE.md mówi: „zawsze uruchamiaj npm run build przed git push”. Claude czyta to na początku sesji, przytakuje, po 25 wiadomościach zaczyna pisać kod i zapomina. Już trzy razy zdarzyło mi się wypchnąć zmiany bez builda; te pushe nie powiodły się na produkcji. Poprawnie skonfigurowany i przetestowany hook może wykonać deterministyczne sprawdzenie builda i odrzucić objętą nim operację. Zakres zależy od zdarzenia i ścieżki narzędzia: hook Claude Code sam nie przechwytuje każdego pusha z innego terminala lub aplikacji. Sprawdź, czy celowo nieudany build blokuje rzeczywistą używaną ścieżkę.

Sytuacja 2: powtarzający się proces z 15 krokami. W opisanym przykładzie każdy poradnik przechodzi 14 etapów: research → struktura → MDX → 7 równoległych kontroli QA → publikacja na produkcji → IndexNow. Gdybym za każdym razem pisał prompt „wykonaj etap 1, potem 2, a następnie 3”, zużywałbym tokeny, zanim w ogóle zacząłbym pracę. Dlatego cały przepływ pracy jest spakowany w skillu build-masterskaya-guide — zestawie instrukcji o rozmiarze 34 KB uruchamianym frazą „zróbmy nowy poradnik dla projektu”.

Sytuacja 3: zadanie pochłania kontekst. Aby sprawdzić aktualność opublikowanego już poradnika, Claude musi przeczytać transkrypcję transmisji na żywo o rozmiarze 30 KB, 20 retrospektyw po 5 KB każda i porównać je z obecną stroną. Jeśli zrobię to na głównym czacie, pod koniec przeglądu będę mieć w kontekście 200K tokenów śmieci. Subagent wykonuje tę samą pracę, przekazuje głównej rozmowie tylko 300-słowne podsumowanie i kończy działanie.

Sytuacja 4: chcę, by zespół dostał te same szablony co ja. Gotowy zestaw zasad projektowania frontendowego, hooki do publikowania przez Coolify, MCP do kontroli za pomocą Playwrighta. To wtyczka: pakuję własną konfigurację, publikuję ją na marketplace, a współpracownik instaluje ją jedną linijką.

CLAUDE.md obejmuje podstawy: „jak u nas pracujemy”. Pozostałe 4 warstwy rozwiązują problemy, z którymi CLAUDE.md fizycznie sobie nie poradzi: powtarzanie przez wyzwalacze, izolację kontekstu, dostęp do świata zewnętrznego i udostępnianie.

Kiedy potrzebujesz skillu zamiast CLAUDE.md?#

Test na potrzebę skillu jest prosty: łapiesz się na tym, że kopiujesz ten sam długi prompt z notatek do czatu. Trzeci raz to już sygnał.

Obecnie mam 7 katalogów w ~/.claude/skills/: build-masterskaya-guide, build-vc-spoke, build-reel-script, build-practicum-instruction, update-config, simplify i keybindings-help. Najczęściej używam build-masterskaya-guide (ten poradnik powstał z jego pomocą). W środku jest 34 KB metodyki: jakie etapy przejść, które wieloagentowe kontrole QA uruchomić, jakie warunki kontrolne mają zatrzymać proces i które artefakty zapisać w /tmp/.

Kiedy nie tworzyć skillu.

• Zasada taka jak „odpowiadaj w języku preferowanym przez użytkownika” należy do CLAUDE.md, a nie do skillu. Skill ładuje się po uruchomieniu, ale ta zasada powinna obowiązywać zawsze.
• Jednorazowe polecenie, takie jak „wykonaj teraz refaktoryzację”, należy umieścić na czacie, a nie w skillu.
• Zadanie wymagające osobnego kontekstu może używać subagenta; jeśli stosuje też powtarzalną procedurę, zachowaj tę metodykę w skillu.

Główny antywzorzec. Najczęstszym błędem vibe coderów jest upychanie procedury w subagencie, choć powinna znaleźć się w skillu. Subagent kosztuje więcej tokenów (ma własny kontekst), uruchamia się wolniej i często jest przesadą. Jeśli zadanie mieści się w 1 500–2 000 słowach opisu metodyki i nie wymaga czytania zewnętrznych plików, powinno być skillem.

Jak zbudować skill, co umieścić w frontmatterze i jakie frazy wyzwalające działają — o tym przeczytasz w poradniku Claude Code Skills in 2026: How to Build a Personal Skills Library.

Kiedy potrzebujesz subagenta zamiast skillu?#

Skill przechowuje metodykę, a subagent wykonuje pracę. To różne warstwy, często mylone, bo obie uruchamia się „z czatu”.

Subagent ma sens wyłącznie w celu odizolowania kontekstu. Sesja główna Claude’a ma budżet 200 000 tokenów (albo 1 milion w wersji beta). Jeśli poprosisz go na głównym czacie o przeczytanie 30 plików i przeanalizowanie każdego, zużyjesz połowę okna na czytanie materiałów pośrednich. Subagent wykonuje tę samą pracę w osobnej sesji i zwraca głównemu czatowi tylko wynik.

Konkretny przykład z projektu. Każdy poradnik przechodzi kilka równoległych kontroli QA: styl, cytaty i fakty porównane ze źródłami pierwotnymi, strukturę pod kątem wyszukiwarek oraz integralność linków wewnętrznych i zewnętrznych. Każda kontrola korzysta z własnego kontekstu: glosariusza zasad, WebFetch do dziesiątek adresów URL i grepów w tekście.

Gdybym przeprowadzał wszystkie te kontrole w jednym czacie, kontekst pochłonąłby mnie, zanim skończyłaby się pierwsza z nich. Uruchamianie subagentów równolegle z run_in_background: true rozwiązuje problem: pracują w tle, główny czat zajmuje się dalszą pracą, a po 4–6 minutach dostaję zwięzłe raporty i wprowadzam zmiany.

Drugi przykład — ciężki research. Kiedy wybieram temat nowego poradnika, 4 subagentów równolegle zbiera sygnały:

• V1 - fora i społeczności z ostatnich 14 dni
• V2 - sieci społecznościowe
• V3 - platformy wideo + blog Anthropic
• V4 - luki SEO

Każdy zwraca 30–40 pozycji z ocenami wirusowości. Zbieram je w zestaw, ważę według 9 wymiarów i wybieram zwycięzcę. Bez subagentów ten etap wydłużyłby się do 2–3 godzin i pochłonął główny kontekst.

Kiedy nie tworzyć subagenta.

• Zadanie, które nie wymaga czytania plików ani użycia WebFetch, należy wykonać w głównym czacie.
• Powtarzalna procedura należy do skilla, ale może działać wewnątrz subagenta, gdy przydaje się izolacja.
• Dostęp zewnętrzny wymaga uprawnionego narzędzia, np. MCP lub CLI; subagent może z niego korzystać w delegowanym zadaniu.

Główny antywzorzec. Tworzenie subagenta o nazwie backend-engineer albo qa z nadzieją, że Claude sam zrozumie, kiedy go używać. Konkretne subagenty (takie jak migration-test-writer lub api-route-reviewer) zapewniają znacznie lepszą jakość niż ogólne. Im precyzyjniejsza nazwa i instrukcje subagenta, tym trafniej Claude go wybierze.

Jak tworzyć subagentów do konkretnych zadań, składnia frontmattera i 5 gotowych przykładów — w poradniku Claude Code Subagents in 2026: A Step-by-Step Guide.

Kiedy potrzebujesz MCP zamiast skillu lub subagenta?#

Anthropic podał najkrótszą formułę różnicy w poście na blogu: MCP łączy Claude’a z danymi, a skills uczą Claude’a, co robić z tymi danymi.

Na przykład skill przeglądu zgłoszeń GitHub potrzebuje ich treści. Dostarcz ją uprawnionym narzędziem MCP, CLI lub jako przekazany tekst. Skill określa następnie sposób przeglądu i strukturę ustaleń; sam dostęp MCP nie narzuca procedury.

Mój konkretny zestaw MCP.

• Playwright MCP - wizualna kontrola QA każdego poradnika. Otwieram stronę na komputerze i urządzeniu mobilnym, sprawdzam szerokość kontenera oraz to, czy bloki zostały wyrenderowane.
• Stitch MCP - dostęp do systemu projektowego i generowanie komponentów w stylu marki.
• vidIQ MCP - analiza trendów i sprawdzanie wirusowości pomysłów.
• Railway MCP - zarządzanie infrastrukturą wdrożeniową.

Każdy z tych 4 elementów jest mostem do zewnętrznego systemu. Bez MCP musiałbym napisać własny kod pośredniczący albo przełączyć się na przeglądarkę. Z MCP wszystko odbywa się w sesji Claude’a.

Koszt tokenów. MCP to najdroższa warstwa. Każdy podłączony serwer stale zajmuje miejsce w oknie kontekstu: deklaracje narzędzi, schematy argumentów i opisy. Mam 4 serwery MCP — to około 8–12K tokenów w każdej nowej sesji, zanim zdążę zadać jakiekolwiek pytanie.

Oznacza to, że podłączamy MCP tylko wtedy, gdy jest rzeczywiście potrzebny w większości sesji. Jeśli używasz Sentry MCP raz w tygodniu, lepiej włączać go na żądanie flagą --mcp sentry, zamiast trzymać go na stałe na liście.

Kiedy nie używać MCP.

• Metodyka „pracy z danymi” należy do skillu, a nie do MCP.
• Długie zadanie czytania może skorzystać z subagenta; jeśli część plików lub rekordów jest zewnętrzna, ten subagent może też potrzebować MCP.
• Publikowanie jednym poleceniem wymaga hooka lub wtyczki, a nie MCP.

Główny antywzorzec. Budowanie serwera MCP do czegoś, co lepiej obsłuży skill. Widziałem taki przykład w dyskusji na HN (tym samym wątku, który 27 maja miał 422 punkty): autor napisał serwer MCP udostępniający „instrukcje przeglądu kodu”. To jednak nie jest dostęp do świata zewnętrznego, tylko procedura. Skill robi to samo, zużywając 10 razy mniej tokenów.

Incydent związany z konkurencją o zasoby. Kiedyś Playwright MCP zawiesił się z błędem „Browser is already in use” — miałem wtedy otwarte okno Chrome i MCP nie mógł przejąć kontroli nad przeglądarką. To ważna lekcja: serwer MCP korzysta ze współdzielonych zasobów systemowych. Jeśli zasób jest zajęty przez kogoś innego (przeglądarka, port lub plik), od początku pomyśl o izolacji.

Gotowy poradnik podłączania 7 działających MCP znajdziesz w Claude Code MCP Servers in 2026: 7 Ready-to-Use Setups.

Kiedy potrzebujesz wtyczki zamiast skillu lub subagenta?#

Skills, subagenci i MCP dotyczą twojej metodyki. Wtyczka to gotowa metodyka kogoś innego, którą importujesz do swojej konfiguracji.

W październiku 2025 roku Anthropic uruchomił Claude Code Plugins, oficjalny mechanizm dystrybucji. Wtyczka to katalog, który może zawierać:

• własne polecenia slash
• własne skills
• własnych subagentów
• własne hooki
• własne konfiguracje MCP
• własne style wyjściowe

Wszystko to jest pakowane w jeden zestaw z plikiem plugin.json. Instalacja wymaga jednej linijki w ~/.claude/settings.json albo polecenia /plugin install <name>.

Mój konkretny zestaw wtyczek.

• frontend-design z oficjalnego claude-plugins-official — 67 stylów, 96 palet, 57 par czcionek i 13 frameworków. Kiedy tworzę nowy blok na stronie albo szablon e-maila, ładuję tę wtyczkę i od razu dostaję całą bibliotekę.
• playwright z tego samego oficjalnego marketplace — zestaw skills i konfiguracji MCP do testowania w przeglądarce.
• telegram — gotowy zestaw do zarządzania kontem Telegram z Claude Code (zasady, allowlist, parowanie).
• trailofbits/skills — zestaw skills związanych z bezpieczeństwem od Trail of Bits, firmy, której ufam w kwestiach bezpieczeństwa.

Wszystkie 4 to trzy linijki w settings.json. Bez wtyczek spędziłbym wiele godzin na ręcznym budowaniu tej samej biblioteki.

Kiedy nie używać wtyczki.

• Jeśli metodyka jest w całości twoja i nie będzie używana na większą skalę przez innych, pozostaw ją jako skill.
• Jeśli jeszcze nie wiesz, kto będzie z niej korzystać, najpierw wypróbuj ją samodzielnie jako skill.
• Jeśli chcesz szybko umieścić trzy pliki na nowej maszynie, wystarczy cp ~/.claude/skills/X /new/machine/.claude/skills/.

Główny antywzorzec. Używanie wtyczki jako zamiennika CLAUDE.md — na przykład wtyczki zawierającej zasady „jak pracujemy w tym projekcie”. Wtyczki są przeznaczone do dystrybucji i ponownego użycia. Jeśli zasady dotyczą tylko jednego repozytorium, należą do CLAUDE.md, a nie do wtyczki.

Patrząc w stronę 2026 roku: Anthropic wyraźnie zmierza w kierunku marketplace’u wtyczek dla zespołów. Firmy będą mogły publikować swoje wewnętrzne metodyki jako wtyczki, wersjonować je i aktualizować wszystkim pracownikom jednym poleceniem. Dla soloprzedsiębiorcy oznacza to: instaluj gotowe rozwiązania i nie wymyślaj koła na nowo.

Drzewo decyzyjne: 4 pytania, które warto zadać przed każdym zadaniem#

Pytanie 1: czy istnieje powtarzalna procedura warta zachowania?

Jeśli tak, zapisz metodykę jako skill w SKILL.md z jasnym opisem zastosowania. Dostarcza procedurę, ale sam nie daje dostępu zewnętrznego ani osobnego kontekstu.

Pytanie 2: czy praca potrzebuje osobnego kontekstu lub skupionej delegowanej roli?

Jeśli tak, użyj subagenta. Przydziel dokładne zadanie i narzędzia. To samo zadanie może stosować metodykę skilla wewnątrz izolowanego kontekstu.

Pytanie 3: czy zadanie potrzebuje narzędzia lub dostępu do danych zewnętrznych?

Jeśli tak, zapewnij uprawniony dostęp przez MCP lub inne właściwe narzędzie, np. już skonfigurowane CLI. Skill opisuje użycie tego dostępu; subagent może być wykonawcą korzystającym z narzędzia.

Pytanie 4: czy konfigurację należy rozpowszechniać i utrzymywać jako pakiet?

Jeśli tak, użyj wtyczki do dystrybucji skills, definicji agentów, hooks lub konfiguracji MCP. Pakiet może być własny lub innego autora.

Przykład połączenia: cykliczny przegląd zgłoszeń GitHub. Skill określa procedurę i format wyniku. Skonfigurowane GitHub MCP lub CLI zapewnia uprawniony dostęp do zgłoszeń. Subagent może przeczytać długi wątek we własnym kontekście i zwrócić ustalenia. Wtyczka może rozprowadzać ten zestaw w zespole. Wszystkie cztery odpowiedzi mogą brzmieć „tak”; żadna nie unieważnia innej.

5 błędów wyboru warstwy, które popełniają vibe coderzy#

Co tydzień widzę te 5 wzorców u vibe coderów, z którymi pracuję. Co druga osoba popełnia przynajmniej jeden z nich w pierwszym tygodniu.

Błąd 1: subagent zamiast skillu.

Objaw: autor stworzył subagenta do „pisania nowego wpisu na blogu”. Za każdym razem, gdy uruchamia subagenta, ten ładuje się, czyta 2 KB metodyki, generuje wpis i kończy działanie. Po tygodniu autor zauważa, że każde uruchomienie kosztuje dodatkowe 5K tokenów na załadowanie subagenta.

Co powinno się wydarzyć: „jak napisać wpis” to metodyka — czyli skill. Wyzwalaczem jest fraza „nowy wpis na blogu”. Skill ładuje się do głównego czatu i nie otwiera osobnej sesji. Jest 3–5 razy tańszy.

Błąd 2: serwer MCP zamiast skillu.

Objaw: autor napisał serwer MCP udostępniający instrukcje dotyczące tego, „jak przeprowadzić przegląd kodu”. Deklaracje narzędzi, opisy schematów argumentów i dokumentacja stale zajmują miejsce w kontekście. Każde zapytanie marnuje 2–3K tokenów.

Co powinno się wydarzyć: „jak przeprowadzić przegląd kodu” to procedura, a nie dostęp do zewnętrznego systemu. Użyj skillu. MCP jest uzasadnione tylko wtedy, gdy potrzebujesz aktywnego dostępu — na przykład do Sentry, żeby pobrać najnowsze błędy.

Błąd 3: wtyczka zamiast CLAUDE.md.

Objaw: autor spakował zasady projektu („zawsze używaj trybu strict TypeScript”, „nie używaj żadnych kresek”, „używaj wyłącznie pnpm, nie npm”) w wtyczkę i ją zainstalował. Teraz każda nowa sesja ładuje wtyczkę, która dubluje to, co powinno znaleźć się w CLAUDE.md.

Co powinno się wydarzyć: zasady jednego projektu należą do pliku CLAUDE.md tego projektu. Wtyczka jest przeznaczona dla metodyki, którą można skalować na wiele osób lub repozytoriów.

Błąd 4: próba utworzenia skillu przez hook.

Objaw: autor zauważył, że hook uruchamia się automatycznie przy zdarzeniu (na przykład przed zapisaniem pliku). Postanowił zrobić „skill przez hook”, aby Claude automatycznie stosował metodykę przy każdej edycji. Doprowadziło to do niekończącej się pętli wyzwalania, zużycia kontekstu i nieprzewidywalnego działania.

Co powinno się wydarzyć: hook to deterministyczny kod, który uruchamia polecenie, formatuje wynik albo blokuje operację. Hook nie ładuje skillu ani nie wywołuje Claude’a. Jeśli chcesz „zawsze stosować metodykę X”, użyj skillu z wyzwalaczem albo wpisu w CLAUDE.md.

Błąd 5: dodatkowa warstwa, choć w ogóle nie jest potrzebna.

Objaw: autor słyszy o skills, czyta poradniki, postanawia „muszę spakować tę metodykę” i spędza wieczór na tworzeniu skillu do zadania, które pojawia się raz w miesiącu.

Co powinno się wydarzyć: jednorazowe zadanie należy wykonać doraźnie na czacie. Skill jest uzasadniony tylko wtedy, gdy robisz to częściej niż raz dziennie. W przeciwnym razie to nadmierne komplikowanie, które potem trzeba utrzymywać.

W tych przykładach sprawdzaj potrzeby niezależnie: procedurę, izolację kontekstu lub roli, dostęp narzędziowy i dystrybucję. Dodawaj warstwę o konkretnym celu; łącz je, gdy zadanie wymaga kilku.

Co Anthropic mówi o fragmentacji: dokąd zmierza Claude Code w 2026 roku#

Co to oznacza w perspektywie najbliższych sześciu miesięcy do roku?

Po pierwsze: skills stają się główną warstwą zadań proceduralnych. Anthropic wyraźnie stawia na tę warstwę jako najtańszą i najbardziej przewidywalną. Jeśli nie rozumiesz, po co w 2026 roku potrzebny jest skill, najpierw się z nim zapoznaj. Wszystkie pozostałe warstwy będą się wokół niego obracać.

Po drugie: subagenci stają się wyspecjalizowani. Główną rolą subagentów jest izolowanie kontekstu przy ciężkich zadaniach. Ogólne subagenty, takie jak qa-engineer, znikną; pozostaną konkretne, jak migration-test-writer i api-route-reviewer.

Po trzecie: nowe ogłoszenia Anthropic z ostatnich 14 dni — polecenie /workflows (28 maja 2026 roku) do orkiestracji dziesiątek subagentów oraz oddzielne rozliczanie Agent SDK od 15 czerwca — oznaczają, że użycie programistyczne przenosi się do osobnej puli. To sygnał, że Anthropic buduje infrastrukturę dla zautomatyzowanych systemów złożonych z 10+ agentów, a nie dla indywidualnych sesji.

Dla vibe codera w 2026 roku oznacza to jedną prostą rzecz: cztery warstwy pozostaną jeszcze przez co najmniej sześć miesięcy, a potem część się połączy. Drzewo decyzyjne z czterema pytaniami nadal będzie działać po połączeniu — dotyczy natury zadania, a nie konkretnej nazwy warstwy.

Gotowa macierz: 10 typowych zadań → właściwa warstwa#

Główna zasada korzystania z tej tabeli: nie próbuj „robić wszystkich 10 rzeczy naraz”. Większości vibe coderów pracujących samodzielnie wystarczy CLAUDE.md, 5–7 skills i 2–4 serwery MCP. Subagenci i wtyczki pojawiają się wraz z rozwojem projektu.

Co dalej: jak zbudować swoją przestrzeń roboczą w Claude Code#

Te pięć warstw nie układa się jedna po drugiej, lecz mieści się jedna w drugiej. CLAUDE.md stanowi fundament projektu, a pozostałe cztery dołącza się wraz ze wzrostem wymagań zadań.

Poznaj Ailoot.