Instalowanie, udostępnianie i przypinanie skilli w zespole

CLI skills (pakiet npm skills 1.7.0) instaluje Agent Skills z repozytorium GitHub do Claude Code, Codeksa i Cursora poleceniem npx skills add, a każdą instalację projektową zapisuje w skills-lock.json. Zespół udostępnia skille, commitując ich katalogi i ten lockfile. Przypnij każde źródło do taga lub commita przez owner/repo#ref; lockfile bez refa odtwarza najnowszą wersję z upstreamu.

Ta strona jest dla programisty, który instaluje skille, i dla tech leada, który musi utrzymać ośmiu ludzi na tym samym zestawie. Sytuacja, którą rozwiązuje: agent kolegi pisze testy najpierw, a twój nie, nikt nie wie, które skille ładuje każda maszyna, a zeszłotygodniowe npx skills update zmieniło zachowanie, którego nikt nie przejrzał.

Co daje zespołowi przypięty, wspólny zestaw skilli

• Jedno polecenie instalacji, które wstawia te same skille do Claude Code, Codeksa i Cursora, razem ze skillami towarzyszącymi, bez których część skilli nie działa.
• Przypięcie, które przetrwa npx skills update, i kontrolę w CI, która pada, gdy zacommitowane skille rozjadą się z przypięciem.
• Regułę, kiedy wybrać wtyczkę zamiast przenośnej kopii, i jak nie dostać każdego skilla podwójnie.
• Osiem pułapek w CLI skills 1.7.0, które instalują zły zestaw albo zawodzą w łatwy do przeoczenia sposób, każdą z naprawą.
• Cztery prompty do skopiowania: wyszukiwanie, sprawdzenie nowej maszyny, audyt konfliktów i przegląd kwartalny.

Jeśli skille są dla ciebie nowe, najpierw przeczytaj, czym są Agent Skills i kiedy wygrywają z serwerem MCP.

Jak zainstalować skill jednocześnie dla Claude Code, Codeksa i Cursora?

CLI uruchamiasz przez npx, więc niczego nie instalujesz globalnie. Każde polecenie poniżej zostało uruchomione na skills 1.7.0 (wydanym 2026-09-17) w dniu 2026-09-26.

Zacznij od wylistowania zawartości repozytorium, bez instalowania czegokolwiek:

npx skills add mattpocock/skills --list

Potem zainstaluj wybrane skille dla agentów, których używasz:

npx skills add mattpocock/skills --skill grill-me grilling setup-matt-pocock-skills -a claude-code -a codex -a cursor

To polecenie celowo instaluje trzy skille, a nie jeden. grill-me to jednolinijkowy delegat, którego treść brzmi „Run a /grilling session”, więc bez grilling wskazuje w próżnię. setup-matt-pocock-skills konfiguruje tracker zadań i lokalizację dokumentacji, których oczekuje reszta zestawu. Przewodnik po grill-me pokazuje pełną sesję.

Co powinieneś zobaczyć na dysku po tym poleceniu:

skills-lock.json
.agents/skills/grill-me/SKILL.md          # prawdziwe pliki (czytają je Codex i Cursor)
.agents/skills/grilling/SKILL.md
.agents/skills/setup-matt-pocock-skills/…
.claude/skills/grill-me -> ../../.agents/skills/grill-me   # dowiązania dla Claude Code
.claude/skills/grilling -> ../../.agents/skills/grilling

CLI trzyma jedną kanoniczną kopię w .agents/skills/ i tworzy do niej dowiązania symboliczne w .claude/skills/. Dodaj --copy, jeśli zespół pracuje na checkoutach Windows, w których Git nie tworzy dowiązań.

Claude Code

Są dwie drogi i nie są równoważne:

# Wtyczka: nazwy z przestrzenią nazw, aktualizacje z marketplace'u
claude plugin install mattpocock-skills

# Kopia przenośna: pliki w repozytorium, przypinane przez ciebie
npx skills add mattpocock/skills --skill grill-me grilling setup-matt-pocock-skills -a claude-code

Z wtyczką wywołujesz /mattpocock-skills:grill-me, z kopią przenośną wpisujesz /grill-me. /setup-matt-pocock-skills uruchom raz na repozytorium. Żeby zobaczyć koszt wtyczki przed decyzją, uruchom claude plugin details mattpocock-skills — wypisuje prognozowane tokeny stale obecne w kontekście.

Codex

npx skills add mattpocock/skills --skill grill-me grilling setup-matt-pocock-skills -a codex

Codex czyta skille projektu z .agents/skills/. Skill wywołujesz wzmianką z $: $grill-me I want to add per-seat billing. Codex ma też wtyczki (codex plugin add <plugin>@<marketplace> — w codex-cli 0.157.1 czasownik to add, nie install), opisane na stronie o wtyczkach.

Cursor

npx skills add mattpocock/skills --skill grill-me grilling setup-matt-pocock-skills -a cursor

CLI zapisuje projektowe skille Cursora do .agents/skills/, a globalne do ~/.cursor/skills/. Wywołujesz je przez /grill-me w czacie Agenta. Dokumentacja Cursora była niedostępna w chwili weryfikacji tej strony, więc potwierdź wynik, pytając agenta Cursora, które skille widzi (robi to prompt do sprawdzenia maszyny niżej).

Których poleceń CLI skills potrzebujesz na co dzień?

Polecenie	Co robi
npx skills add <owner/repo> --list	Listuje skille w repozytorium, niczego nie instaluje
npx skills add <owner/repo> --skill a b -a claude-code	Instaluje wskazane skille dla wskazanych agentów (zakres projektu)
npx skills add <owner/repo> -g …	Instaluje na poziomie użytkownika (~/.claude/skills/, ~/.codex/skills/, ~/.cursor/skills/); nie trafia do skills-lock.json
npx skills add <owner/repo> --full-depth --list	Szuka poniżej głównego SKILL.md; potrzebne w repozytoriach-kolekcjach
npx skills use <owner/repo>@<skill> | claude	Jednorazowo testuje skill bez instalacji
npx skills find [query]	Przeszukuje indeks skills.sh
npx skills list (alias ls)	Listuje skille projektu z ich źródłem; -g dla globalnych
npx skills update [names] -p -y	Aktualizuje skille projektu (-g dla globalnych)
npx skills remove <name> (alias rm)	Usuwa skill, jego dowiązania i wpis w lockfile
npx skills experimental_install	Odtwarza skille zapisane w skills-lock.json

GitHub CLI ma własną drogę w wersji preview: gh skill install <repository> <skill> z flagami --agent, --scope i --pin (odczytane ze źródeł cli/cli 2026-09-26, nieuruchamiane). Wybierz jeden instalator na repozytorium, żeby istniało jedno źródło prawdy.

Jak wyszukiwać skille, nie ufając licznikom instalacji?

Meta-skill find-skills uruchamia za ciebie npx skills find i proponuje polecenia instalacji:

npx skills add vercel-labs/skills --skill find-skills -a claude-code -a codex -a cursor

Na dzień 2026-09-26 find-skills miał 3 568 681 instalacji w całej historii skills.sh, według zewnętrznego zrzutu LinklyAI/best-skills (SECONDARY; samo skills.sh było nieosiągalne, więc sprawdź je ponownie, zanim zacytujesz tę liczbę). Traktuj liczniki jako miarę uwagi, nie jakości: skille po zmianie nazwy zachowują stare liczniki, a repozytoria-podróbki o nazwie superpowers wyprzedzają w rankingu niezwiązane z nimi skille. Instaluj od kanonicznego właściciela.

Prompt do skopiowania: znajdź skille dla tego stosu

Use the find-skills skill. Our stack is Astro 7, React 18, Tailwind, TypeScript and Drizzle on Cloudflare D1.
For each gap where the agent repeatedly gets something wrong (tests first, D1 bindings, accessibility),
propose at most one skill. For each: canonical owner/repo, the exact SKILL.md `name`, any sibling skills it
calls, the full `npx skills add … --skill … -a claude-code -a codex -a cursor` command, and the install count
with its source. Do not install anything. Flag any repo whose owner is not the original author.

Jak wdrożyć skille w zespole i utrzymać je przypięte?

To jest przepływ pracy dla zespołu. Traktuje skille jak zależności: przypnij, zacommituj, sprawdź w CI, aktualizuj świadomie.

1. Instaluj w zakresie projektu, przypięte do refa. owner/repo#ref przyjmuje tag, gałąź lub commit, a CLI zapisuje ref w skills-lock.json. Przypinaj do taga albo SHA commita, bo ref gałęzi przesuwa się przy każdej aktualizacji i każdym odtworzeniu:

   npx skills add "mattpocock/skills#v1.2.3" --skill grill-me grilling setup-matt-pocock-skills -a claude-code -a codex -a cursor

   Bez #ref lockfile zapisuje tylko źródło i hash zawartości, a experimental_install pobiera to, co danego dnia leży na domyślnej gałęzi. Hash jest zapisywany, ale nie egzekwowany.

2. Przeczytaj, co zainstalowałeś, zanim to zacommitujesz. Skille działają z pełnymi uprawnieniami agenta (CLI wypisuje to ostrzeżenie po każdej instalacji). Przejrzyj każdy SKILL.md i dołączone skrypty w pull requeście albo przepuść je przez skaner, jak opisuje strona o bezpieczeństwie łańcucha dostaw skilli.

3. Commituj katalogi razem z lockfile.

   git add skills-lock.json .agents/skills/ .claude/skills/

   Commituj także .claude/skills/. W 1.7.0 experimental_install odtwarza tylko do .agents/skills/ i nie odtwarza dowiązań dla Claude Code, więc kolega, który polega wyłącznie na odtworzeniu, nie dostaje niczego w Claude Code.

4. Dodaj kontrolę dryfu do CI. Odtwarza skille z lockfile i pada, jeśli zacommitowane skille różnią się od przypiętego źródła. Łapie ręczne edycje i niedokończone aktualizacje bez czytania treści skilli:

   npx -y skills@1.7.0 experimental_install
   git diff --exit-code -- .agents/skills skills-lock.json
   test -z "$(git status --porcelain -- .agents/skills skills-lock.json)"

   Linia z git diff łapie edycje i usunięcia; linia z git status pada także na nowych, nieśledzonych plikach, np. skrypcie dodanym przez zmianę w upstreamie.

   Przypnij wersję CLI (skills@1.7.0) w CI z tego samego powodu, dla którego przypinasz skille.

5. Aktualizuj celowo. npx skills update -p -y odświeża skille projektu, ale respektuje przypięty ref, więc skill na tagu zostaje na miejscu. Żeby przesunąć przypięcie, powtórz krok 1 z nowym tagiem, a potem przejrzyj diff każdego SKILL.md w pull requeście jak każdą aktualizację zależności.

6. Usuwaj po nazwie skilla i usuwaj całą grupę. npx skills remove grill-me kasuje katalog, dowiązanie i wpis w lockfile. Nie wie, że grilling istniał tylko dla grill-me — skille towarzyszące usuń jawnie i nigdy nie usuwaj skilla, do którego deleguje inny.

Skille osobiste i eksperymentalne trzymaj poza repozytorium. Instaluj je z -g do katalogu domowego — nie trafiają wtedy do lockfile projektu i nie zmieniają agenta kolegi.

Wtyczka czy kopia przenośna?

Pytanie	Wtyczka (claude plugin install, codex plugin add)	Kopia przenośna (npx skills add)
Potrzebne hooki albo bootstrap na starcie sesji?	Tak: niesie je tylko wtyczka	Nie: same pliki
Musi być identycznie w Claude Code, Codeksie i Cursorze?	Osobne marketplace’y dla każdego agenta	Jedno polecenie, jeden katalog
Musi być przypięte i przeglądane w twoim repozytorium?	Aktualizacjami steruje marketplace	Przypięcie przez #ref, diff w PR
Nazwa wywołania w Claude Code	Z przestrzenią nazw, /plugin:skill	Goła, /skill

Ta różnica nie jest kosmetyczna. npx skills add obra/superpowers kopiuje skille, ale nie bootstrap SessionStart, więc metoda Superpowers nie uruchamia się sama — zainstaluj Superpowers jako wtyczkę. Wybierz jedną drogę na zestaw skilli: README Matta Pococka ostrzega, że instalacja i wtyczki, i kopii z skills.sh sprawia, że każdy skill pojawia się dwa razy. Dla prywatnego katalogu odpowiednikiem tego przepływu po stronie wtyczek jest zespołowy marketplace wtyczek.

Prompt do skopiowania: sprawdź, czy nowa maszyna widzi zestaw zespołu

List every skill you can load in this session, with its name, the directory it was loaded from, and whether
it can trigger automatically or only when invoked. Compare that list with skills-lock.json in the repo root.
Report: skills in the lockfile you cannot see, skills you can see that are not in the lockfile, any skill
that appears twice, and any SKILL.md that tells you to call another skill that is not installed.
Do not change any files.

Ile kontekstu kosztują zainstalowane skille?

Skill ma dwa koszty. Jego name i description są w kontekście w każdej sesji, żeby agent mógł zdecydować, kiedy go użyć. Treść ładuje się dopiero, gdy skill zadziała. Specyfikacja Agent Skills ogranicza description do 1024 znaków; tani skill zużywa ułamek tego i odpowiada na jedno pytanie: „kiedy agent ma tego użyć?”.

Prognoza samego Claude Code, zmierzona przez claude plugin details w Claude Code 2.1.283 w dniu 2026-09-26, pokazuje rozrzut: wtyczka mattpocock-skills (25 skilli) dodaje ok. 1609 tokenów stale obecnych w każdej sesji, a wtyczka ECC ok. 41 515. Skill subagent-driven-development z Superpowers kosztuje ok. 11 800 tokenów przy każdym uruchomieniu. Mierz przed instalacją i po niej przez /context w Claude Code; przewodnik po koszcie kontekstu opisuje pozostałe narzędzia.

Dwie dźwignie obniżają stały koszt:

• Skille uruchamiane ręcznie ustaw jako wywoływane przez użytkownika. Skill, który zawsze wołasz po nazwie (/tdd, /diagnose, audyt), nie musi być oferowany modelowi. W Claude Code disable-model-invocation: true we frontmatterze blokuje automatyczne uruchamianie; grill-me jest tak ustawiony.
• Instaluj pod swój stos, nie całe katalogi. Rozsądny start to jeden zestaw dyscypliny (Superpowers albo skille Pococka) plus skille dla frameworków, które faktycznie wdrażasz. Skill do konkretnego zadania, np. audytu bezpieczeństwa, dodaj na czas zadania, a potem usuń.

Dr. Skill mierzy efektywny zestaw dla każdego agenta, łącznie ze skillami na poziomie maszyny i przypadkami, w których jeden skill przesłania drugi, oraz czyta ślady sesji, żeby pokazać, które skille kiedykolwiek zadziałały.

Jak rozwiązywać konflikty między skillami?

Konflikt to sprzeczne instrukcje: skill do Reacta preferujący eksporty domyślne wobec twojej reguły projektu o eksportach nazwanych albo skill pisany pod ReactDOM.render z Reacta 17 obok takiego, który używa createRoot. Żaden agent nie dokumentuje kolejności pierwszeństwa między zainstalowanymi skillami (sprawdzone w Claude Code 2.1.283 i codex-cli 0.157.1), więc to, który wygrywa, może się zmieniać między sesjami.

Naprawiaj w tej kolejności:

1. Usuń mniej trafny skill. Jeśli dwa skille dotyczą tego samego, zostaw ten, który pasuje do twojego stosu i wersji.

2. Nadpisz w swoim skillu projektowym. Wskaż zwycięzcę i nazwij, co nadpisuje, żeby agent nie musiał zgadywać:

   ## Overrides
   These rules take precedence over any installed framework skill:
   - Exports: always named exports, never default exports (overrides React skills that suggest defaults).
   - State: Zustand for global state; do not introduce Redux.
   - Errors: throw `AppError`, not bare `Error` (overrides general TypeScript skills).

3. Popraw skill, nie prompt. Gdy zmienia się wzorzec w kodzie, zmień skill projektowy w tym samym pull requeście. Pisanie własnego skilla projektowego opisuje strona o tworzeniu własnych skilli.

Prompt do skopiowania: audyt konfliktów w zainstalowanych skillach

Read every SKILL.md under .agents/skills/ and .claude/skills/ (follow symlinks once) and our CLAUDE.md or
AGENTS.md. List every pair of instructions that contradict each other, quoting both lines with file paths.
For each conflict say which one matches the code in this repo today (cite a file that proves it), and draft
one line for the "Overrides" section of our project skill. Also list skills that reference another skill
that is not installed, and any skill that mentions a deprecated API. Change nothing.

Jak udowodnić, że skille działają, bez czytania każdego wyniku?

Instalacja skilla zmienia to, co produkuje agent, więc sprawdzaj efekt bramkami, a nie ponownym czytaniem diffów:

• Kontrola dryfu w CI (krok 4 wyżej) dowodzi, że każda maszyna i każdy runner mają przejrzaną, przypiętą treść.

• Złote zadanie dla każdego kluczowego skilla. Trzymaj jedno małe, stałe zadanie na każdy ważny skill, np. „dodaj padający test, potem poprawkę” dla skilla TDD, i uruchamiaj je bez interakcji po każdej zmianie przypięcia. Wynik sprawdzają istniejące bramki testów, typów i lintera:

  claude -p "Add a failing test for parseDate rejecting 2026-02-30, then the fix"
  # albo: codex exec "Add a failing test for parseDate rejecting 2026-02-30, then the fix"
  vp test   # twoje własne polecenie testów

  Dla wtyczek Claude Code claude plugin eval uruchamia przypadki ewaluacyjne wtyczki razem z wariantem bazowym bez wtyczki. Projektowanie takich kontroli opisuje strona o ewaluacjach agentów kodujących.

• Sygnały przeglądu, za które odpowiada tech lead. Mniej komentarzy w code review o konwencjach zapisanych w skillach i podobny wynik, gdy dwóch programistów prosi o tę samą zmianę. Gdy po aktualizacji te sygnały idą w złą stronę, cofnij przypięcie.

Tech lead zatwierdza każdą zmianę przypięcia, tak jak zatwierdza aktualizację zależności.

Prompt do skopiowania: kwartalny przegląd skilli

Review the skills recorded in skills-lock.json. For each: the pinned ref and whether a newer tag exists
upstream, whether it still matches our current stack (cite files), whether it overlaps another installed
skill, whether it should be user-invoked instead of automatic, and whether any session in the last quarter
used it (check with the team if you cannot tell). Output a table with keep / re-pin / make user-invoked /
remove, and the exact npx skills commands for each change. Do not run them.

Które pułapki CLI skills zaskakują zespoły?

Pułapki sprawdzone na skills 1.7.0 w dniu 2026-09-26

• --skill=grill-me jest po cichu ignorowane. Parser rozpoznaje tylko --skill albo -s oddzielone spacją. Z -y albo gdy polecenie uruchamia agent (CLI wykrywa agenta i przechodzi w tryb nieinteraktywny) instaluje każdy skill z repozytorium: 37 w przypadku mattpocock/skills (na main w dniu 2026-09-26). Pisz --skill grill-me albo mattpocock/skills@grill-me.
• Nazwa to name z frontmattera, nie nazwa katalogu. --skill react-best-practices kończy się błędem „No matching skills found”; skill nazywa się vercel-react-best-practices. Najpierw uruchom --list.
• Skille-delegaci psują się zainstalowane osobno. grill-me woła grilling; grill-with-docs woła grilling i domain-modeling; improve-codebase-architecture woła codebase-design.
• Repozytoria-kolekcje ukrywają swoje skille. Gdy repozytorium ma główny SKILL.md, CLI na nim się zatrzymuje. muratcankoylan/Agent-Skills-for-Context-Engineering pokazuje jeden skill-opakowanie, dopóki nie dodasz --full-depth; microsoft/skills potrzebuje tej flagi dla skilli SDK.
• Lockfile bez przypięcia to manifest, nie przypięcie. Odtworzenie pobiera najnowszą treść z upstreamu. Przypinaj przez #ref.
• Odtworzenie pomija Claude Code. experimental_install zapisuje tylko do .agents/skills/. Commituj też .claude/skills/.
• Globalna ścieżka Codeksa. CLI zapisuje globalne skille Codeksa do ~/.codex/skills/, podobnie jak wbudowany w Codeksa skill-installer; dokumentacja OpenAI (SECONDARY) opisuje skille użytkownika w ~/.agents/skills. Potwierdź przez /skills w Codeksie po instalacji z -g albo instaluj per projekt, gdzie oba źródła zgadzają się co do .agents/skills/.
• Skille po zmianie nazwy dalej są w rankingu. to-prd, to-issues i diagnose Pococka nie istnieją już na main; aktualne nazwy to to-spec, to-tickets i diagnosing-bugs.

Co jeszcze psuje się przy współdzieleniu skilli?

Agent kolegi zachowuje się inaczej. Uruchom na jego maszynie prompt sprawdzający. Typowe przyczyny to globalne skille w ~/.claude/skills/ lub ~/.cursor/skills/, o których projekt nie wie, wtyczka i kopia przenośna tego samego zestawu albo odtworzenie, które pominęło .claude/skills/. Usuń zdublowaną drogę i uruchom ponownie npx skills experimental_install.

Git ignoruje katalog skilli. Szeroki wpis .claude/ albo .agents/ w .gitignore wycina skille z każdego commita. Ignoruj konkretne pliki, np. .claude/settings.local.json, a .claude/skills/ i .agents/skills/ zostaw śledzone.

Aktualizacja zmieniła zachowanie z dnia na dzień. Skill nie był przypięty. Przywróć z Gita poprzedni skills-lock.json i katalogi skilli, potem przypnij #ref do ostatniego taga, który przeszedł złote zadanie.

Agent ignoruje skille pod koniec długiej sesji. Opisy nadal są załadowane, ale zatłoczony kontekst zmniejsza szansę, że agent sięgnie po skill. Wywołaj skill po nazwie albo zacznij nową sesję dla pracy, która musi ściśle trzymać się konwencji.

Skille obciążają prototyp. Skille produkcyjne działają też na kodzie do wyrzucenia. Powiedz to w prompcie („prototype: ignore the testing and documentation skills”) albo trzymaj ciężkie skille jako wywoływane przez użytkownika.

Dane uwierzytelniające trafiają do skilla. Skille są commitowane i czytelne dla każdego z dostępem do repozytorium. Wskazuj zmienne środowiskowe (process.env.STRIPE_SECRET_KEY) i nigdy nie wklejaj klucza do SKILL.md; kontrola dryfu i skaner sekretów widzą ten plik.

Dokąd dalej ze skillami zespołu

Bezpieczeństwo łańcucha dostaw skilli Skanuj, przeglądaj i ograniczaj zewnętrzne skille, zanim trafią do agenta.

Najpopularniejsze skille praktyk programistycznych Co zainstalować najpierw, według liczby instalacji ze źródłami.

Tworzenie własnych skilli Napisz skill projektowy z konwencjami i nadpisaniami zespołu.

Wdrażanie agentów w zespole Gdzie wspólny zestaw skilli mieści się w szerszym planie wdrożenia.