Skille Matta Pococka: od grill-me do implement

Skille Matta Pococka (mattpocock/skills, licencja MIT) to zestaw małych Agent Skills zbudowanych wokół jednej zasady: najpierw uzgodnij z agentem, co budujecie, dopiero potem niech pisze kod. grill-me przepytuje cię, aż każda decyzja zostanie rozstrzygnięta, a to-spec, to-tickets, implement (z tdd) i code-review zamieniają to uzgodnienie w przetestowane, zrecenzowane commity. Działają w Claude Code, Codeksie i Cursorze.

Opisujesz funkcję w dwóch zdaniach, agent pisze 300 linii i dopiero w diffie widzisz, że zrozumiał coś innego. Ta strona jest dla programistów i tech leadów, którzy chcą wyłapać takie nieporozumienie w rozmowie, zanim powstanie kod, i którzy wolą recenzować specyfikację i testy niż każdą linię napisaną przez agenta.

Co daje łańcuch skilli Pococka

• Instalację dla każdego narzędzia, razem ze skillami towarzyszącymi, bez których grill-me i grill-with-docs nie działają.
• Pełny zapis sesji grill-me, żebyś wiedział, jak wygląda dobry wywiad, zanim zaczniesz własny.
• Sześciokrokowy workflow (pomysł, grillowanie, specyfikacja, tickety, implementacja, review) z artefaktem, który każdy krok zostawia do sprawdzenia.
• Cztery prompty do skopiowania i tabelę awarii ze sposobami wyjścia, łącznie ze skillami o zmienionych nazwach, które starsze artykuły wciąż polecają.

Jakie skille są w zestawie i co robi każdy z nich?

Skille dzielą się według jednego kryterium: kto może je uruchomić. Skille wywoływane przez użytkownika (disable-model-invocation: true w SKILL.md) działają tylko wtedy, gdy wpiszesz ich nazwę; to one orkiestrują pracę. Skille wywoływane przez model może też sięgnąć sam agent, gdy zadanie do nich pasuje; to w nich mieszka dyscyplina wielokrotnego użytku. Kilka skilli wywoływanych przez użytkownika to jednolinijkowi delegaci: grill-me zawiera tylko „Call the Skill tool with “grilling””, a grill-with-docs wywołuje grilling i domain-modeling.

Skill	Kto uruchamia	Co robi	Kiedy po niego sięgnąć
grill-me → grilling	ty	Przepytuje cię w rundach, do każdego pytania dodaje rekomendowaną odpowiedź, aż nie zostanie żadna otwarta decyzja	Nie umiesz jeszcze opisać zmiany w dwóch zdaniach, w kodzie czy poza nim
grill-with-docs → grilling + domain-modeling	ty	Ten sam wywiad, a do tego zapisuje ustalone pojęcia w GLOSSARY.md, a trudne decyzje w ADR-ach	Pracujesz w kodzie, którego słownictwo agent ciągle myli
to-spec	ty	Zamienia rozmowę w specyfikację w twoim issue trackerze, po potwierdzeniu z tobą miejsc testowania (seams). Nie zaczyna nowego wywiadu	Grillowanie się skończyło i chcesz trwałego zapisu
to-tickets	ty	Dzieli specyfikację na tickety w postaci pionowych plastrów z zależnościami blokującymi, każdy na jedno świeże okno kontekstu	Specyfikacja jest zatwierdzona
implement	ty	Buduje specyfikację albo ticket, uruchamia tdd w uzgodnionych miejscach, potem code-review, a na koniec commituje do bieżącej gałęzi	Ticket jest gotowy dla agenta
tdd	agent albo ty	Red-green-refactor, jeden pionowy plaster naraz	Każda zmiana, którą da się przetestować
code-review	agent albo ty	Recenzuje diff od ustalonego punktu na dwóch osiach, Standards i Spec, w dwóch równoległych subagentach	Przed otwarciem albo zmergowaniem PR-a
diagnosing-bugs (dawniej diagnose)	agent albo ty	Buduje pętlę, która świeci na czerwono dla tego błędu, potem minimalizuje, stawia hipotezy, instrumentuje, naprawia i dodaje test regresji	Trudny błąd albo regresja wydajności
improve-codebase-architecture	ty	Przegląda kod w poszukiwaniu „okazji do pogłębienia” modułów, pokazuje je jako raport HTML i grilluje cię z tej, którą wybierzesz	Co kilka dni w kodzie intensywnie edytowanym przez agentów
triage	ty	Przeprowadza issues i zewnętrzne PR-y przez etykiety triage i pisze briefy gotowe dla agenta	Utrzymanie backlogu, z którego agent może brać zadania
prototype	agent albo ty	Buduje kod do wyrzucenia, który odpowiada na jedno pytanie projektowe	Nie ocenisz modelu stanów ani UI na papierze
handoff	ty	Kompresuje rozmowę do pliku przekazania w katalogu tymczasowym systemu	Przed /clear albo przy przekazaniu pracy świeżej sesji
setup-matt-pocock-skills	ty	Zapisuje dla pozostałych skilli twój issue tracker, etykiety triage i układ dokumentacji	Raz na repozytorium, przed wszystkim innym

Repozytorium ciągle rośnie: 2026-09-26 README wymienia też ask-matt (router po pozostałych skillach), implement-spec, wayfinder, research, retro, pr i inne. Ta strona opisuje łańcuch z tabeli; porównanie pakietów dyscypliny zestawia cały zestaw z Superpowers, gstack i podobnymi pakietami.

Popularność na 2026-09-26: grill-me ma 1 225 243 instalacje od początku, a grill-with-docs 1 046 834, co daje im drugie i trzecie miejsce wśród skilli praktyk programistycznych. Te liczby pochodzą z zewnętrznego zrzutu skills.sh LinklyAI/best-skills (dane z drugiej ręki; samej strony skills.sh nie odczytano bezpośrednio), więc sprawdź je na skills.sh, zanim je zacytujesz. Repozytorium miało tego dnia około 269,8 tys. gwiazdek na GitHubie. README nazywa oba skille do grillowania „my most popular skills”.

Zainstaluj skille Pococka w Claude Code, Codeksie i Cursorze

README podaje dwie drogi i ostrzega, żeby wybrać jedną: plugin Claude Code to zarządzany pakiet tylko do odczytu, który sam się aktualizuje, a npx skills add kopiuje edytowalne pliki do twojego repozytorium. Jeśli zainstalujesz oba, każdy skill pojawi się dwa razy.

Claude Code

Plugin mattpocock-skills jest w oficjalnym marketplace Anthropic, więc niczego nie trzeba wcześniej dodawać. Uruchom w terminalu:

claude plugin install mattpocock-skills

Albo w sesji: /plugin install mattpocock-skills. Skille z pluginu mają przestrzeń nazw, więc wpisujesz /mattpocock-skills:grill-me, /mattpocock-skills:to-spec i tak dalej.

Sprawdź, ile plugin kosztuje cię w każdej sesji:

claude plugin details mattpocock-skills

2026-09-26 wersja 1.2.3 z 25 skillami dawała prognozę około 1609 tokenów stale obecnych w kontekście (nazwy i opisy skilli). Treść skilla ładuje się dopiero wtedy, gdy skill działa. Manifest na main wymienia już 27 skilli, więc po aktualizacji uruchom komendę ponownie albo porównaj /context przed instalacją i po niej.

Codex

README nie wymienia jeszcze natywnego pluginu dla Codeksa (jest w planach według ADR-a w repozytorium, odczyt 2026-09-26), więc użyj przenośnej kopii. Instaluj każdy skill razem ze skillami, do których deleguje:

npx skills add mattpocock/skills \
  --skill grill-me grill-with-docs grilling domain-modeling \
  to-spec to-tickets implement tdd code-review setup-matt-pocock-skills \
  -a codex

Skill wywołujesz w polu wiadomości przez $, na przykład $grill-me I want to add per-seat billing, albo wybierasz go z /skills.

Cursor

Użyj tej samej przenośnej kopii, skierowanej do Cursora:

npx skills add mattpocock/skills \
  --skill grill-me grill-with-docs grilling domain-modeling \
  to-spec to-tickets implement tdd code-review setup-matt-pocock-skills \
  -a cursor

Wpisz /grill-me w czacie Agenta. Jeśli skill nie pojawia się w menu, poproś o niego po nazwie. Ładowanie skilli w Cursorze sprawdzono tylko w dokumentacji producenta, nie na lokalnej instalacji.

Potem uruchom skill konfiguracyjny raz na repozytorium, w dowolnym narzędziu: /setup-matt-pocock-skills (z pluginem /mattpocock-skills:setup-matt-pocock-skills). Zapyta, jakiego issue trackera używasz (GitHub, GitLab, lokalne pliki Markdown albo opisany przez ciebie proces), a jeśli masz zainstalowany triage, to także czy zostawić domyślne etykiety triage (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix) i gdzie mają leżeć glosariusz i ADR-y. Zapisuje docs/agents/issue-tracker.md, docs/agents/domain.md oraz blok ## Agent skills w CLAUDE.md albo AGENTS.md, a przed zapisem pokazuje ci szkice. to-spec, to-tickets i code-review czytają te pliki; bez nich zatrzymują się i każą uruchomić konfigurację.

Wszystkie komendy powyżej sprawdzono 2026-09-26 w claude plugin --help (Claude Code 2.1.286) i npx skills add --help (skills 1.7.0). Skille to instrukcje od stron trzecich: jeśli twój zespół nie ma jeszcze zasad, przeczytaj, jak zweryfikować skill przed instalacją.

Jak wygląda sesja grill-me?

Skill grilling rozrysowuje twój plan jako drzewo decyzji. W każdej rundzie zadaje wszystkie pytania, których warunki wstępne są już rozstrzygnięte (to „front” drzewa), numeruje je i do każdego podaje rekomendowaną odpowiedź. Twoje odpowiedzi odblokowują kolejną rundę. Fakty, które da się sprawdzić (pliki, schematy, narzędzia), zleca subagentowi, zamiast pytać ciebie; decyzje zawsze zostawia tobie. Sesja kończy się, gdy front jest pusty, a skill nie podejmuje działania, dopóki nie potwierdzisz, że macie wspólne rozumienie.

Notatka

Starsze artykuły i wcześniejsze wersje skilla opisują zadawanie ściśle jednego pytania naraz. grilling/SKILL.md na main, odczytany 2026-09-26, zadaje w każdej rundzie cały front. Jeśli twoja kopia zachowuje się inaczej, zaktualizuj ją (npx skills update albo automatyczna aktualizacja pluginu).

Poniżej skrócona sesja w Claude Code z pluginem. Rozmowa jest po angielsku, tak jak prompty na tej stronie. Skill w swoim formacie oznacza pytania i rekomendacje ikonami; tutaj zastąpiono je zwykłymi etykietami.

> /mattpocock-skills:grill-me I want to add per-seat billing to the team plan

I'm sending a subagent to read how subscriptions and entitlements are stored.
Questions that don't depend on that:

Q1 - Who pays for seats?
     Recommended: the team owner, one subscription with a seat quantity.
Q2 - What happens when a seat is removed mid-cycle?
     Recommended: no refund; the count drops at the next renewal.
     Proration credits add a second billing path you would have to test.
Q3 - Is there a minimum seat count?
     Recommended: one seat, the owner.

> Q1 yes. Q2 yes. Q3: minimum three seats; solo users stay on Pro.

The subagent reports one subscription row per user, no quantity column,
and entitlement cached in KV. Next round:

Q4 - Where does the seat count live?
     Recommended: a seats table, one row per member. To revoke access you
     need to know which members hold seats, not only how many.
Q5 - The owner downgrades below the number of members. Who loses access?
     Recommended: block the downgrade until the owner removes members.
     Choosing who loses access automatically creates support tickets.

> Q4 seats table. Q5 agreed.

[two more rounds: invitations, and when the KV cache is invalidated]

The frontier is empty. Decisions:
 1. Owner pays; one subscription with a seat quantity.
 2. Removal takes effect at renewal; no proration.
 ...
 9. KV entitlement is rewritten on every seat change, not on renewal only.
Nothing is left assumed. Confirm we share an understanding before I do anything else.

> Confirmed.

Co sprawdzić we własnej sesji: pytania przychodzą ponumerowane, każde z rekomendacją, którą przyjmiesz jednym słowem; agent nie pyta o nic, co mógłby sam sprawdzić; nie powstaje żaden kod; sesja kończy się ponumerowaną listą decyzji i prośbą o potwierdzenie. Ta lista to pierwszy artefakt do przejrzenia, a jej przeczytanie zajmuje minutę.

grill-me czy grill-with-docs?

Użyj grill-me, gdy w grę nie wchodzi kod: plan migracji, decyzja rekrutacyjna, konspekt wystąpienia. Użyj grill-with-docs, gdy pracujesz w kodzie, bo do tego samego wywiadu dokłada dyscyplinę domain-modeling:

• Konfrontuje twoje pojęcia z glosariuszem: „Your glossary defines ‘cancellation’ as X, but you seem to mean Y. Which is it?”.
• Proponuje jedno kanoniczne pojęcie w miejsce rozmytego („konto”: Klient czy Użytkownik?).
• Porównuje to, co mówisz, z kodem i wyciąga na wierzch sprzeczności.
• Zapisuje każde ustalone pojęcie w GLOSSARY.md w chwili, gdy zostanie rozstrzygnięte (w monorepo osobne pliki GLOSSARY.md dla kontekstów, wskazane w głównym GLOSSARY-MAP.md).
• Proponuje ADR w docs/adr/ tylko wtedy, gdy decyzja jest trudna do odwrócenia, zaskakująca bez kontekstu i wynika z prawdziwego kompromisu. Jeśli brakuje choć jednego warunku, pomija ADR.

Zysk to krótsze prompty i spójne nazwy. Przykład z README: „a lesson inside a section of a course is made ‘real’ (i.e. given a spot in the file system)” zamienia się w „the materialization cascade”, a kod używa tych samych słów. GLOSSARY.md zawiera wyłącznie definicje, nigdy szczegóły implementacji. Dyscyplinę, która za tym stoi, opisuje domain-driven design z agentami AI, a ADR-y decyzje architektoniczne, których agenci przestrzegają.

Workflow: od pomysłu do zrecenzowanego commita ze skillami Pococka

To łańcuch opisany w README. Każdy krok zostawia artefakt, który sprawdzasz zamiast czytać kod. Pracuj na gałęzi funkcji albo w worktree, bo implement commituje do bieżącej gałęzi.

1. Grillowanie. Uruchom /grill-with-docs z pomysłem w jednym zdaniu. Odpowiadaj na kolejne rundy, aż front będzie pusty, potem potwierdź. Artefakt: ponumerowana lista decyzji oraz GLOSSARY.md i ewentualne ADR-y.

2. Specyfikacja. W tej samej sesji uruchom /to-spec. Skill przegląda repozytorium, proponuje miejsca testowania (woli istniejące, najlepiej jedno), uzgadnia je z tobą i publikuje specyfikację z historyjkami użytkownika, decyzjami implementacyjnymi, decyzjami o testach i listą rzeczy poza zakresem, z etykietą ready-for-agent. Artefakt: jedno issue (albo plik), które zatwierdzasz ty albo product owner.

3. Tickety. Uruchom /to-tickets na specyfikacji. Skill proponuje pionowe plastry, każdy możliwy do zademonstrowania samodzielnie i każdy z listą tego, co go blokuje, i pyta, czy ziarnistość i zależności są dobre. Zatwierdzasz albo poprawiasz, a on publikuje tickety: natywne issues z powiązaniami blokującymi na GitHubie albo GitLabie, albo po jednym pliku na ticket w .scratch/<feature-slug>/issues/ przy lokalnym trackerze. Artefakt: lista ticketów.

4. Implementacja: jeden ticket na świeżą sesję. Zacznij nową sesję i uruchom /implement z jednym ticketem. Skill używa tdd w uzgodnionych miejscach, po drodze sprawdza typy i uruchamia pojedyncze pliki testów, na końcu puszcza pełny zestaw testów, uruchamia code-review i commituje. Kolejny odblokowany ticket bierzesz w kolejnej świeżej sesji; każdy ticket ma rozmiar na jedno okno kontekstu.

5. Review. implement kończy się code-review, ale przed otwarciem PR-a uruchom go jeszcze raz na całej gałęzi: /code-review main. Subagent Standards sprawdza twoje udokumentowane standardy plus bazowy zestaw „code smells” Fowlera; subagent Spec raportuje, czego brakuje, co dodano bez prośby i co wygląda źle, cytując przy każdym znalezisku linię specyfikacji.

6. Wydanie przez zwykłe bramki. Otwórz PR i pozwól, by CI, bot do review i człowiek zrobili swoje jak zwykle. Skille dostarczają dowodów tym bramkom; nie zastępują ich.

Prompt do skopiowania: zacznij grillowanie funkcji

/grill-with-docs We need to let one lesson belong to more than one course. Today a lesson has a single course_id. Look up anything you can find in the code yourself; ask me only for decisions. Challenge any term I use that is not in GLOSSARY.md, and propose an ADR only if the decision is hard to reverse.

Prompt do skopiowania: zamień wygrillowany plan w specyfikację z jednym miejscem testowania

/to-spec Use the decisions we just confirmed. Propose the single highest test seam you can find for this feature and check it with me before writing. Put anything we explicitly deferred under Out of Scope, and do not include file paths.

Prompt do skopiowania: zaimplementuj jeden ticket w świeżej sesji

/implement Ticket 02 in .scratch/multi-course-lessons/issues/. Work only on this ticket; if it needs something another ticket owns, stop and tell me. Write the failing test at the seam named in the spec first and show me it failing. Before you commit, paste the output of the typecheck and the full test suite, then run /code-review against main.

Prompt do skopiowania: zrecenzuj całą gałąź względem specyfikacji

/code-review main. The spec is the issue linked in the first commit message. In the Spec report, list every user story from the spec as implemented, partial or missing, with the test that covers it. Treat any behaviour not in the spec as scope creep, even if it looks useful.

W Claude Code z pluginem poprzedź każdą komendę prefiksem mattpocock-skills: (na przykład /mattpocock-skills:to-spec). W Codeksie zamień początkowy / na $.

Jak sprawdzić wynik bez czytania każdej linii?

Łańcuch przenosi twoją uwagę z diffa na trzy krótkie artefakty i dwie automatyczne kontrole:

Co sprawdzasz	Czego to dowodzi	Kto zatwierdza
Listę decyzji na końcu grillowania	Agent zrozumiał, o co ci chodziło	Ty, zanim potwierdzisz
Specyfikację, zwłaszcza historyjki użytkownika, decyzje o testach i listę rzeczy poza zakresem	Powstanie właściwa rzecz i wiadomo, jak zostanie przetestowana	Tech lead albo product owner, w issue
Podział na tickety i zależności blokujące	Każdy plaster jest na tyle mały, żeby sprawdzić go osobno	Osoba, która zatwierdza to-tickets
Wynik testu najpierw czerwony, potem zielony w uzgodnionych miejscach, plus wynik sprawdzania typów i pełnego zestawu testów	Zachowanie istnieje i nic innego się nie zepsuło	CI, na tych samych komendach
Dwuosiowy raport code-review	Każda linia specyfikacji jest zaimplementowana, nic nie dodano ponad nią, standardy są zachowane	Recenzent PR-a, który czyta raport i testy w miejscu testowania

O czerwony przebieg testu proś wprost (robi to trzeci prompt): test, którego nie widziałeś oblanego, niczego nie dowodzi. Linia specyfikacji cytowana przy każdym znalezisku review to twój ślad audytowy prowadzący z powrotem do listy decyzji. Skille do testów i review opisują szerzej skille, które uczą agenta porządnie testować i debugować, oraz code review wewnątrz agenta.

Kiedy sięgnąć po resztę zestawu?

Przy przenośnej kopii (Codex albo Cursor) najpierw doinstaluj te skille: npx skills add mattpocock/skills --skill diagnosing-bugs improve-codebase-architecture codebase-design triage prototype handoff -a codex (albo -a cursor).

• diagnosing-bugs przy błędzie, którego nie umiesz jeszcze odtworzyć na żądanie. Pierwsza faza to pętla, która świeci na czerwono dla tego konkretnego błędu; nie pozwól agentowi przeskoczyć od razu do poprawki. Przykład: „The invoice total is off by one cent for some EUR orders. Diagnose it.”
• improve-codebase-architecture co kilka dni w kodzie, który agenci intensywnie zmieniają. README nazywa go „a survey, not a rescue”: znajduje kandydatów, a ty wybierasz jednego do przegrillowania. Przykład: /improve-codebase-architecture focus on src/lib/subscription.
• triage, gdy setup-matt-pocock-skills zapisał już twoje etykiety. Przeprowadza issues przez te etykiety, grilluje, gdy zgłoszenie jest niejasne, i pisze briefy, które agent może podjąć.
• prototype, gdy pytanie projektowe wymaga czegoś, co da się przeklikać. Kod jest przeznaczony do wyrzucenia; jeśli fragment precyzyjnie koduje decyzję, to-spec może go wstawić do specyfikacji z adnotacją, że pochodzi z prototypu.
• handoff przed /clear albo na końcu długiego grillowania: /handoff finish the seat-billing tickets. Plik trafia do katalogu tymczasowego systemu, nie do repozytorium, więc skopiuj to, co chcesz zachować. Skille do dyscypliny kontekstu i tokenów porównują go z innymi sposobami na reset sesji.

Co się psuje w skillach Pococka i jak z tego wyjść?

Objaw	Przyczyna	Wyjście
/grill-me odpowiada, ale nie przepytuje	Zainstalowano samego delegata, brakuje grilling	Zainstaluj też cel: npx skills add mattpocock/skills --skill grill-me grilling. grill-with-docs potrzebuje też domain-modeling, a improve-codebase-architecture potrzebuje codebase-design i grilling
Instalator pokazuje listę wyboru albo instaluje wszystkie skille z repozytorium	--skill=grill-me ze znakiem równości: skills 1.7.0 ignoruje taki argument, a z -y wybiera wszystko	Użyj --skill grill-me (ze spacją) albo mattpocock/skills@grill-me. Nadmiarowe usuń przez npx skills remove
„No matching skills” dla to-prd, to-issues albo diagnose	Zmieniono nazwy; stare katalogi zwracają 404 na main, choć skills.sh wciąż pokazuje ich dawne liczby instalacji	Użyj to-spec, to-tickets i diagnosing-bugs
Każdy skill widać w Claude Code dwa razy	Zainstalowano i plugin, i kopię z npx skills	Zostaw jedno. Usuń kopię przez npx skills remove albo odinstaluj plugin
/code-review w Claude Code uruchamia inne review	Claude Code ma wbudowany skill /code-review; przenośna kopia Pococka zainstalowana z -a claude-code konkuruje o tę samą nazwę	Użyj pluginu i wpisuj /mattpocock-skills:code-review
to-spec albo to-tickets zatrzymuje się i każe uruchomić konfigurację	Nie istnieje docs/agents/issue-tracker.md	Uruchom raz /setup-matt-pocock-skills i powtórz komendę
Agent zapisuje CONTEXT.md, a README mówi o GLOSSARY.md	Starsza kopia skilli; CONTEXT.md to wcześniejsza konwencja	Zaktualizuj skille i zmień nazwę pliku, żeby stare i nowe sesje trafiały do jednego glosariusza
Grillowanie trwa wiele rund i sesja zwalnia	Duża funkcja, długi kontekst	Przyjmij rekomendacje hurtem („accept your recommendations for Q7 to Q10”) albo uruchom /handoff i kontynuuj w świeżej sesji z listą decyzji
implement commituje do main	Commituje do tej gałęzi, która jest wybrana	Zaczynaj od gałęzi funkcji albo worktree; jeśli już się stało, przenieś commity przez git branch feature-x && git reset --hard origin/main && git switch feature-x, ale dopiero po sprawdzeniu, że git status jest czysty i nic innego nie czeka na wypchnięcie

Dokąd dalej ze skillami Pococka

Porównanie pakietów dyscypliny Łańcuch Pococka jako framework obok gstack, agent-skills, Ponytail i ECC, z kosztami kontekstu.

Superpowers Cięższa alternatywa: bramka projektowa, plany i TDD, które uruchamiają się same dzięki bootstrapowi na starcie sesji.

Spec-driven development: specyfikacja jako źródło prawdy Jak utrzymać specyfikację z to-spec jako źródło prawdy, gdy kod się zmienia.

Build: plan.md, potem implementacja Gdzie po grillowaniu wchodzi tryb planowania: bramkowany plan, gdy ty i agent zgadzacie się co do celu.

Instalacja i zarządzanie skillami CLI skills dokładnie: zakresy, aktualizacje, usuwanie i pułapki stojące za tabelą powyżej.

Najczęściej instalowane skille praktyk Na którym miejscu są grill-me i reszta zestawu, z instalacją dla każdego narzędzia.