Wprowadzenie do Agent Skills

Agent Skills to foldery z plikiem SKILL.md (nazwa, opis i instrukcje), które Claude Code, Codex i Cursor ładują na żądanie. Agent w każdej sesji zna nazwę i opis każdego skilla, a jego treść czyta dopiero wtedy, gdy zadanie do niego pasuje. Skill trafia do projektu jako przenośna kopia z npx skills add albo w pluginie.

W poniedziałek wyjaśniłeś agentowi checklistę wydania. We wtorek nowa sesja zrobiła merge bez kroku z changelogiem, a kolega pracujący w Codeksie w ogóle jej nie dostał. Ta strona jest dla programistów i tech leadów, którzy chcą zapisać taką wiedzę raz i przypiąć ją dla każdego agenta.

Czym jest skill i czym różni się od MCP i pluginu?

Skill to instrukcje, a nie połączenie na żywo: nie ma własnych poświadczeń ani serwera. Jeśli coś pobiera, to przez dołączone skrypty lub polecenia, które agent uruchamia z własnymi uprawnieniami. Format jest otwartym standardem (od 2025-12-18): folder skill-name/SKILL.md, którego pole name we frontmatterze ma najwyżej 64 znaki, a description najwyżej 1024. 26 września 2026 roku galeria specyfikacji wymieniała 46 zgodnych klientów.

---
name: release-checklist
description: Use when preparing a release or merging to main. Runs the changelog, version bump and smoke-test steps in order.
---
1. Update CHANGELOG.md from merged PR titles since the last tag.
2. Bump the version with `npm version minor --no-git-tag-version`.
3. Run `npm run smoke` and paste the last 20 lines of output before you say "done".

Pole description decyduje, kiedy skill się uruchomi, więc pisz je jako warunek wyzwalający; do tego momentu skill kosztuje kilkadziesiąt tokenów.

Warstwa	Co daje agentowi	Wybierz ją, gdy
Skill	Procedurę albo konwencję	Agent ma stosować praktykę: TDD, checklistę wydania
Serwer MCP	Narzędzia i dane na żywo	Agent musi czytać lub zmieniać stan zewnętrzny: PR-y, zgłoszenia, bazę danych
Plugin	Pakiet skilli, poleceń, subagentów, hooków i serwerów MCP	Chcesz mieć skille i narzędzia dostawcy połączone razem albo hook, który uruchamia metodę

Przewodnik decyzyjny po wszystkich sześciu warstwach znajdziesz w artykule jak skille, MCP, pluginy i frameworki do siebie pasują.

Gdzie każdy agent szuka skilli i jak je wywołać?

Każdy agent czyta inne katalogi, dlatego CLI skills zapisuje jedną kanoniczną kopię w .agents/skills/ i tworzy do niej dowiązanie symboliczne w .claude/skills/ dla Claude Code.

	Claude Code	Codex	Cursor
Skille projektu	.claude/skills/<name>/, także w katalogach nadrzędnych	.agents/skills/<name>/, od katalogu roboczego w górę do korzenia repozytorium	.agents/skills/, .cursor/skills/, .claude/skills/ i .codex/skills/
Skille osobiste	~/.claude/skills/	~/.agents/skills/ według dokumentacji OpenAI; npx skills add -g zapisuje do ~/.codex/skills/	~/.cursor/skills/, ~/.agents/skills/ (oraz ścieżki zgodności .claude/.codex)
Wywołanie po nazwie	/<name>; skille z pluginów to /<plugin>:<skill>	$<name>; /skills pokazuje listę	Nazwij skill w prompcie
Wbudowane	/code-review, /simplify, /verify, /run, /batch, /loop (wyłączysz je ustawieniem disableBundledSkills)	skill-creator, skill-installer, plugin-creator	/loop

Sprawdzone 26 września 2026 roku w dokumentacji Claude Code 2.1.283 i w zainstalowanym codex-cli 0.157.1. Katalog osobisty Codeksa i wszystkie ścieżki Cursora pochodzą z dokumentacji dostawców (źródło wtórne, niesprawdzone ponownie 26 września 2026).

Zainstaluj jeden skill na dwa sposoby: plugin czy przenośna kopia?

Skill frontend-design od Anthropic istnieje zarówno jako plugin w claude-plugins-official, jak i jako folder w anthropics/skills. 26 września 2026 roku plugin miał 1 134 112 instalacji w katalogu Claude Marketplace (claude.com/plugins), a przenośna kopia 923 303 w skills.sh (źródło wtórne: zrzut LinklyAI/best-skills, 26 września 2026).

Claude Code

Droga przez plugin (terminal):

claude plugin install frontend-design@claude-plugins-official --scope project
claude plugin details frontend-design     # lista komponentów i stały koszt w tokenach

Wywołujesz go jako /frontend-design:frontend-design; --scope project zapisuje go w .claude/settings.json dla całego zespołu. 26 września 2026 roku claude plugin details frontend-design pokazało około 78 tokenów stale obecnych w kontekście.

Droga przez przenośną kopię (terminal):

npx skills add anthropics/skills --skill frontend-design -a claude-code

Wywołujesz go jako /frontend-design. Wybierz jedną drogę, inaczej dostaniesz dwie kopie.

Codex

Droga przez przenośną kopię (terminal):

npx skills add anthropics/skills --skill frontend-design -a codex

Pliki trafiają do .agents/skills/frontend-design/. Wywołaj skill przez $frontend-design albo wpisz /skills, żeby sprawdzić, czy Codex go widzi. O pluginach Codeksa (w 0.157.1 codex plugin add, nie install) pisze strona pluginy i marketplace’y.

Cursor

Droga przez przenośną kopię (terminal):

npx skills add anthropics/skills --skill frontend-design -a cursor

Pliki trafiają do .agents/skills/frontend-design/. Pluginy Cursor instaluje z czatu Agenta poleceniem /add-plugin <name>, według repozytorium pluginów Cursora (nieuruchomione w binarce Cursora).

Wybierz plugin, gdy metoda zależy od hooka, polecenia albo serwera MCP: przenośna kopia Superpowers nie ma mechanizmu uruchamianego na starcie sesji (hook SessionStart), więc jej workflow nie startuje sam. Wybierz przenośną kopię, gdy zespół pracuje w więcej niż jednym agencie; przypinasz ją do commita w skills-lock.json.

Prompt do skopiowania: sprawdź, która kopia się załadowała

List every skill you can see in this session, with the directory or plugin each one comes from. If any skill appears twice, name both sources and tell me which one you would use. Then, for frontend-design only: quote its description, say whether you would load it for "restyle the pricing table in src/components/Pricing.tsx", and name the first two instructions you would apply. Do not edit any file.

Od „potrzebuję X” do przypiętej instalacji zespołowej

1. Wyszukaj kandydatów i wybieraj kanonicznego właściciela, bo podróbki podszywają się pod popularne nazwy: npx skills find changelog.

2. Przeczytaj przed instalacją SKILL.md i każdy dołączony skrypt, bo skille działają z pełnymi uprawnieniami agenta.

   npx skills add anthropics/skills --list
   npx skills use anthropics/skills@frontend-design    # wypisuje prompt, niczego nie instaluje

3. Przypnij do commita, instalując skill w rewizji, którą wypisuje git ls-remote, od razu dla wszystkich trzech agentów.

   git ls-remote https://github.com/anthropics/skills HEAD
   npx skills add anthropics/skills#COMMIT_SHA --skill frontend-design -a claude-code -a codex -a cursor -y

4. Zacommituj i zrecenzuj .agents/skills/, .claude/skills/ i skills-lock.json w jednym pull requeście, z właścicielem kodu (code owner) dla katalogów skilli.

5. Udowodnij, że działa, uruchamiając prompt akceptacyjny w każdym agencie, a przypięcie przesuwaj tylko przez powtórzenie kroku 3 (npx skills update zachowuje zapisany ref).

Prompt do skopiowania: zweryfikuj skill, zanim przyjmie go zespół

I need a skill that writes CHANGELOG.md entries from merged pull requests in Keep a Changelog format. Run `npx skills find changelog` and pick the three strongest candidates. For each one, give the owner/repo, the skill name from its SKILL.md frontmatter, and every script or shell command the skill would run. Flag any network call, any write outside the repository, and any hook. Recommend one and write the pinned install command for claude-code, codex and cursor. Do not install anything.

Skąd wiesz, że skill działa, bez czytania każdego diffu?

• Ładuje się. Pokazuje go /skills w Codeksie, /context w Claude Code albo pierwszy prompt powyżej.
• Uruchamia się przy właściwym zadaniu. Poproś agenta, żeby go użył i oznaczył każdą numerowaną instrukcję jako wykonaną, pominiętą albo nie dotyczy, obok diffu i wyniku testów.
• Nie dryfuje. Foldery skilli i skills-lock.json zmieniają się tylko w zrecenzowanym pull requeście; krok CI, który uruchamia npx -y skills@1.7.0 experimental_install, a potem git diff --exit-code -- .agents/skills skills-lock.json, kończy się błędem, gdy ktoś ręcznie zmienił zacommitowany skill albo gdy nieprzypięte lub przypięte do gałęzi źródło zmieniło się u źródła.
• Pluginy mogą mieć ewaluacje. claude plugin eval uruchamia zestaw ewaluacji pluginu i porównuje go z wariantem bez pluginu.

Jak napisać własny skill z ewaluacjami, opisuje artykuł budowanie i publikowanie własnych skilli.

Gdy skill się nie ładuje, nie uruchamia albo uruchamia dwa razy

Pułapki sprawdzone 26 września 2026 roku (CLI skills 1.7.0)

• --skill=grill-me jest po cichu ignorowane, więc z -y CLI instaluje każdy skill z repozytorium. Używaj --skill grill-me albo -s.
• --skill dopasowuje pole name z frontmattera, a nie nazwę folderu: vercel-react-best-practices zadziała, react-best-practices nie.
• Niektóre skille delegują: grill-me Matta Pococka wywołuje grilling, więc zainstaluj oba.
• Kilka niepowiązanych repozytoriów publikuje „superpowers”; kanoniczne to obra/superpowers.

Skill nigdy się nie uruchamia. Przepisz opis w formie „Use when…” ze słowami, których ludzie naprawdę używają, i sprawdź go pierwszym promptem.

Skill pojawia się dwa razy. Zostaw jedną drogę: claude plugin uninstall <plugin> albo npx skills remove <skill>.

/code-review uruchamia coś innego. Wbudowany skill Claude Code zajmuje gołą nazwę; plugin od Anthropic uruchamiasz jako /code-review:code-review.

Dwa skille sobie przeczą. Użyj Dr. Skill, żeby znaleźć kolidujące opisy, a potem usuń jeden z nich.

Instalacje globalne, odtwarzanie z pliku blokady i aktualizacje opisuje strona instalowanie, udostępnianie i przypinanie skilli.

Dokąd dalej z Agent Skills

Instalowanie, udostępnianie i przypinanie skilli Wszystkie polecenia CLI skills, zakresy, aktualizacje i usuwanie.

Bezpieczeństwo łańcucha dostaw skilli Co może zrobić złośliwy skill i jak go zrecenzować.

25 najczęściej instalowanych skilli praktyk Skille do planowania, TDD, debugowania i code review.

Pluginy i marketplace'y Co zawiera plugin i jak go przypiąć.

Oficjalne skille od twórców technologii Skille utrzymywane przez dostawców platform, na które wdrażasz.

Superpowers Metoda od projektu do PR: skille i hook na starcie sesji.