Skille do Claude to foldery z plikiem SKILL.md, w którym zapisujesz instrukcje dla modelu, a obok możesz dołożyć skrypty i szablony. Claude czyta je sam, kiedy zadanie pasuje do opisu skilla. Instalujesz je w Claude Code (folder albo plugin), w Claude.ai (plik ZIP) lub przez API, a zacząć najlepiej od oficjalnego repozytorium Anthropic.
TL;DR
- Skill to folder z
SKILL.md. W kontekście siedzi stale tylko jego nazwa i opis, reszta ładuje się, gdy jest potrzebna.- W Claude Code kładziesz skill w
~/.claude/skills/(dla siebie) albo w.claude/skills/w repo (dla zespołu), albo instalujesz plugin.- W Claude.ai potrzebujesz włączonego wykonywania kodu, a własny skill wgrywasz jako ZIP.
- Skill to wiedza i procedura, serwer MCP to dostęp do narzędzi i danych.
- Instaluj tylko z zaufanych źródeł i czytaj pliki przed instalacją.
Czym jest skill w Claude
Najkrótsza definicja pochodzi z dokumentacji Anthropic: „Agent Skills are modular capabilities that extend Claude's functionality. Each Skill packages instructions, metadata, and optional resources (scripts, templates) that Claude uses automatically when relevant.”
W praktyce wygląda to tak: masz katalog, na przykład humanizer/, a w nim plik SKILL.md. Plik zaczyna się od nagłówka YAML z dwoma wymaganymi polami:
---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---
(tu instrukcje dla Claude)Pole name może mieć najwyżej 64 znaki, tylko małe litery, cyfry i dywizy, bez słów zastrzeżonych „anthropic” i „claude”. Pole description ma najwyżej 1024 znaki i powinno mówić, co skill robi i kiedy go użyć. To właśnie opis decyduje, czy Claude w ogóle sięgnie po skill, więc pisze się go starannie. Więcej o tym w poradniku jak napisać dobry SKILL.md.
Progressive disclosure, czyli dlaczego skille nie zjadają kontekstu
Skill ładuje się warstwami. Na starcie Claude widzi tylko metadane, czyli nazwę i opis, według dokumentacji około 100 tokenów na skill. Treść SKILL.md (Anthropic zaleca, żeby mieściła się poniżej 5 tys. tokenów) trafia do kontekstu dopiero wtedy, gdy skill pasuje do zadania. Pliki dodatkowe i skrypty Claude otwiera albo uruchamia dopiero na żądanie.
Dzięki temu możesz mieć zainstalowanych sporo skilli, a model nie dźwiga ich pełnej treści w każdej rozmowie. Jeśli walczysz z kosztami kontekstu, zajrzyj też do przewodnika o optymalizacji tokenów w Claude Code.
Gdzie działają skille do Claude
Skille działają w trzech miejscach, ale każde ma własne zasady. Ważna rzecz na start: własne skille nie synchronizują się między powierzchniami. Skill wgrany przez API nie pojawi się sam w Claude.ai i odwrotnie.
| Miejsce | Gdzie leży skill | Jak instalujesz | Na co uważać |
|---|---|---|---|
| Claude Code | ~/.claude/skills/, .claude/skills/ w repo, katalog skills/ w pluginie | Kopiujesz folder albo instalujesz plugin komendą /plugin | Skill z pluginu wywołujesz jako /plugin-name:skill-name |
| Claude.ai | Na koncie, w Customize > Skills | Włączasz gotowy skill albo wgrywasz ZIP | Wymaga włączonego wykonywania kodu; własne skille na planach indywidualnych są prywatne dla konta |
| API | Po stronie platformy, wskazywane przez skill_ids | Parametr container plus narzędzie code execution | Brak dostępu do sieci i instalacji pakietów w czasie działania |
Jak zainstalować skill krok po kroku
Claude Code: folder
Najprostsza droga. Skill osobisty, dostępny we wszystkich projektach:
~/.claude/skills/<nazwa>/SKILL.mdSkill projektowy, który commitujesz razem z kodem, żeby miał go cały zespół:
.claude/skills/<nazwa>/SKILL.mdClaude Code obserwuje te katalogi i łapie zmiany bez restartu. Starszy format z katalogu .claude/commands/ nadal działa. Domyślnie skill może uruchomić zarówno Claude (sam, na podstawie opisu), jak i Ty, wpisując /nazwa. Możesz to zmienić we frontmatterze: disable-model-invocation: true sprawia, że Claude nie wywoła skilla sam, a user-invocable: false zostawia go tylko dla Claude.
Claude Code: plugin z marketplace'u
Gotowe paczki skilli instalujesz jako pluginy. Oficjalne repozytorium Anthropic dodajesz jako marketplace:
/plugin marketplace add anthropics/skillsPotem w menu wybierasz „Browse and install plugins”, marketplace anthropic-agent-skills i paczkę document-skills albo example-skills. Można też od razu:
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skillsNiektóre projekty mają własne instalatory. Vercel instaluje się przez npx skills add vercel-labs/agent-skills, a UI/UX Pro Max ma osobne CLI. Zawsze sprawdzam w README, co dokładnie robi taki instalator.
Claude.ai: włączenie i upload ZIP
- Włącz wykonywanie kodu: Settings > Capabilities, opcja „Code execution and file creation” (w nowszym układzie „Create and edit files”).
- Gotowe skille włączasz w Customize > Skills.
- Własny skill spakuj do ZIP tak, żeby folder skilla był korzeniem archiwum.
- Wejdź w Customize > Skills, kliknij „+”, potem „+ Create skill” i „Upload a skill”.
Co do planów: centrum pomocy wymienia Free, Pro, Max, Ultra, Team i Enterprise, a strona przeglądowa platformy pomija Free. Pewne jest jedno: bez włączonego wykonywania kodu skille nie ruszą. W planach Team i Enterprise właściciel może wyłączyć tworzenie skilli albo udostępnić skille całej organizacji (Organization settings > Plugins & skills). Skille włączone w Claude.ai ładują się też w Claude Code po zalogowaniu tym samym kontem, od wersji Claude Code v2.1.273. Szczegóły są w artykule Use skills in Claude.
API
W API skill wskazujesz przez skill_ids w parametrze container i potrzebujesz narzędzia code execution. Środowisko nie ma dostępu do sieci i nie zainstaluje pakietów w trakcie działania, więc skill musi mieć wszystko, czego potrzebuje, w sobie.
Skill, prompt czy serwer MCP
Te trzy rzeczy często się mylą, a odpowiadają na różne pytania.
- Prompt piszesz raz, w jednej rozmowie. Jeśli powtarzasz te same instrukcje co tydzień, to sygnał, że powinny trafić do skilla.
- Skill to spakowana wiedza i procedura: jak coś zrobić, według jakich zasad, z jakimi szablonami. Claude sięga po niego sam, kiedy zadanie pasuje.
- Serwer MCP podłącza Claude do zewnętrznych narzędzi i danych: bazy, API, kalendarza. Daje dostęp, nie mówi, jak z niego korzystać.
W praktyce łączę jedno z drugim. Serwer MCP daje dostęp do danych, a skill opisuje, jak z tymi danymi pracować.
Od których skilli zacząć
Nie zaczynaj od dwudziestu instalacji. Wybierz jeden lub dwa skille, które pasują do pracy, którą robisz co tydzień. Moja krótka lista (gwiazdki według GitHuba, listopad 2026):
- anthropics/skills (187 751 gwiazdek, listopad 2026). Oficjalne repozytorium Anthropic: m.in. docx, pdf, pptx, xlsx, frontend-design, mcp-builder, webapp-testing i skill-creator do tworzenia własnych skilli. Najbezpieczniejszy punkt startu.
- frontend-design z tego samego repo. Skill do projektowania interfejsów, który walczy z szablonowym wyglądem. Rozebrałem go na części w artykule co jest w SKILL.md skilla frontend-design.
- UI/UX Pro Max (145 698 gwiazdek, listopad 2026, licencja MIT). Baza palet, fontów i wytycznych UX z wyszukiwarką. Instalację, test i audyt skryptów opisałem w tekście UI/UX Pro Max: instalacja, test, bezpieczeństwo.
- obra/superpowers (313 001 gwiazdek, listopad 2026, MIT). Zestaw skilli do metodyki pracy programisty: planowanie, TDD, debugowanie, code review. Instalacja:
/plugin install superpowers@claude-plugins-official. - vercel-labs/agent-skills (33 598 gwiazdek, listopad 2026). Skille Vercela, m.in. react-best-practices i web-design-guidelines.
Pełniejsze zestawienie z opisem każdej pozycji jest w artykule najlepsze skille do Claude Code w 2026, a skille do projektowania zebrałem w kompletnym przewodniku po skillach do UI.
Jak sam używam skilli
W ~/.claude/skills mam 26 skilli (stan na 6 listopada 2026). Część zainstalowałem gotowych: docx, pdf, xlsx i ui-ux-pro-max. Resztę napisałem sam, bo dotyczą mojej pracy, a nie ogólnych zadań.
- humanizer pilnuje stylu tekstów po polsku, między innymi zakazu półpauz.
- fact-checker wymaga, żeby każda liczba miała źródło.
- remove-ai-marks czyści tekst z niewidocznych znaków.
- higiena-sekretow i debug-protocol to procedury, których nie chcę powtarzać w każdej rozmowie.
- oferty-sprzedazowe, linkedin-post i site-audit obsługują powtarzalne zadania w firmie.
Skillowi UI/UX Pro Max przepisałem opis po polsku, żeby uruchamiał się na moje polskie prompty. To dobry przykład, jak bardzo description decyduje o działaniu skilla.
Mam też skille zespołowe, team-dev i team-mar, które orkiestrują wielu subagentów. Ten artykuł powstał właśnie w takim pipeline, z fact-checkerem i humanizerem po drodze. Skille trzymam jako symlinki z jednego katalogu (~/.agents/skills) i ściśle oddzielam prywatne od firmowych: firmowe leżą w osobnym .claude/skills w repozytorium firmy.
Bezpieczeństwo
Skill może zawierać skrypty, które Claude uruchamia na Twoim komputerze lub w środowisku wykonawczym. Dokumentacja Anthropic mówi wprost: „Use Skills only from trusted sources: those you created yourself or obtained from Anthropic.” Dalej: „Audit thoroughly: Review all files bundled in the Skill.” oraz „External sources are risky.”
To nie jest teoretyczne ryzyko. Snyk w raporcie ToxicSkills (luty 2026) przeskanował 3 984 skille z ClawHub i skills.sh. 1 467 z nich (36,82%) miało co najmniej jedną lukę bezpieczeństwa, a 534 (13,4%) co najmniej jedną lukę krytyczną. Badacze potwierdzili też 76 złośliwych payloadów: kradzież danych logowania, backdoory, wyciek danych.
Moja zasada: zanim zainstaluję cudzy skill, czytam SKILL.md i każdy skrypt w folderze. Sprawdzam, czy skrypty łączą się z siecią i co zapisują na dysku. Liczba gwiazdek na GitHubie nie zastępuje tego przeglądu. Firmy na Claude Enterprise mogą dodatkowo włączyć skanowanie treści własnych skilli wgrywanych w Claude.ai i Cowork. Pamiętaj też, że Agent Skills nie są objęte ZDR (zero data retention).
FAQ
Czym są skille do Claude?
To foldery z plikiem SKILL.md, w którym są instrukcje i metadane, a obok opcjonalnie skrypty i szablony. Claude ładuje skill sam, gdy zadanie pasuje do jego opisu. Według dokumentacji Anthropic skill pakuje instrukcje, metadane i zasoby, z których Claude korzysta automatycznie, kiedy są potrzebne.
Gdzie zainstalować skill w Claude Code?
Skill osobisty trafia do ~/.claude/skills/nazwa/SKILL.md i działa we wszystkich projektach. Skill projektowy trafia do .claude/skills/nazwa/SKILL.md w repozytorium, więc możesz go zacommitować dla zespołu. Trzecia droga to pluginy instalowane komendą /plugin.
Czy skille działają w Claude.ai bez Claude Code?
Tak, ale wymagają włączonego wykonywania kodu w ustawieniach. Skille włączasz w Customize > Skills, a własny skill wgrywasz jako plik ZIP przez Upload a skill. Centrum pomocy podaje, że skille są dostępne także w planie Free.
Czym skill różni się od serwera MCP?
Serwer MCP podłącza Claude do zewnętrznych narzędzi i danych. Skill to spakowana wiedza i instrukcje, czyli sposób, w jaki Claude ma wykonać zadanie. Często używa się ich razem.
Czy instalowanie skilli z GitHuba jest bezpieczne?
Tylko z zaufanych źródeł. Anthropic zaleca skille, które napisałeś sam albo dostałeś od Anthropic, i pełny przegląd wszystkich plików skilla. Przed instalacją przeczytaj SKILL.md i każdy dołączony skrypt.
Czytaj dalej
Jeśli chcesz napisać własny skill, zacznij od dobrych praktyk pisania SKILL.md. Gotowe propozycje znajdziesz w zestawieniu najlepszych skilli do Claude Code, a dwa skille do designu opisałem osobno: frontend-design i UI/UX Pro Max. Pod artykułem czeka darmowa paczka dwóch skilli do pracy z UX: Laws of UX i szablon design systemu.