Optymalizacja Skills i udostępnianie w zespole

Zainstalowałeś dwanaście skills. AI ma teraz tyle kontekstu o React, Next.js, Tailwind, testowaniu, konwencjach Git, dokumentacji, dostępności, bezpieczeństwie, wydajności, Drizzle, Docker i code review, że nie jest w stanie priorytetyzować żadnego z nich. Każdy wygenerowany komponent zawiera wyczerpujące komentarze JSDoc, atrybuty dostępności, optymalizacje wydajności, kontrole bezpieczeństwa i szablony testów — nawet gdy chciałeś tylko szybką funkcję narzędziową. AI tonie w instrukcjach i nadmiernie komplikuje wszystko.

Więcej skills to nie lepiej. Odpowiednie skills, dobrze zorganizowane, z jasnymi priorytetami — to konfiguracja, która naprawdę przyspiesza pracę.

Co wyniesiesz z tego rozdziału

• Strategię wyboru skills opartą na wpływie i budżecie kontekstu
• Techniki unikania i rozwiązywania konfliktów między skills
• Wzorce standaryzacji w całym zespole, które utrzymują spójne zachowanie AI u wszystkich deweloperów
• Strategie przypinania wersji dla stabilności w produkcyjnych codebase
• Kwestie bezpieczeństwa przy instalowaniu skills od osób trzecich
• Monitorowanie i mierzenie wpływu skills na wydajność AI

Strategia wyboru Skills

Budżet kontekstu

Każdy skill konsumuje tokeny z twojego okna kontekstu. Okno kontekstu jest skończone. Jeśli skills zajmują 40% dostępnego kontekstu, zostaje ci 60% na właściwą rozmowę, zawartość plików i wyjścia narzędzi.

Cel: 3-5 skills do codziennej pracy. To zostawia dużo miejsca na samą pracę. Możesz dodawać wyspecjalizowane skills tymczasowo dla konkretnych zadań (audyt bezpieczeństwa, przegląd dostępności) i usuwać je po zakończeniu.

Priorytetyzacja według częstotliwości błędów

Rankuj potencjalne skills według tego, jak często AI popełnia błędy w danej dziedzinie bez skilla:

Priorytet	Kategoria	Instaluj gdy	Przykład
Zawsze włączony	Konwencje projektu	Każda sesja	Wzorce kodowania twojego zespołu
Zawsze włączony	Główny framework	Każda sesja	React/Next.js/Vue best practices
Per sesja	Drugorzędny framework	Praca nad tym podsystemem	Wzorce bazodanowe, konwencje DevOps
Per zadanie	Wyspecjalizowane zagadnienie	Wykonywanie tego konkretnego zadania	Audyt bezpieczeństwa, przegląd dostępności, optymalizacja wydajności

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 konfliktów między Skills

Konflikty skills zdarzają się, gdy dwa skills dają sprzeczne instrukcje. AI nie ma wbudowanego systemu priorytetów — próbuje przestrzegać wszystkich instrukcji i produkuje niespójne wyniki.

Typowe wzorce konfliktów

Dwa skills React o różnych wzorcach komponentów. Skill React mówi “używaj default exports dla komponentów”, a twój skill projektowy mówi “nigdy nie używaj default exports”. AI przeskakuje między nimi nieprzewidywalnie.

Ogólny skill koliduje ze szczegółowym. Skill TypeScript mówi “unikaj klas, preferuj funkcje”, a twój skill projektowy mówi “używaj klas dla serwisów z constructor injection”.

Przestarzały skill koliduje z aktualnym. Skill odwołujący się do wzorców React 17 (jak ReactDOM.render) koliduje ze skillem React 19 używającym createRoot.

Strategie rozwiązywania

Usuń mniej autorytatywny skill. Jeśli dwa skills obejmują ten sam temat, zachowaj ten, który pasuje do twojego aktualnego stosu. Usuń 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 kolejność priorytetów 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 konfliktów:

“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 całym zespole

Gdy każdy deweloper w zespole ma zainstalowane te same skills, AI produkuje spójne wyniki niezależnie od tego, kto pisze prompt. To eliminuje problem “u mnie działa” dla kodu generowanego przez AI.

Wzorzec współdzielonego repozytorium Skills

Commituj pliki skills bezpośrednio do repozytorium projektu. Gdy deweloperzy klonują repozytorium, otrzymują skills automatycznie.

Cursor

Commituj .cursor/rules/ do kontroli wersji:

.cursor/
  rules/
    project-conventions.md      # Wzorce kodowania zespołu
    framework-patterns.md       # Wzorce React/Next.js
    workflow-conventions.md     # Wzorce Git, PR, wdrażania

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                           # Główne instrukcje projektu
.claude/
  skills/
    team-conventions/
      instructions.md              # Szczegółowe wzorce zespołu
    framework-patterns/
      instructions.md              # Reguły specyficzne dla frameworka

Claude Code odczytuje je automatycznie na początku sesji.

Codex

Commituj AGENTS.md do kontroli wersji:

AGENTS.md                          # Wszystkie instrukcje agenta w jednym pliku

Codex odczytuje ten plik na początku każdego zadania.

Oddzielanie Skills zespołowych od osobistych

Niektóre skills to standardy zespołowe. Inne to osobiste preferencje. Trzymaj je oddzielnie.

Skills zespołowe (commitowane do repozytorium):

• Konwencje kodowania projektu
• Decyzje architektoniczne
• Wymagania testowania
• Workflow wdrażania

Skills osobiste (w katalogu domowym, nie commitowane):

• Preferencje workflow edytora
• Osobiste wzorce produktywności
• Eksperymentalne skills w trakcie ewaluacji

Cursor

Zespołowe: .cursor/rules/ (w katalogu projektu)

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

Cursor odczytuje oba. Reguły projektu mają pierwszeństwo w przypadku konfliktu.

Claude Code

Zespołowe: CLAUDE.md i .claude/skills/ (w katalogu projektu)

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

Claude Code łączy oba, z instrukcjami na poziomie projektu mającymi pierwszeństwo.

Codex

Zespołowe: AGENTS.md (w katalogu projektu)

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

Onboarding nowych deweloperów

Gdy nowy deweloper dołącza do zespołu:

1. Klonowanie repozytorium. Wszystkie zacommitowane skills są dołączone automatycznie.

2. Instalacja skills z marketplace. Jeśli projekt używa skills z marketplace oprócz zacommitowanych, wymień 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 przypinać wersje

Skills z marketplace aktualizują się, gdy autor wypchnie zmiany. Aktualizacja może wprowadzić konwencje, które łamią istniejące wzorce w codebase. Przypinanie wersji zapobiega nieoczekiwanym zmianom.

Jak przypinać

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

Kiedy przypinać

• Produkcyjne codebase: Zawsze przypinaj. Nieoczekiwane zmiany konwencji mogą powodować niespójne generowanie kodu.
• Projekty osobiste: Opcjonalnie. Najnowsze wersje dają ci najświeższe wzorce.
• Podczas audytów lub review: Przypnij, aby zapewnić spójne zachowanie AI podczas okresu przeglądu.

Strategia aktualizacji

Planuj aktualizacje skills jak aktualizacje zależności:

# 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 bezpieczeństwa

Weryfikacja skills od osób trzecich

Skills to pliki markdown, które stają się częścią instrukcji twojego AI. Złośliwy skill może pouczyć AI, aby:

• Wprowadzał subtelne luki bezpieczeństwa do generowanego kodu
• Wyciągał dane poprzez pozornie niewinne wzorce kodu
• Omijał konwencje bezpieczeństwa twojego projektu
• Instalował niechciane zależności

Przed zainstalowaniem jakiegokolwiek skilla od osób trzecich:

1. Przeczytaj źródło. Skills to zwykły markdown. Przeczytaj każdy plik przed instalacją.
2. Sprawdź autora. Preferuj skills od znanych organizacji (Vercel, Anthropic, Stripe) lub deweloperów z ugruntowaną reputacją.
3. Sprawdź aktywność repozytorium. Skill, który był ostatnio aktualizowany dwa lata temu, może uczyć przestarzałych wzorców.
4. Przetestuj w izolacji. Zainstaluj skill w projekcie testowym i przejrzyj wyniki AI.

Bezpieczeństwo danych uwierzytelniających

Nigdy nie umieszczaj danych uwierzytelniających w plikach skills. Skills są commitowane do kontroli wersji i widoczne dla każdego z dostępem do repozytorium.

Źle:

## 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 przeglądu bezpieczeństwa 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 wpływu Skills na zużycie kontekstu

Mierzenie konsumpcji kontekstu

Każdy plik skilla wpływa na zużycie kontekstu. Monitoruj całkowity rozmiar, aby upewnić się, że skills nie wypierają miejsca na właściwą pracę deweloperską.

# 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:

• Poniżej 3000 słów łącznie: Komfortowo. Dużo miejsca na rozmowę.
• 3000-5000 słów: Akceptowalnie dla skupionej pracy. Może być ciasno przy długich sesjach.
• Powyżej 5000 słów: Za dużo. AI nie przetworzy skutecznie wszystkich instrukcji. Skróć lub podziel.

Mierzenie skuteczności

Śledź te sygnały, aby wiedzieć czy twoje skills działają:

Komentarze w code review się zmniejszają. Jeśli recenzenci przestają zaznaczać naruszenia konwencji w kodzie generowanym przez AI, skills są skuteczne.

Długość promptów się zmniejsza. Deweloperzy spędzają mniej czasu na wyjaśnianiu konwencji w promptach, bo skills się tym zajmują.

Czas onboardingu się zmniejsza. Nowi deweloperzy szybciej produkują kod zgodny z konwencjami dzięki wsparciu AI.

Spójność wyników AI rośnie. Różni deweloperzy zadający podobne pytania otrzymują podobnie ustrukturyzowane wyniki.

Kwartalny przegląd Skills

Ustaw cykliczne przypomnienie do audytu twojego stosu skills:

1. Czy wszystkie skills są nadal istotne dla twojego aktualnego stosu technologicznego?
2. Czy jakieś skills uczą przestarzałych wzorców?
3. Czy jakieś skills są zbędne (pokrywają się z innymi)?
4. Czy całkowity budżet kontekstu jest rozsądny?
5. Czy są nowe skills na marketplace, które byłyby wartościowe?

Wskazówka

Prompt do skopiowania do kwartalnego przeglądu 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 błędy i naprawy

Błąd: Skills które są zbyt ogólnikowe

Problem: “Pisz czysty kod i postępuj według najlepszych praktyk” marnuje kontekst na coś, według czego AI nie może działać.

Naprawa: Zastąp konkretnymi, możliwymi do wykonania instrukcjami. “Przy tworzeniu klas serwisowych, używaj constructor injection z typowanym parametrem opcji.”

Błąd: Skills powielające wbudowaną wiedzę

Problem: Skill mówiący “używaj async/await zamiast callbacków” uczy AI czegoś, co już wie.

Naprawa: Skup się na konwencjach specyficznych dla twojego zespołu, których AI nie odkryje ze swoich danych treningowych.

Błąd: Skills które są ze sobą sprzeczne

Problem: Dwa skills dają przeciwne instrukcje dotyczące tego samego zagadnienia. AI oscyluje między nimi.

Naprawa: Usuń mniej autorytatywny skill lub dodaj jawne nadpisanie w bardziej szczegółowym skillu.

Błąd: Nigdy nie aktualizowane Skills

Problem: Skill był napisany dla React 17 i Pages Router. Projekt teraz używa React 19 z App Router.

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

Błąd: Instalacja bez testowania

Problem: Skill od społeczności uczy wzorców niekompatybilnych z twoim projektem.

Naprawa: Przetestuj każdy nowy skill generując reprezentatywny kod i przeglądając go przed zacommitowaniem do zespołu.

Błąd: Za dużo Skills

Problem: Dwanaście skills przeciąża kontekst AI i próbuje sprostać im wszystkim, nadmiernie komplikując wszystko.

Naprawa: Zrób audyt i zredukuj do 3-5 kluczowych skills. Przenieś wyspecjalizowane skills na listę “używaj w razie potrzeby”.

Gdy coś nie działa

AI ignoruje skills, gdy okno kontekstu jest pełne. Długie rozmowy z wieloma odczytami plików wypychają skills z aktywnego kontekstu. Zacznij nową sesję dla zadań wymagających ścisłego przestrzegania konwencji.

Skills działają w jednym narzędziu, ale nie w innym. Każde narzędzie odczytuje skills z innego katalogu. Sprawdź, czy pliki istnieją we właściwej lokalizacji dla narzędzia, którego używasz.

AI nowego członka zespołu zachowuje się inaczej. Może nie uruchomił npx skills update po sklonowaniu, albo może mieć osobiste skills, które nadpisują konwencje zespołowe. Sprawdź jego katalog skills i globalną konfigurację.

Skills czynią AI zbyt zachowawczym. Jeśli AI odmawia generowania szybkiego prototypowego kodu, bo skills wymagają wzorców jakości produkcyjnej, powiedz mu wprost: “This is a prototype. Ignore convention skills and optimize for speed.”

Błędy okna kontekstu podczas długich sesji. Jeśli widzisz ostrzeżenia o obcinaniu lub pogorszoną jakość wyników, twoje skills plus historia rozmowy przekroczyły limit kontekstu. Zmniejsz liczbę skills lub zacznij nową sesję.

Co dalej

Budowanie własnych Skills Tworzenie i publikowanie własnych skills na marketplace.

Instalacja i zarządzanie Skills Pełna dokumentacja CLI narzędzia skills.

Skills vs MCP Kiedy używać skilla, a kiedy serwera MCP.