Claude Code Skills w 2026 roku: jak zbudować bibliotekę Skills dla siebie

Dokumentacja Ailoot: API, klucze i konfiguracja.

Co to jest Skill w Claude Code i dlaczego to nie tylko „większy prompt”?#

Skills w Claude Code to natywna funkcja Claude Code, którą Anthropic udostępnił w październiku 2025 r. użytkownikom Pro/Max/Team/Enterprise. Później opublikowano specyfikację Agent Skills jako standard działający również poza Claude. W kodzie to po prostu katalog:

.claude/skills/
├── deploy-to-prod/
│   ├── SKILL.md
│   └── scripts/
│       └── check-migrations.sh
├── weekly-content-plan/
│   └── SKILL.md
└── triage-support-tickets/
    └── SKILL.md

Każdy katalog to jeden Skill. Plik SKILL.md to Markdown z nagłówkiem YAML na początku i zwykłymi instrukcjami poniżej. Gdy użytkownik prosi: „wdrożmy na produkcję”, Claude widzi opis Skilla deploy-to-prod, rozpoznaje frazę „wdrożyć na produkcję”, ładuje treść SKILL.md do kontekstu i wykonuje kolejne kroki.

Trzy poziomy progresywnego ładowania

Anthropic zaprojektował Skills z progresywnym ładowaniem: dane są wczytywane warstwami w miarę potrzeby. Na blogu Anthropic Engineering zespół opisuje to jako „podstawową zasadę projektową, dzięki której Agent Skills są elastyczne i skalowalne” (Anthropic Engineering).

Trzy poziomy ładowania:

1. Metadane (zawsze) - gdy rozpoczyna się sesja, Claude widzi tylko name i description każdego Skilla. Budżet: około 100 tokenów na Skill.
2. Instrukcje (po uruchomieniu) - gdy użytkownik mówi coś związanego z tematem, Claude ładuje treść SKILL.md. Budżet: mniej niż 5000 tokenów.
3. Zasoby (na żądanie) - dołączone pliki (przykłady, szablony, zbiory danych) są pobierane dopiero wtedy, gdy sam model ich szuka. Budżet: nieograniczony.

Wcześniej CLAUDE.md musiał zawierać wszystko, co AI powinno „pamiętać” — projekt z 50 regułami szybko wyczerpywał limit kontekstu. Dzięki Skills w jednym projekcie może ich być kilkadziesiąt, ponieważ do kontekstu początkowego trafiają tylko ich opisy.

Gdzie przechowywane są Skills: cztery poziomy

Priorytety: ustawienia enterprise mają pierwszeństwo przed osobistymi, a osobiste przed ustawieniami projektu. Wtyczki korzystają z przestrzeni nazw plugin-name:skill-name i nie powodują konfliktów. To wygodne: ogólne umiejętności zawodowe umieść w ~/.claude/skills/, a te specyficzne dla projektu w katalogu .claude/skills/ repozytorium.

Co zawiera plik SKILL.md?#

Oto minimalny przykład — dwadzieścia linii i Skill jest gotowy:

---
name: weekly-content-plan
description: Prepares a weekly post plan for a Telegram channel and short-form videos. Triggers - "make a post plan", "what should I post this week", "a 7-day channel plan". Do not activate if the request is about a website or email newsletter.
---

# Weekly Content Plan

## Steps

1. Read `knowledge/audience.md` - who we're writing for
2. Read `knowledge/tone-of-voice.md` - how we write
3. Read the last 10 posts in the channel - what has already been covered
4. Come up with 7 topics for the week: 3 sales-focused, 2 expert, 2 personal
5. For each, provide one hook line and three bullets about the post
6. Output as a table: day of the week | type | hook | plan

To wystarczy. Jeśli użytkownik napisze: „ułóżmy plan postów na ten tydzień”, Claude rozpozna frazę uruchamiającą w opisie, załaduje SKILL.md, przeczyta wskazane pliki i przedstawi tabelę.

Limity, o których warto pamiętać

Oficjalna dokumentacja Claude API określa ścisłe limity:

• name: do 64 znaków, wyłącznie małe litery, cyfry i myślniki, bez tagów XML. anthropic i claude są zarezerwowane.
• description: do 1024 znaków w API; wymagane, bez tagów XML.
• Budżet listy: w Claude Code opisy wszystkich Skills razem zajmują około 1% okna kontekstu. Jeśli Skills jest dużo, opisy zostaną skrócone i mogą zniknąć słowa kluczowe potrzebne Claude’owi do dopasowania prośby.
• Treść SKILL.md: Anthropic zaleca, by nie przekraczała 500 linii. Przenieś dłuższe materiały do plików w references/, scripts/ i examples/, a następnie odwołuj się do nich w instrukcjach.

Po kompakcji kontekstu (/compact) Claude zachowuje pierwsze 5000 tokenów każdego wcześniej użytego Skilla; łączny budżet dla wszystkich ponownie dołączonych Skills wynosi 25 000 tokenów. Jeśli Skill się nie zmieści, jego działanie zostanie „zapomniane”.

Pełny schemat frontmatter

Używaj co najmniej pól name i description. Skills produkcyjne korzystają również z innych pól:

Pole disable-model-invocation: true jest niezbędne w przypadku wszystkiego, co nie powinno uruchamiać się automatycznie. Na przykład Skill deploy-to-prod z tą flagą można uruchomić tylko wtedy, gdy użytkownik wpisze /deploy-to-prod. Bez tej flagi Claude mógłby wdrożyć kod, bo „wygląda na gotowy”.

Dlaczego opis odpowiada za 90% pracy i jak go napisać?#

Najczęstszy błąd vibe-coderów to opis w rodzaju „Pomoc przy X”. Skill fizycznie istnieje w swoim katalogu, ale Claude go nie uruchamia.

Zły opis

description: Build dashboards.

Claude nie potrafi ustalić, czy prośba „pokaż mi sprzedaż z tego tygodnia” dotyczy dashboardu. Czy prośba o „wykres przychodów” dotyczy dashboardu, czy po prostu wykresu? Czy „raport miesięczny” z pewnością nie jest prośbą o dashboard?

W swoim skill-creator Anthropic formułuje zalecenie wprost:

Formuła dobrego opisu

Trzy części:

1. Co robi - jedno zdanie o wyniku, nie o procesie. Nie „generuje SQL”, lecz „eksportuje sprzedaż do tabeli na kanał Telegram”.
2. Kiedy uruchamiać - 3-5 fraz w cudzysłowie, których użytkownicy rzeczywiście używają. Nie zgaduj; sprawdź historię czatów i zgłoszeń do pomocy technicznej.
3. Kiedy NIE uruchamiać - 1-2 frazy dotyczące podobnych zadań, na które Skill nie powinien odpowiadać. Bez tej części dwa podobne Skills będą ze sobą kolidować.

Przykład skutecznego opisu z mojego projektu (uproszczony i zanonimizowany):

description: |
  Pisze i publikuje poradnik SEO na blogu zgodnie z polityką redakcyjną.
  Uruchamiają: „napisz poradnik o X”, „stwórzmy nowy artykuł filarowy”,
  „artykuł na bloga o Y”, „przygotuj poradnik na bloga o Z”.
  Nie uruchamiaj, jeśli prośba dotyczy newslettera e-mailowego,
  posta na Telegramie lub wewnętrznej instrukcji dla zespołu —
  do tego służą inne Skills.

Co tu działa:

• Czasownik „pisze i publikuje” zamiast „pomaga” określa konkretny rezultat.
• Cztery frazy uruchamiające w cudzysłowie obejmują różne sposoby formułowania próśb.
• Dodano też angielską frazę uruchamiającą — Skill nadal zadziała, jeśli użytkownik przejdzie na język zespołu.
• Osobna sekcja „nie uruchamiaj, jeśli” zapobiega konfliktom ze Skills do e-maili i postów.

Jak testować opis

W swoim skill-creator Anthropic wprowadził metodykę trigger-evals: 20 promptów sprawdzających, czy Skill się aktywuje. Dziesięć powinno go uruchomić, a dziesięć nie — w tym przypadki bardzo podobne, w których sformułowanie jest zbliżone, ale zadanie inne.

W praktyce oznacza to: po napisaniu opisu otwórz pusty czat i wypróbuj 5 często używanych fraz oraz 3 podobne, które oznaczają coś innego. Jeśli Skill nie aktywuje się tam, gdzie powinien, lub aktywuje się tam, gdzie nie powinien, zmień opis. Dopiero potem napisz treść instrukcji.

Które 5 Skills zainstalować najpierw?#

Przez pierwsze dwa tygodnie pisać własne Skills to kiepska strategia. Zacznij od instalowania gotowych i sprawdź, jak są zbudowane; potem dodaj własne, korzystając z tego samego podejścia. Łatwiej wziąć sprawdzone kolekcje innych osób i dostosować je do siebie, niż budować wszystko od zera. Oto pięć kolekcji, od których warto zacząć:

1. anthropics/skills - oficjalna kolekcja z skill-creator

Repozytorium: github.com/anthropics/skills. 138 000 gwiazdek na GitHubie. Zawiera oficjalne Skills zespołu Anthropic: skill-creator (meta-Skill tworzący inne Skills), claude-api (pomaga budować integracje API) oraz gotowe Skills do pracy z dokumentami PowerPoint, Excel, Word i PDF.

Zainstaluj w Claude Code:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Główną wartością jest skill-creator. Na podstawie Twojego opisu tworzy plik SKILL.md, a następnie uruchamia 20 testów trigger-evals i poprawia opis, aż Skill zacznie uruchamiać się we właściwych sytuacjach. W gruncie rzeczy to „Skill do tworzenia Skills”.

2. mattpocock/skills - wiralowa kolekcja eksperta TypeScript

Zawiera 12 aktywnych Skills, w tym:

Zainstaluj:

npx skills@latest add mattpocock/skills
/setup-matt-pocock-skills

3. coreyhaines31/marketingskills - kolekcja dla marketerów

Jeśli prowadzisz programy online, pracujesz jako niezależny marketer lub prowadzisz agencję, nie musisz poświęcać sześciu miesięcy na pisanie własnych Skills. Połowa zadań jest już gotowa.

4. vercel-labs/agent-skills - projektowanie bez wyglądu generowanego przez AI

Repozytorium: github.com/vercel-labs/agent-skills. Najpopularniejszy Skill z tej kolekcji to web-design-guidelines. Audytuje kod interfejsu pod kątem ponad 100 zasad dostępności, wydajności i użyteczności.

Równolegle rozwijany jest Anthropic frontend-design, który ma ponad 110 000 instalacji tygodniowo. Sprawia, że AI wybiera styl, zanim zacznie pisać kod. Bez niego każda strona generowana przez Claude ma font Inter, fioletowy gradient i karty w siatce. Efekt jest u wszystkich taki sam.

5. obra/superpowers - wieloagentowy przepływ pracy

Jeśli zainstalujesz trzy pierwsze kolekcje z tej listy — anthropics/skills, mattpocock/skills i coreyhaines31/marketingskills — Twój Claude Code będzie mieć dziesiątki gotowych Skills obejmujących większość zadań przedsiębiorcy już w pierwszym miesiącu.

Chcesz nie tylko instalować gotowe Skills, ale też zbudować konfigurację, dzięki której Claude naprawdę stanie się Twoim asystentem? Skills to jeden z trzech filarów tej metodyki. Dobrze działająca konfiguracja składa się z trzech części: klon AI (Skills jako spakowana wiedza ekspercka) + Drugi Mózg (struktura wiedzy zapewniająca kontekst) + inżynieria kontekstu (sposób, w jaki Claude widzi cały projekt). Taka konfiguracja zmienia Claude’a z asystenta zgadującego w narzędzie działające według Twojej logiki.

Jakie powtarzalne zadania warto zamienić w Skill?#

W pracy z klientami i przy projektach innych osób widziałem ten schemat dziesiątki razy. Ktoś ma „to, co za każdym razem robi od zera”. W każdy poniedziałek pisze podobny raport. Za każdym razem, gdy przyjmuje nowego klienta, przechodzi tę samą procedurę. Każda publikacja powstaje według tego samego szablonu. Za każdym razem zajmuje to 30-90 minut, bo trzeba przypomnieć sobie kroki, otworzyć właściwe pliki i od nowa ułożyć prompt dla Claude’a.

Rozwiązaniem jest jednorazowe spakowanie tego w Skill. Potem wystarczy jedno zdanie, a Claude załaduje metodykę, przeczyta potrzebne źródła i przygotuje wynik. Oto trzy przykłady z różnych dziedzin:

Przykład 1. Niezależny marketer - Skill weekly-content-plan

Co robi ręcznie: w każdy poniedziałek przygotowuje posty na Telegrama na cały tydzień dla trzech klientów. Otwiera przewodnik po głosie marki klienta, przegląda ostatnie posty, wymyśla tematy na podstawie kalendarza produktu i tworzy tabelę z chwytliwymi wstępami i punktami.

W Skillu staje się to pięcioetapową instrukcją: przeczytaj plik klienta dotyczący tonu komunikacji, przeczytaj kalendarz produktu, sprawdź 10 ostatnich postów pod kątem powtórzeń, wymyśl siedem tematów podzielonych na typy (sprzedażowe, eksperckie, osobiste) i przedstaw wynik w tabeli.

Polecenie „ułóżmy plan postów dla klienta X na ten tydzień” zamienia godzinę przygotowań w trzy minuty oczekiwania. Marketer sprawdza wynik, wprowadza konkretne poprawki i wysyła go klientowi.

Przykład 2. Księgowy zewnętrzny - Skill monthly-receipts-close (przykład autora)

Co robi ręcznie: dla każdego klienta z portfolio co miesiąc eksportuje wyciąg bankowy, uzgadnia go z płatnościami w systemie księgowym, oznacza niesklasyfikowane płatności, przygotowuje wstępny raport przychodów i porównuje strukturę przychodów z poprzednim miesiącem.

Skill to sześcioetapowa instrukcja i kilka skryptów powłoki w folderze scripts/ do przetwarzania wyciągów bankowych. Polecenie „zamknij maj dla klienta X” sprawia, że Claude w 4-5 minut przygotowuje raport z oznaczonymi anomaliami.

Przykład 3. Twórca programu online - Skill welcome-letter-new-participant

Co robi ręcznie: nowy uczestnik opłacił program i trzeba napisać powitalny e-mail. Dobre powitanie jest osobiste: uwzględnia kanał, z którego dana osoba przyszła, kupiony produkt, grupę, do której dołącza, oraz materiały, które należy do niego wysłać. Szablon „cześć, cieszymy się” tego nie zapewnia.

Skill instruuje Claude’a, by przeczytał knowledge/audience.md (kim są te osoby), knowledge/products/<product>.md (co otrzymują) i trzy ostatnie wiadomości powitalne (aby uniknąć powtórzeń), a następnie napisał e-mail według struktury: chwytliwy wstęp - szczegóły produktu - pierwsze trzy kroki - podpis.

Wielokrotnie szybciej niż przy pracy ręcznej. Jakość jest bardziej spójna, bo Claude pamięta o sprawdzeniu trzech źródeł, podczas gdy osoba działająca w pośpiechu pomija jedno z nich.

Czego NIE zamieniać w Skill

• Jednorazowe zadania. Jeśli robisz coś raz w roku przy rozliczeniu podatkowym, po prostu opisz to Claude’owi na czacie. Skill zaczyna się opłacać po 3+ powtórzeniach.
• Zadania zbyt ogólne. „Pomóż mi w marketingu” to nie Skill, lecz cały marketing. Skill to „tygodniowy plan treści” — konkretna czynność z konkretnym wynikiem.
• Zadania bez powtarzalnych kroków. Jeśli proces za każdym razem wygląda inaczej, to nie Skill, lecz jednorazowa praca.

Jak Skill Creator tworzy Skills dla Ciebie?#

Problem w tym, że trudno napisać dobry Skill za pierwszym razem. Opis często okazuje się zbyt wąski albo zbyt szeroki, pomija frazy, których rzeczywiście używają użytkownicy, lub koliduje z sąsiednim Skillem. Anthropic rozwiązał ten problem, udostępniając skill-creator — meta-Skill, który tworzy inne Skills.

Po zainstalowaniu anthropics/skills powiedz Claude’owi /skill-creator (albo po prostu „stwórzmy Skill do raportu tygodniowego”) i przejdź przez sześcioetapowy proces:

1. Szkic - skill-creator zadaje pytania: co Skill ma robić, jakich fraz uruchamiających użyć, jakie źródła przeczytać i jakie kroki wykonać. Wynikiem jest pierwsza wersja SKILL.md.
2. Test - skill-creator generuje 20 promptów testowych: 10 powinno uruchamiać Skill, a 10 brzmi jak frazy uruchamiające, lecz nie powinno go uruchamiać (przypadki bliskie, ale nietrafione).
3. Ocena - każdy prompt jest uruchamiany w nowym czacie i sprawdzane jest, czy Skill się aktywował. Jeśli aktywuje się tam, gdzie nie powinien, albo nie aktywuje się tam, gdzie powinien, wynik jest oznaczany.
4. Iteracja - opis jest przepisywany na podstawie błędów, po czym testy są uruchamiane ponownie.
5. Optymalizacja - końcowe dopracowanie: sprawdzenie, czy nie został przekroczony limit 1024 znaków i czy nie występują konflikty z istniejącymi Skills projektu.
6. Pakowanie - końcowy plik SKILL.md i pliki referencyjne są umieszczane we właściwej strukturze.

W praktyce wygląda to tak: przez 15-20 minut rozmawiasz z Claude’em, odpowiadasz na 7-8 pytań doprecyzowujących i na koniec otrzymujesz gotowy, przetestowany Skill, który uruchamia się przy właściwych frazach.

Kolejna zaleta: skill-creator pokazuje wzorcowy sposób pisania SKILL.md. Możesz otworzyć jego własny plik i zobaczyć format, ton oraz układ kroków. To narzędzie, które pokazuje, jak działa — czytasz je i uczysz się pisać własne Skills.

Skills, CLAUDE.md, subagenci, MCP, hooki: czego używać?#

Najczęstszy problem w projektach, które przeglądałem, polega na tym, że CLAUDE.md zawiera jednocześnie zasady projektu, instrukcje publikacji krok po kroku, szablon commita i opis bazy danych. Przeciąża to kontekst i nie sprawdza się w praktyce: Claude nie wykona instrukcji „gdy użytkownik poprosi o publikację”, ponieważ traktuje cały plik CLAUDE.md jako ogólny kontekst bez wyraźnych wyzwalaczy.

Rozwiązaniem jest przypisanie każdego elementu do właściwego mechanizmu:

W recenzji mechanizmów Claude Code autorstwa Alexa Opa („Understanding Claude Code's Full Stack”) całość sprowadza się do prostej logiki: Skills i MCP obsługują większość przepływów pracy; hooki automatyzują rutynowe zadania — kontrole kodu, testy i zabezpieczenia. Subagenci są potrzebni, gdy kontekst staje się obszerny. Najczęstszym błędem jest tworzenie subagenta zamiast Skilla.

Drzewo decyzyjne

Gdy myślisz: „Chcę, żeby Claude zrobił X”:

1. Czy ta wiedza jest potrzebna cały czas? Na przykład: „Projekt ma ustalony język” albo „nie używamy długich myślników”. → Umieść ją w CLAUDE.md.
2. Czy to procedura uruchamiana przez określoną frazę, którą obecnie wykonujesz ręcznie? Na przykład: „Co poniedziałek piszę raport”. → Utwórz Skill.
3. Czy potrzebujesz dostępu do systemu zewnętrznego? Na przykład do API Stripe lub Twojego CRM. → Podłącz serwer MCP.
4. Czy Claude Code ma automatycznie reagować na zdarzenie? Na przykład uruchamiać linter po każdym Edit. → Napisz hook.
5. Czy zadanie jest obszerne, pochłonie cały kontekst i musisz równolegle zrobić coś innego? → Uruchom subagenta.

90% zadań przedsiębiorcy i vibe-codera mieści się w kategoriach 1-3. Hooki i subagenci to bardziej zaawansowane narzędzia, przydatne, gdy wyjdziesz poza „jedno zadanie naraz”.

Polecenia slash i Skills to w praktyce to samo

W Claude Code zaszła ważna zmiana: stary system poleceń slash (.claude/commands/) i Skills praktycznie się połączyły. Plik .claude/commands/deploy.md oraz .claude/skills/deploy/SKILL.md tworzą polecenie /deploy. Jeśli nazwy są takie same, wygrywa Skill. Jeśli nadal używasz starego formatu poleceń slash, przejdź na Skills — mają czytelniejszą składnię i więcej możliwości.

7 błędów, przez które Skill nie działa#

1. Opis bez fraz uruchamiających: Skill się nie aktywuje

Objaw: piszesz Skill, sprawdzasz jego strukturę i wszystko jest poprawne, ale Claude nie uruchamia go w odpowiedzi na prośby użytkowników. Przyczyna prawie zawsze jest ta sama: opis w rodzaju „Pomoc przy tworzeniu treści”. Claude nie wie, na jakie frazy ma reagować. Rozwiązanie: umieść w opisie 3-5 rzeczywistych fraz użytkowników, zapisanych w cudzysłowie.

2. SKILL.md powyżej 500 linii: uwaga się rozprasza

Anthropic wyraźnie zaleca, aby treść pliku nie przekraczała 500 linii. Jeśli instrukcje mają 2,000 linii, Claude traci koncentrację, realizuje tylko część kroków i myli ich kolejność. Rozwiązanie: przenieś obszerne sekcje do sąsiednich plików — examples/, references/, scripts/ — i odwołuj się do nich w SKILL.md.

3. Zamiast trzech małych Skills — jeden do „wszystkiego o treści”

Kusząca konfiguracja: jeden duży Skill content obejmujący posty na Telegrama, strony docelowe i e-maile. To nie działa. Skill uruchamia się przy niewłaściwych prośbach, miesza metodyki i daje uśredniony wynik. Rozwiązanie: jeden Skill = jedna powtarzalna czynność. Jeśli masz trzy rutyny związane z „treścią”, utwórz trzy Skills: telegram-post, landing-section, email-broadcast.

4. Skill bez sekcji „Kiedy NIE używać”: konflikty

Objaw: w projekcie są dwa podobne Skills i Claude uruchamia niewłaściwy. Na przykład jeden dotyczy newslettera e-mailowego, a drugi jest przeznaczony do wiadomości powitalnych dla uczestników programu. Bez wyraźnego zastrzeżenia „nie uruchamiaj, jeśli prośba dotyczy ogólnej listy mailingowej” Skill do wiadomości powitalnych uruchomi się przy każdej wzmiance o „e-mailu”. Rozwiązanie: opisz w negatywnych przypadkach, kiedy Skill nie powinien się aktywować.

5. 50 Skills w projekcie: opisy zostają ucięte

Z dokumentacji Claude Code:

Jeśli pobierzesz z marketplace’u 50 kolekcji Skills, część opisów zostanie skrócona. Słowa kluczowe, na których Ci zależało, mogą zniknąć. Rozwiązanie: zachowaj w aktywnym projekcie 10-15 najbardziej przydatnych Skills. Resztę trzymaj w nieaktywnym archiwum poza wszystkimi wykrywanymi katalogami skills, np. osobnym skill-archive/ we własnych materiałach. Instaluj tylko potrzebne skills w projekcie lub zakresie osobistym. ~/.claude/skills/ jest zainstalowaną biblioteką widoczną między projektami, więc przeniesienie tam nie usuwa wykrywania.

6. Skills z niezweryfikowanych źródeł: zagrożenie bezpieczeństwa

Anthropic ostrzega o tym w oficjalnej dokumentacji:

Repozytorium na GitHubie od nieznanego autora może zawierać Skill, który wykradnie Twoje klucze API przy pierwszym uruchomieniu. Rozwiązanie: samodzielnie otwórz i przeczytaj SKILL.md przed instalacją. Nie uruchamiaj Skills nieznanych autorów w ważnych projektach.

7. Skill bez folderu z wiedzą daje „przeciętny ChatGPT”

Najbardziej subtelny i najczęstszy antywzorzec. Skill to metodyka, ale bez kontekstu sama metodyka nic nie znaczy. Jeśli napiszesz Skill „stwórz wiadomość powitalną”, a w projekcie nie będzie pliku opisującego odbiorców ani pliku z głosem marki, Claude napisze przeciętny e-mail jak z ChatGPT, nieodróżniający się od wiadomości innych osób.

Skill działa najlepiej, gdy wcześniej zbudujesz projektowy Drugi Mózg zgodnie z zasadami opisanymi w poradniku o CLAUDE.md. Najpierw zbuduj strukturę wiedzy, a potem utwórz Skills, które z niej korzystają. Jeśli odwrócisz kolejność, uzyskasz rutynową, przeciętną jakość zamiast pracy dopasowanej do Twojego stylu.

Jak zbudować pierwszy Skill w 30 minut#

Oto konkretny plan, według którego zbudowałem pierwsze Skills w swoich projektach:

Krok 1. Wybierz jedną powtarzalną czynność

Otwórz kalendarz z ostatniego miesiąca. Znajdź zadanie, które wykonywałeś/-aś co najmniej 4-5 razy i które za każdym razem zajmuje 30-60 minut. Nie chodzi o ogólny „marketing”, lecz o coś konkretnego: „poniedziałkowy raport sprzedaży”, „wdrożenie nowego klienta” albo „aktualizacja cennika na promocję”.

Im węziej sformułujesz zadanie, tym prostszy będzie Skill i tym lepiej zadziała fraza uruchamiająca.

Krok 2. Rozpisz ręcznie proces

W osobnym pliku lub na czacie z Claude’em (nie do Skilla, lecz jako szkic) rozpisz wykonywane kroki:

1. Otwórz bazę klientów
2. Filtruj według statusu "awaiting welcome email"
3. Sprawdź, z jakiego kanału przyszedł klient
4. Pobierz szablon e-maila dla tego kanału z folderu "templates"
5. Wstaw imię i nazwisko, produkt oraz datę rozpoczęcia
6. Wyślij

To jeszcze nie Skill, lecz notatki. Bez nich pisanie SKILL.md od początku będzie chaotyczne.

Krok 3. Utwórz strukturę folderów

mkdir -p .claude/skills/welcome-email-new-client
touch .claude/skills/welcome-email-new-client/SKILL.md

Albo, jeśli chcesz używać Skilla we wszystkich swoich projektach, umieść go w ~/.claude/skills/.

Krok 4. Napisz SKILL.md według szablonu

Szkielet:

---
name: welcome-email-new-client
description: |
  Prepares a welcome email for a new client using the template for their acquisition channel.
  Triggers: "write a welcome email for new client X",
  "onboard new participant Y", "welcome email for client from channel Z".
  Do not activate if the request is about a general mailing list
  or an email campaign—those are other skills.
---

# Welcome Email for a New Client

## Steps

1. Read `knowledge/audience/segments.md` - what client segments we have
2. Read `knowledge/templates/welcome/` - templates by channel
3. Identify the client's channel from the request context
4. Insert the client's name, product name, and start date
5. Check the length—it should be no more than 800 characters
6. Output the final email text in a copy-ready format

## Important

- Do not use “dear friend” or “hello”—use natural speech
- One paragraph, one idea
- End with one call to action, not two

Krok 5. Przetestuj na 5-8 promptach

Otwórz pusty czat w Claude Code w tym projekcie. Wypróbuj 5 często używanych fraz i 3 podobne, które nie powinny uruchomić Skilla:

Powinien się uruchomić:

• „Napisz wiadomość powitalną dla nowego klienta Iwanowa”
• „Wdróż nowego uczestnika, który kupił program X”
• „Wiadomość powitalna dla klienta z Instagrama”

Nie powinien się uruchomić:

• „Wyślij mail promocyjny do całej listy”
• „Kampania e-mailowa na ferie noworoczne”
• „Napisz wiadomość przypominającą do klienta, który nie zapłacił”

Za każdym razem sprawdź, czy Skill się aktywował. Jeśli aktywuje się w niewłaściwych przypadkach, zawęź opis. Jeśli nie aktywuje się tam, gdzie powinien, poszerz listę fraz uruchamiających.

Krok 6. Popraw opis

Po każdym nieudanym teście zmień tylko opis — nie ruszaj treści instrukcji. Po 2-3 iteracjach Skill zacznie niezawodnie się uruchamiać. Zapisz go, zatwierdź commitem, a potem używaj na co dzień.

Ostatnia rada: nie próbuj dopracować pierwszego Skilla do perfekcji. Spraw, by działał. Dopracuj go po piątym lub dziesiątym Skillu, gdy zaczniesz dostrzegać wzorce w swoim sposobie formułowania próśb i w odpowiedziach Claude’a.

Wybierz z kalendarza jedno powtarzalne zadanie na ten tydzień, zarezerwuj 30 minut i wykonaj sześć powyższych kroków. Dzięki temu Claude będzie działać według Twojej metodyki, zamiast zgadywać.

Dobrze działająca konfiguracja to klon AI + Drugi Mózg + inżynieria kontekstu. Trzy części jednej metodyki.

Jeśli potrzebujesz dostępu do modeli AI przez Ailoot, zajrzyj na Ailoot.