Optymalizacja Skills i udostepnianie w zespole

Zainstalowaless dwanascie skills. AI ma teraz tyle kontekstu o React, Next.js, Tailwind, testowaniu, konwencjach Git, dokumentacji, dostepnosci, bezpieczenstwie, wydajnosci, Drizzle, Docker i code review, ze nie jest w stanie priorytetyzowac zadnego z nich. Kazdy wygenerowany komponent zawiera wyczerpujace komentarze JSDoc, atrybuty dostepnosci, optymalizacje wydajnosci, kontrole bezpieczenstwa i szablony testow — nawet gdy chciales tylko szybka funkcje narzedzriowa. AI tonie w instrukcjach i nadmiernie komplikuje wszystko.

Wiecej skills to nie lepiej. Odpowiednie skills, dobrze zorganizowane, z jasnymi priorytetami — to konfiguracja, ktora naprawde przyspiesza prace.

Co wyniesiesz z tego rozdzialu

• Strategia wyboru skills oparta na wplywie i budzecie kontekstu
• Techniki unikania i rozwiazywania konfliktow miedzy skills
• Wzorce standaryzacji w calym zespole, ktore utrzymuja spojne zachowanie AI u wszystkich deweloperow
• Strategie przypinania wersji dla stabilnosci w produkcyjnych codebase
• Kwestie bezpieczenstwa przy instalowaniu skills od osob trzecich
• Monitorowanie i mierzenie wplywu skills na wydajnosc AI

Strategia wyboru Skills

Budzet kontekstu

Kazdy skill konsumuje tokeny z twojego okna kontekstu. Okno kontekstu jest skonezone. Jesli skills zajmuja 40% dostepnego kontekstu, zostaje ci 60% na wlasciwa rozmowe, zawartosc plikow i wyjscia narzedzi.

Cel: 3-5 skills do codziennej pracy. To zostawia duzo miejsca na sama prace. Mozesz dodawac wyspecjalizowane skills tymczasowo dla konkretnych zadan (audyt bezpieczenstwa, przeglad dostepnosci) i usuwac je po zakonczeniu.

Priorytetyzacja wedlug czestotliwosci bledow

Rankuj potencjalne skills wedlug tego, jak czesto AI popelnia bledy w danej dziedzinie bez skilla:

Priorytet	Kategoria	Instaluj gdy	Przyklad
Zawsze wlaczony	Konwencje projektu	Kazda sesja	Wzorce kodowania twojego zespolu
Zawsze wlaczony	Glowny framework	Kazda sesja	React/Next.js/Vue best practices
Per sesja	Drugorzedny framework	Praca nad tym podsystemem	Wzorce bazodanowe, konwencje DevOps
Per zadanie	Wyspecjalizowane zagadnienie	Wykonywanie tego konkretnego zadania	Audyt bezpieczenstwa, przeglad dostepnosci, optymalizacja wydajnosci

Wskazówka

Prompt do skopiowania do audytu skills:

“List every installed skill and estimate its token count. For each skill, rate how frequently it applies to my typical development tasks (daily, weekly, rarely). Calculate the total context budget consumed by all skills. Recommend which skills to keep always-on, which to activate per-session, and which to remove entirely.”

Unikanie konfliktow miedzy Skills

Konflikty skills zdarzaja sie, gdy dwa skills daja sprzeczne instrukcje. AI nie ma wbudowanego systemu priorytetow — probuje przestrzegac wszystkich instrukcji i produkuje niespojne wyniki.

Typowe wzorce konfliktow

Dwa skills React o roznych wzorcach komponentow. Skill React mowi “uzywaj default exports dla komponentow”, a twoj skill projektowy mowi “nigdy nie uzywaj default exports”. AI przeskakuje miedzy nimi nieprzewidywalnie.

Ogolny skill koliduje ze szczegolowym. Skill TypeScript mowi “unikaj klas, preferuj funkcje”, a twoj skill projektowy mowi “uzywaj klas dla serwisow z constructor injection”.

Przestarzaly skill koliduje z aktualnym. Skill odwolujacy sie do wzorcow React 17 (jak ReactDOM.render) koliduje ze skillem React 19 uzywajacym createRoot.

Strategie rozwiazywania

Usun mniej autorytatywny skill. Jesli dwa skills obejmuja ten sam temat, zachowaj ten, ktory pasuje do twojego aktualnego stosu. Usun drugi.

Dodaj jawne nadpisania. W swoim skillu konwencji projektowych jawnie nadpisz sprzeczne instrukcje:

## Overrides

The following instructions take precedence over any framework skill:

- **Exports:** Always use named exports. Never use default exports.
  (This overrides React conventions that suggest default exports for components.)

- **State management:** Use Zustand for global state. Do not use Redux.
  (This overrides any skill that teaches Redux patterns.)

- **Error handling:** Use our AppError class, not thrown Error objects.
  (This overrides general TypeScript error handling patterns.)

Jawnie uwarstwiaj skills. Zdefiniuj kolejnosc priorytetow w instrukcjach projektu:

# Priority Order for Convention Conflicts

1. This project conventions skill (highest priority)
2. Framework-specific skills (React, Next.js)
3. Language-level skills (TypeScript best practices)
4. General development skills (lowest priority)

When instructions conflict between layers, follow the higher-priority source.

Wskazówka

Prompt do skopiowania do wykrywania konfliktow:

“Read all installed skill files and identify any pairs of instructions that contradict each other. For each conflict, state which skill has the more current or project-specific guidance. Recommend which instruction should win and suggest explicit override language to add to the project conventions skill.”

Standaryzacja Skills w calym zespole

Gdy kazdy deweloper w zespole ma zainstalowane te same skills, AI produkuje spojne wyniki niezaleznie od tego, kto pisze prompt. To eliminuje problem “u mnie dziala” dla kodu generowanego przez AI.

Wzorzec wspoldzielonego repozytorium Skills

Commituj pliki skills bezposrednio do repozytorium projektu. Gdy deweloperzy klonuja repozytorium, otrzymuja skills automatycznie.

Cursor

Commituj .cursor/rules/ do kontroli wersji:

.cursor/
  rules/
    project-conventions.md      # Wzorce kodowania zespolu
    framework-patterns.md       # Wzorce React/Next.js
    workflow-conventions.md     # Wzorce Git, PR, wdrazania

Dodaj do README projektu:

## AI Configuration

This project includes Cursor rules in `.cursor/rules/`.
They are loaded automatically when you open the project in Cursor.
No additional setup needed.

Claude Code

Commituj CLAUDE.md i .claude/skills/ do kontroli wersji:

CLAUDE.md                           # Glowne instrukcje projektu
.claude/
  skills/
    team-conventions/
      instructions.md              # Szczegolowe wzorce zespolu
    framework-patterns/
      instructions.md              # Reguly specyficzne dla frameworka

Claude Code odczytuje je automatycznie na poczatku sesji.

Codex

Commituj AGENTS.md do kontroli wersji:

AGENTS.md                          # Wszystkie instrukcje agenta w jednym pliku

Codex odczytuje ten plik na poczatku kazdego zadania.

Oddzielanie Skills zespolowych od osobistych

Niektore skills to standardy zespolowe. Inne to osobiste preferencje. Trzymaj je oddzielnie.

Skills zespolowe (commitowane do repozytorium):

• Konwencje kodowania projektu
• Decyzje architektoniczne
• Wymagania testowania
• Workflow wdrazania

Skills osobiste (w katalogu domowym, nie commitowane):

• Preferencje workflow edytora
• Osobiste wzorce produktywnosci
• Eksperymentalne skills w trakcie ewaluacji

Cursor

Zespolowe: .cursor/rules/ (w katalogu projektu)

Osobiste: ~/.cursor/rules/ (w katalogu domowym)

Cursor odczytuje oba. Reguly projektu maja pierwszenstwo w przypadku konfliktu.

Claude Code

Zespolowe: CLAUDE.md i .claude/skills/ (w katalogu projektu)

Osobiste: ~/.claude/settings.json (w katalogu domowym)

Claude Code laczy oba, z instrukcjami na poziomie projektu majacymi pierwszenstwo.

Codex

Zespolowe: AGENTS.md (w katalogu projektu)

Osobiste: ~/.codex/instructions.md (w katalogu domowym)

Onboarding nowych deweloperow

Gdy nowy deweloper dolacza do zespolu:

1. Klonowanie repozytorium. Wszystkie zacommitowane skills sa dolaczone automatycznie.

2. Instalacja skills z marketplace. Jesli projekt uzywa skills z marketplace oproc zacommitowanych, wymien je w README z poleceniami instalacji:

   npx skills add vercel-labs/agent-skills
   npx skills add anthropics/claude-code

3. Weryfikacja konfiguracji. Uruchom standardowy prompt weryfikacyjny.

Wskazówka

Prompt do skopiowania do weryfikacji onboardingu:

“Read all installed skills and project instructions. Summarize what conventions they teach. Then create a sample: one React component, one API route, and one test file — all following every convention. I will review the output to verify the skills are working correctly on this machine.”

Przypinanie wersji

Dlaczego warto przypinac wersje

Skills z marketplace aktualizuja sie, gdy autor wypchnie zmiany. Aktualizacja moze wprowadzic konwencje, ktore lamia istniejace wzorce w codebase. Przypinanie wersji zapobiega nieoczekiwanym zmianom.

Jak przypinac

# Pin to a specific commit
npx skills add vercel-labs/agent-skills@abc1234

Kiedy przypinac

• Produkcyjne codebase: Zawsze przypinaj. Nieoczekiwane zmiany konwencji moga powodowac niespojne generowanie kodu.
• Projekty osobiste: Opcjonalnie. Najnowsze wersje daja ci najswiezsze wzorce.
• Podczas audytow lub review: Przypnij, aby zapewnic spojne zachowanie AI podczas okresu przegladu.

Strategia aktualizacji

Planuj aktualizacje skills jak aktualizacje zaleznosci:

# Check for updates
npx skills list --outdated

# Update a specific skill
npx skills update vercel-labs/agent-skills

# Test after updating
# Generate sample code and verify it matches expectations

Kwestie bezpieczenstwa

Weryfikacja skills od osob trzecich

Skills to pliki markdown, ktore staja sie czescia instrukcji twojego AI. Zlosliwy skill moze pouczyc AI, aby:

• Wprowadzal subtelne luki bezpieczenstwa do generowanego kodu
• Wyciagal dane poprzez pozornie niewinne wzorce kodu
• Omijal konwencje bezpieczenstwa twojego projektu
• Instalowal niechciane zaleznosci

Przed zainstalowaniem jakiegokolwiek skilla od osob trzecich:

1. Przeczytaj zrodlo. Skills to zwykly markdown. Przeczytaj kazdy plik przed instalacja.
2. Sprawdz autora. Preferuj skills od znanych organizacji (Vercel, Anthropic, Stripe) lub deweloperow z ugruntowana reputacja.
3. Sprawdz aktywnosc repozytorium. Skill, ktory byl ostatnio aktualizowany dwa lata temu, moze uczyc przestarzalych wzorcow.
4. Przetestuj w izolacji. Zainstaluj skill w projekcie testowym i przejrzyj wyniki AI.

Bezpieczenstwo danych uwierzytelniajacych

Nigdy nie umieszczaj danych uwierzytelniajacych w plikach skills. Skills sa commitowane do kontroli wersji i widoczne dla kazdego z dostepem do repozytorium.

Zle:

## API Configuration
Use this API key for the staging environment: sk_test_abc123...

Dobrze:

## API Configuration
Use environment variables for all API keys. Never hardcode credentials.
Read the API key from process.env.STRIPE_SECRET_KEY.

Wskazówka

Prompt do skopiowania do przegladu bezpieczenstwa skills:

“Read all installed skill files and check for any security concerns: instructions that could introduce vulnerabilities, references to hardcoded credentials, patterns that bypass authentication or input validation, or instructions that conflict with security best practices. Report any findings with the specific file and line.”

Monitorowanie wplywu Skills na zuzycie kontekstu

Mierzenie konsumpcji kontekstu

Kazdy plik skilla wplywa na zuzycie kontekstu. Monitoruj calkowity rozmiar, aby upewnic sie, ze skills nie wypieraja miejsca na wlasciwa prace deweloperska.

# Check total size of all skill files
wc -w .cursor/rules/*.md
wc -w .claude/skills/*/instructions.md
wc -w CLAUDE.md AGENTS.md

Wytyczne:

• Ponizej 3000 slow lacznie: Komfortowo. Duzo miejsca na rozmowe.
• 3000-5000 slow: Akceptowalnie dla skupionej pracy. Moze byc ciasno przy dlugich sesjach.
• Powyzej 5000 slow: Za duzo. AI nie przetworzy skutecznie wszystkich instrukcji. Skroc lub podziel.

Mierzenie skutecznosci

Sledz te sygnaly, aby wiedziec czy twoje skills dzialaja:

Komentarze w code review sie zmniejszaja. Jesli recenzenci przestaja zaznaczac naruszenia konwencji w kodzie generowanym przez AI, skills sa skuteczne.

Dlugosc promptow sie zmniejsza. Deweloperzy spedzaja mniej czasu na wyjasnianiu konwencji w promptach, bo skills sie tym zajmuja.

Czas onboardingu sie zmniejsza. Nowi deweloperzy szybciej produkuja kod zgodny z konwencjami dzieki wsparciu AI.

Spojnosc wynikow AI rosnie. Rozni deweloperzy zadajacy podobne pytania otrzymuja podobnie ustrukturyzowane wyniki.

Kwartalny przeglad Skills

Ustaw cykliczne przypomnienie do audytu twojego stosu skills:

1. Czy wszystkie skills sa nadal istotne dla twojego aktualnego stosu technologicznego?
2. Czy jakies skills ucza przestarzalych wzorcow?
3. Czy jakies skills sa zbedne (pokrywaja sie z innymi)?
4. Czy calkowity budzet kontekstu jest rozsadny?
5. Czy sa nowe skills na marketplace, ktore bylyby wartosciowe?

Wskazówka

Prompt do skopiowania do kwartalnego przegladu skills:

“Review all installed skills and project instructions. For each one, answer: (1) Does it reference any deprecated APIs or outdated patterns? (2) Does it overlap significantly with another installed skill? (3) Is it still relevant to our current tech stack? (4) How many tokens does it consume? Summarize findings and recommend changes.”

Typowe bledy i naprawy

Blad: Skills ktore sa zbyt ogolnikowe

Problem: “Pisz czysty kod i postepuj wedlug najlepszych praktyk” marnuje kontekst na cos, wedlug czego AI nie moze dzialac.

Naprawa: Zastap konkretnymi, mozliwymi do wykonania instrukcjami. “Przy tworzeniu klas serwisowych, uzywaj constructor injection z typowanym parametrem opcji.”

Blad: Skills powielajace wbudowana wiedze

Problem: Skill mowiacy “uzywaj async/await zamiast callbackow” uczy AI czegos, co juz wie.

Naprawa: Skup sie na konwencjach specyficznych dla twojego zespolu, ktorych AI nie odkryje ze swoich danych treningowych.

Blad: Skills ktore sa ze soba sprzeczne

Problem: Dwa skills daja przeciwne instrukcje dotyczace tego samego zagadnienia. AI oscyluje miedzy nimi.

Naprawa: Usun mniej autorytatywny skill lub dodaj jawne nadpisanie w bardziej szczegolowym skillu.

Blad: Nigdy nie aktualizowane Skills

Problem: Skill byl napisany dla React 17 i Pages Router. Projekt teraz uzywa React 19 z App Router.

Naprawa: Traktuj aktualizacje skills jak aktualizacje dokumentacji. Gdy zmieniasz wzorzec w codebase, aktualizuj skill w tym samym PR.

Blad: Instalacja bez testowania

Problem: Skill od spolecznosci uczy wzorcow niekompatybilnych z twoim projektem.

Naprawa: Przetestuj kazdy nowy skill generujac reprezentatywny kod i przegladajac go przed zacommitowaniem do zespolu.

Blad: Za duzo Skills

Problem: Dwanascie skills przeciaza kontekst AI i probuje sprostac im wszystkim, nadmiernie komplikujac wszystko.

Naprawa: Zrob audyt i zredukuj do 3-5 kluczowych skills. Przenies wyspecjalizowane skills na liste “uzywaj w razie potrzeby”.

Gdy cos nie dziala

AI ignoruje skills, gdy okno kontekstu jest pelne. Dlugie rozmowy z wieloma odczytami plikow wypychaja skills z aktywnego kontekstu. Zacznij nowa sesje dla zadan wymagajacych scislego przestrzegania konwencji.

Skills dzialaja w jednym narzedziu, ale nie w innym. Kazde narzedzie odczytuje skills z innego katalogu. Sprawdz, czy pliki istnieja we wlasciwej lokalizacji dla narzedzia, ktorego uzywasz.

AI nowego czlonka zespolu zachowuje sie inaczej. Moze nie uruchomil npx skills update po sklonowaniu, albo moze miec osobiste skills, ktore nadpisuja konwencje zespolowe. Sprawdz jego katalog skills i globalna konfiguracje.

Skills czynia AI zbyt zachowawczym. Jesli AI odmawia generowania szybkiego prototypowego kodu, bo skills wymagaja wzorcow jakosci produkcyjnej, powiedz mu wprost: “This is a prototype. Ignore convention skills and optimize for speed.”

Bledy okna kontekstu podczas dlugich sesji. Jesli widzisz ostrzezenia o obcinaniu lub pogorszona jakosc wynikow, twoje skills plus historia rozmowy przekroczyly limit kontekstu. Zmniejsz liczbe skills lub zacznij nowa sesje.

Co dalej

Budowanie wlasnych Skills Tworzenie i publikowanie wlasnych skills na marketplace.

Instalacja i zarzadzanie Skills Pelna dokumentacja CLI narzedzia skills.

Skills vs MCP Kiedy uzywac skilla, a kiedy serwera MCP.