Skille do Claude, których naprawdę używam

Skill to instrukcja dla Claude, którą zapisujesz raz, a on sięga po nią sam, gdy jest potrzebna. Zamiast wklejać te same zasady na początku każdej rozmowy, wkładasz je do folderu i opisujesz jednym zdaniem, kiedy mają działać.

Czym jest skill

Skill (po angielsku Agent Skill) to folder z plikiem SKILL.md. Na górze pliku jest krótki nagłówek z dwoma polami: name (nazwa) i description (opis). Pod nim są instrukcje w zwykłym Markdownie. Obok mogą leżeć dodatkowe pliki: szablony, przykłady, dłuższe zasady i skrypty, do których instrukcja odsyła.

Na starcie Claude zna tylko nazwy i opisy skilli. Gdy zadanie pasuje do opisu, wczytuje cały SKILL.md, a dodatkowe pliki dopiero wtedy, gdy instrukcja każe po nie sięgnąć. Dlatego możesz mieć wiele skilli bez zaśmiecania każdej rozmowy.

Czym to się różni od pliku CLAUDE.md? CLAUDE.md Claude Code czyta zawsze, w każdej sesji danego projektu. Skill włącza się tylko przy pasującym zadaniu i łatwo go przenieść do innego projektu.

Gdzie mieszkają skille

W Claude Code są dwa podstawowe miejsca:

moj-projekt/.claude/skills/<nazwa>/SKILL.md   skill tego projektu
~/.claude/skills/<nazwa>/SKILL.md             twoje osobiste skille, w każdym projekcie

Skille projektu trafiają do repozytorium, więc ma je każdy, kto w nim pracuje. Osobiste są na twoje nawyki.

Skille działają też w aplikacjach Claude. Możesz tam wgrać własny skill jako spakowany folder i korzystać z gotowych skilli Anthropic do dokumentów: Word, Excel, PowerPoint i PDF. Gdzie dokładnie są te ustawienia i na jakich planach działają, sprawdź w aktualnej pomocy Claude, bo to się zmienia.

motion-reel: skill, który robi filmy

To mój własny skill w repozytorium studia filmod, w pliku .claude/skills/motion-reel/SKILL.md. Jego opis mówi, że służy do pionowych filmów motion renderowanych z kodu w stylu papierowej wycinanki i że ma się włączać, gdy ktoś prosi o reelsa, krótki film, film na premierę, animowane wyjaśnienie albo reklamę.

Co jest w środku:

Lista pytań na start. Claude w jednej wiadomości dopytuje o brakujące rzeczy: tezę filmu, długość, słowo z planszy końcowej i poradnik, do którego prowadzi, kolory marki, referencję i dźwięk.
Proces krok po kroku. Kopia szablonu, zrzuty prawdziwego produktu zamiast interfejsu z wyobraźni, scenariusz, głos z ElevenLabs i lista ujęć. Potem przystanek: Claude czeka na akceptację listy ujęć, zanim zacznie animować.
Pętla krytyki. Co najmniej trzy rundy: arkusz klatek, ocena, poprawka trzech najsłabszych miejsc. Dopiero potem pełny render i sprawdzenie głośności.
Twarde zasady. Bez Math.random, bez zmyślonych ekranów i liczb, wszystko po polsku, bez długich myślników.

Sam skill jest krótki: szczegóły stylu i renderowania leżą w CLAUDE.md i przewodniku stylu repozytorium, a skill do nich odsyła. Każda zasada jest zapisana w jednym miejscu.

design-taste-frontend: skill od wyglądu stron

Autor: Leonxlnx, repozytorium taste-skill na GitHubie. Instalacja jednym poleceniem w folderze projektu:

npx skills add Leonxlnx/taste-skill

W repozytorium studia skill trafił do .claude/skills/design-taste-frontend/, a plik skills-lock.json zapisał, skąd pochodzi i jaki ma skrót zainstalowanej wersji.

Autor opisuje go jako skill przeciwko stronom, które wyglądają jak średnia wszystkich stron z AI. W praktyce działa tak:

Najpierw treść, potem wygląd. Claude spisuje rzeczy, które należą tylko do tego klienta, i układa stronę jako listę tez z dowodami, sekcja po sekcji.
Losowanie kierunku. Skrypt draw.mjs proponuje trzy z dwudziestu opisanych kierunków artystycznych, a po wyborze dobiera typografię, kolory i układy sekcji. Według autora biblioteka powstała z analizy 247 stron z galerii One Page Love i Awwwards.
Zasady domu. Bez etykiet nad nagłówkami, bez numeracji 01, 02, bez cienkich linii, gradientów i cieni, bez czcionki o stałej szerokości poza kodem, nagłówki najwyżej w dwóch liniach.
Pomiar i patrzenie. Skrypt inspect.mjs otwiera stronę w prawdziwej przeglądarce przy szerokościach 1440, 768 i 390 pikseli, sprawdza zasady i robi zrzuty. Claude ocenia zrzuty i poprawia trzy najgorsze problemy.

Wygląd filmod.pl powstał w ten sposób: kierunek „The sentence is the layout” zapisany w .taste-skill/direction.json. Do inspektora skill potrzebuje Node.js 22 lub nowszego i zainstalowanego Chrome albo Chromium.

Jak napisać własny skill

Weź jedno zadanie, które powtarzasz, i zapisz je tak:

---
name: oferta-z-notatek
description: Zamienia notatki ze spotkania z klientem w ofertę po polsku według stałego szablonu. Użyj, gdy ktoś wkleja notatki ze spotkania albo prosi o ofertę, wycenę lub propozycję współpracy.
---

# Oferta z notatek

1. Wypisz z notatek: klienta, problem, zakres i terminy. Jeśli czegoś brakuje, zapytaj, zanim zaczniesz pisać.
2. Napisz ofertę według pliku `szablon.md` z tego folderu.
3. Ceny bierz tylko z pliku `cennik.md`. Nie wymyślaj cen ani rabatów.
4. Ton konkretny, bez przymiotników typu „najlepszy” czy „wyjątkowy”.
5. Na końcu wypisz pytania, które zostały otwarte.

Folder wygląda wtedy tak:

.claude/skills/oferta-z-notatek/
  SKILL.md
  szablon.md
  cennik.md

Nazwę pisz małymi literami, z myślnikami zamiast spacji, tak samo jak nazwę folderu. Dokładne limity długości nazwy i opisu znajdziesz w dokumentacji na docs.claude.com.

Cztery rady, które oszczędzają czas

Opis decyduje, kiedy skill zadziała. Napisz, co robi i kiedy go użyć, słowami, których naprawdę używasz („oferta”, „wycena”). Za ogólny opis włączy skill wszędzie, za wąski nigdy.
Instrukcje krótko. Claude zna ogólne rzeczy. Zapisz tylko to, co jest twoje: kolejność kroków, szablon, zasady, czego nie robić.
Długie rzeczy do osobnych plików. Cennik, przykłady i przewodnik stylu trzymaj obok, a w SKILL.md napisz, kiedy po nie sięgnąć. Kroki mechaniczne, jak zmiana formatu pliku, lepiej zamknąć w skrypcie.
Testuj na prawdziwych zadaniach. Nowa rozmowa, prawdziwe zadanie, bez wspominania o skillu. Czy się włączył? Czy przeszedł wszystkie kroki? Sprawdź też odwrotnie: czy nie włącza się tam, gdzie nie powinien.

Bezpieczeństwo

Skill to instrukcje, a czasem także kod, który Claude uruchamia na twoim komputerze z twoimi uprawnieniami. Dlatego:

Instaluj tylko skille ze źródeł, którym ufasz.
Przeczytaj SKILL.md i skrypty przed instalacją. Szukaj poleceń, które wysyłają dane na zewnątrz, pobierają inne pliki albo zaglądają do kluczy i pliku .env.
Po aktualizacji sprawdź, co się zmieniło, na przykład przez git diff.
Żadnych kluczy API w skillu. Klucze trzymaj w pliku .env, który nie trafia do repozytorium.

Przykład: README skilla design-taste-frontend mówi, że jego skrypty niczego nie instalują i nie potrzebują kluczy API. Takie deklaracje znajdź i sprawdź w kodzie, zanim cokolwiek uruchomisz.

Od czego zacząć

Wybierz zadanie, które w tym miesiącu robisz już trzeci raz, i napisz dla niego pierwszy SKILL.md, nawet krótki. Nie masz jeszcze Claude Code? Zacznij od poradnika Claude Code od zera. Całą drogę od czatu do automatyzacji pokazuje Mapa startu z AI.