Claude Skills – co to jest, jak dodać gotowy skill i stworzyć własny

Claude Skills (nazywane też Agent Skills) to ustrukturyzowane foldery z plikiem instrukcji SKILL.md oraz opcjonalnymi skryptami i szablonami, które uczą model wykonywania powtarzalnych procedur. W praktyce oznacza to, że zamiast wklejać te same wytyczne w każdej rozmowie, zapisujesz proces raz, a asystent wczytuje go automatycznie tylko wtedy, gdy Twoje polecenie pasuje do opisu umiejętności. Z funkcji skorzystasz w przeglądarce claude.ai, aplikacji komputerowej, terminalu Claude Code oraz przez API (stan na październik 2026).

Jak dodać skill do Claude – instrukcja dla claude.ai, Claude Code i API

Aby dodać skill do Claude w przeglądarce lub aplikacji komputerowej, musisz najpierw aktywować środowisko wykonywania kodu, a następnie włączyć gotowe pakiety lub przesłać własny folder w panelu personalizacji. Funkcja działa w planach Free, Pro, Max, Team oraz Enterprise (stan na październik 2026). Jeśli dopiero zaczynasz pracę z czatem, sprawdź też poradnik, jak używać Claude AI na co dzień.

Dodawanie skilli w claude.ai i aplikacji Claude Desktop

1. Włącz wykonywanie kodu: Kliknij ikonę profilu w lewym dolnym rogu, wejdź w Settings > Capabilities (Ustawienia > Możliwości) i włącz przełącznik Code execution and file creation. W planie Team opcja jest domyślnie aktywna dla organizacji, a w planie Enterprise właściciel włącza ją w menu Organization settings > Plugins & skills.
2. Przejdź do sekcji umiejętności: Otwórz Customize > Skills z paska bocznego (lub wejdź przez Settings > Capabilities > Skills). Inne przydatne przełączniki zebraliśmy we wpisie omawiającym 5 ukrytych ustawień Claude AI.
3. Włącz gotowy skill lub prześlij własny: Aktywuj wybrane pakiety przykładowe od Anthropic albo kliknij przycisk przesyłania, aby wgrać folder lub archiwum .zip z plikiem SKILL.md w katalogu głównym. Szczegóły znajdziesz w oficjalnej instrukcji obsługi skilli w centrum pomocy Claude.

W planach Pro, Max oraz Team w aplikacji na macOS (w trybie Cowork) dostępna jest też funkcja Record a skill (stan na październik 2026). Pozwala ona nagrać kliknięcia na ekranie, wpisywany tekst i głos, na podstawie których Claude automatycznie generuje gotowy skill.

Dodawanie i używanie skilli w Claude Code oraz API

W terminalu i rozszerzeniu IDE Claude Code umiejętności dodaje się przez zapisanie folderu na dysku lub instalację wtyczki (dawne komendy z .claude/commands/ zostały zunifikowane ze skillami):

1. Skille osobiste: Umieść plik w ~/.claude/skills/<nazwa>/SKILL.md, aby korzystać z niego we wszystkich swoich projektach na komputerze.
2. Skille projektowe: Zapisz plik w .claude/skills/<nazwa>/SKILL.md wewnątrz repozytorium (możesz go dodać do Gita i udostępnić zespołowi).
3. Wtyczki i synchronizacja: Użyj komendy /plugin install w terminalu lub zaloguj się na konto claude.ai – skille włączone w przeglądarce synchronizują się automatycznie z sesjami Claude Code oraz Cowork.
4. Claude API: W zapytaniu POST /v1/messages włącz narzędzie code_execution, wgraj paczkę przez endpoint /v1/skills i wskaż jej identyfikator w parametrze container (type: "anthropic" lub type: "custom").

Zastanawiasz się, jak używać skilli w Claude podczas rozmowy? Możesz napisać zwykłe polecenie pasujące do opisu umiejętności (model załaduje ją sam), wpisać /nazwa-skilla [argumenty] na początku wiadomości (natychmiastowe uruchomienie) albo umieścić /nazwa-skilla w środku zdania, dając asystentowi uprawnienie do użycia procedury w trakcie odpowiedzi.

Odtwórz film na YouTube

Film: jak nauczyć Claude’a swojej pracy za pomocą skilli, po polsku. Autorka: Julia Jakubowska (YouTube, sierpień 2026).

Co to jest skill w Claude i jak działa ładowanie na żądanie?

Wyjaśniając najprościej, co to jest skill w Claude: to podręcznik procedur (runbook) zapisany w folderze, który instruuje model, jak krok po kroku realizować określony typ zadań. Zamiast zapychać pamięć czatu wszystkimi regułami naraz, Claude Skills działają w oparciu o trójstopniowe ładowanie na żądanie (Progressive Disclosure):

1. Wykrywanie (Discovery): Na starcie sesji model wczytuje wyłącznie nazwy (name) i krótkie opisy (description) aktywnych skilli (ok. 100 tokenów na wpis).
2. Aktywacja (Activation): Gdy Twoje pytanie pokrywa się z opisem lub wpiszesz komendę z ukośnikiem, do kontekstu trafia pełna instrukcja z pliku SKILL.md (zalecany rozmiar to poniżej 500 linii i 5000 tokenów).
3. Wykonanie (Execution): Dokumentacja z podkatalogu references/, szablony z assets/ oraz skrypty z scripts/ są odczytywane lub uruchamiane w kontenerze dopiero wtedy, gdy wymaga tego konkretny krok. Kod skryptu nie obciąża rozmowy – do czatu trafia sam wynik jego działania.

Twórcy dzielą te narzędzia na dwie grupy: pakiety podnoszące możliwości modelu (Capability Uplift Skills, np. do projektowania UI czy zaawansowanych arkuszy) oraz pakiety kodujące procedury firmowe (Encoded Preference Skills, wymuszające realizację zadań w stałej kolejności). Format ten stanowi otwarty standard Agent Skills – poza narzędziami Anthropic standard obsługuje też m.in. Codex, Cursor i GitHub Copilot.

Gotowe skille Claude – oficjalne pakiety i katalogi wtyczek

Zanim stworzysz własny pakiet, przetestuj gotowe skille Claude utrzymywane przez Anthropic. W claude.ai oraz API dostępne są cztery moduły dokumentowe:

• docx – tworzenie, edycja i formatowanie dokumentów Microsoft Word.
• xlsx – budowa arkuszy Excel z działającymi formułami i analizą danych.
• pptx – generowanie prezentacji PowerPoint z układami slajdów i wykresami.
• pdf – ekstrakcja tekstu i tabel z plików PDF, łączenie dokumentów i wypełnianie formularzy.

Pełny katalog w oficjalnym repozytorium anthropics/skills na GitHubie obejmuje 19 oficjalnych skilli (stan na październik 2026). Najważniejsze z nich to skill-creator (interaktywny kreator i ewaluator przeprowadzający testy A/B oraz zapisujący pomiar tokenów w benchmark.json), frontend-design (tworzenie interfejsów webowych bez generycznego wyglądu AI), webapp-testing (testy z Playwright), mcp-builder, doc-coauthoring, brand-guidelines oraz claude-api. Z kolei Claude Code oferuje wbudowane komendy diagnostyczne i robocze: /doctor, /skill-doctor, /code-review, /batch, /debug, /loop i /verify.

Aby zainstalować oficjalne pakiety w terminalu Claude Code, użyj poniższych poleceń (zamiast [nazwa-pakietu] możesz podać dowolny zestaw z marketplace’u):

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills
/plugin install skill-creator@claude-plugins-official
/plugin install [nazwa-pakietu]@anthropic-agent-skills

Sprawdź również popularne rozszerzenia społecznościowe, takie jak wtyczka Superpowers z pakietem skilli do Claude Code, albo zobacz praktyczne wdrożenie biznesowe pokazujące zespół marketingowy z Claude Skills.

Jak stworzyć własny skill krok po kroku (struktura folderu i SKILL.md)

Budowa własnej umiejętności polega na utworzeniu katalogu z plikiem SKILL.md zawierającym nagłówek YAML oraz instrukcję Markdown.

1. Utwórz folder główny: Nazwij go używając wyłącznie małych liter (a-z), cyfr (0-9) i pojedynczych myślników. Wewnątrz umieść wymagany plik SKILL.md oraz opcjonalne podkatalogi: scripts/ (skrypty Python/Bash), references/ (dodatkowa dokumentacja) i assets/ (szablony). Odwołuj się do nich ścieżkami względnymi bezpośrednio z SKILL.md, unikając wielopoziomowego zagnieżdżania odnośników.
2. Dodaj nagłówek YAML Frontmatter: Otwierający znacznik --- musi znajdować się w pierwszej linijce pliku. Wpisz wymagane pola name oraz description.
3. Dobierz stopień swobody w instrukcji: Nie tłumacz modelowi podstawowych pojęć. Użyj wysokiej swobody (wskazówek tekstowych) do redakcji i code review, średniej swobody (szablonów z parametrami) do raportów, lub niskiej swobody (gotowej komendy skryptu bez zmiany flag, np. python scripts/migrate.py --verify) przy operacjach ryzykownych.

Poniższa tabela podsumowuje pola konfiguracyjne YAML Frontmatter i ich limity (stan na październik 2026):

W Claude Code możesz też wstrzykiwać dane na żywo za pomocą składni !`komenda` (np. !`git diff HEAD` wykonuje polecenie w terminalu i wstawia wynik do promptu przed wysłaniem go do modelu), korzystać ze zmiennych ${CLAUDE_SKILL_DIR} i ${CLAUDE_PROJECT_DIR} oraz wymusić głębokie myślenie słowem ultrathink. Wszystkie opcje opisuje dokumentacja skilli w Claude Code.

Przykładowy SKILL.md do skopiowania i jak go przetestować

Poniższy szablon zapisz jako audyt-tresci/SKILL.md. Przeprowadza on powtarzalną kontrolę artykułów i dokumentacji. Przed użyciem podmień zmienne w nawiasach kwadratowych: [nazwa-marki], [grupa-docelowa] oraz [maks-zdan]. Więcej gotowych konstrukcji znajdziesz na liście prezentującej 10 skutecznych promptów dla Claude AI.

---
name: audyt-tresci
description: Przeprowadza techniczny i językowy audyt artykułów oraz dokumentacji. Używaj, gdy użytkownik prosi o sprawdzenie tekstu, korektę, ocenę czytelności lub pisze "zrób audyt tekstu", "sprawdź artykuł", "popraw szkic".
argument-hint: "[sciezka-lub-tekst]"
---
# Procedura audytu treści dla [nazwa-marki]
Przeanalizuj materiał z `$ARGUMENTS` (lub wklejony w czacie) pod kątem grupy docelowej: [grupa-docelowa].
## Kroki weryfikacji
1. Sprawdź, czy pierwszy akapit od razu odpowiada na główne pytanie tematu.
2. Wypisz akapity dłuższe niż [maks-zdan] zdań i zaproponuj ich skrócenie.
3. Zamień stronę bierną na czynną i usuń ogólniki marketingowe.
## Format wyniku
Zwróć odpowiedź w 3 punktach: Błędy krytyczne (przed/po), Brakujące informacje, Gotowy tekst po korekcie.

Możesz też wygenerować plik automatycznie za pomocą kreatora skill-creator. Wklej ten prompt do czatu, podmieniając [twoje-zadanie] oraz [format-wyniku]:

Użyj skilla skill-creator i stwórz dla mnie plik SKILL.md. Moje powtarzalne zadanie to: [twoje-zadanie]. Wynik ma mieć formę: [format-wyniku]. Zadbaj o precyzyjne pole description ze słowami kluczowymi wyzwalacza.

Aby przetestować gotowy pakiet, sprawdź jego składnię komendą claude plugin validate .claude/skills (lub skills-ref validate ./audyt-tresci), a następnie zadaj w nowym czacie pytanie zawierające słowa z pola description bez wpisywania ukośnika, weryfikując, czy procedura włączy się automatycznie.

Claude Skills vs Projects vs MCP vs własne instrukcje – kiedy co wybrać?

Wybór między Claude Skills, Projektami, protokołem MCP a plikiem CLAUDE.md zależy od tego, czy potrzebujesz powtarzalnej procedury, statycznej bazy plików, połączenia z API czy stałych reguł ogólnych:

Najczęstsze błędy przy tworzeniu skilli i zasady bezpieczeństwa

Jeśli Twój pakiet nie działa zgodnie z planem, przyczyną jest zazwyczaj konstrukcja opisu lub przekroczenie limitu pamięci podczas długiej sesji:

• Skill nie uruchamia się automatycznie („Pułapka grzecznego opisu”): Zamiast ogólnej etykiety „Pomocnik do PDF” wpisz w description konkretne czasowniki i sytuacje: „Używaj, gdy użytkownik prosi o wyciągnięcie tabel z PDF, łączenie plików lub wypełnienie formularza”. Upewnij się też, że znacznik --- jest w pierwszej linii pliku (diagnostyka w Claude Code: /doctor, /skill-doctor lub claude --debug).
• Skill włącza się zbyt często: Zawęź opis w description lub ustaw w nagłówku disable-model-invocation: true, aby odpalać go wyłącznie ręcznie komendą /nazwa.
• Model gubi zasady w długiej rozmowie: Po automatycznym podsumowaniu kontekstu (auto-compaction) Claude Code przywraca tylko pierwsze 5000 tokenów każdego ostatnio użytego skilla (przy łącznym budżecie 25 000 tokenów na wszystkie przywracane skille). Najważniejsze reguły umieszczaj zawsze na początku pliku SKILL.md.

Zachowaj też ostrożność przy pobieraniu paczek z internetu. Ponieważ skille do Claude mogą zawierać wykonywalne skrypty w scripts/ oraz komendy powłoki !`cmd`, przed instalacją przejrzyj kod wszystkich plików, nigdy nie wpisuj w nich kluczy API ani haseł, a podczas testowania nieznanych narzędzi w Claude Code zablokuj wykonywanie komend powłoki ustawieniem "disableSkillShellExecution": true w pliku settings.json.

Najczęściej zadawane pytania (FAQ)