Instalacja, aktualizacja i zarzadzanie Skills

Zainstalowaless trzy skills w zeszlym tygodniu. Dzis nie pamietasz ktore, moga byc nieaktualne, a jeden z nich chyba koliduje z innym. Przeszukujesz ukryte katalogi, probujac znalezc gdzie zyja pliki, usuwasz nie ten co trzeba i psujesz sesje Claude Code. Skills sa przydatne tylko wtedy, gdy mozesz nimi sprawnie zarzadzac.

Ten przewodnik obejmuje pelny cykl zycia: wyszukiwanie skills, instalowanie ich, utrzymywanie aktualnosci i usuwanie tych, ktorych juz nie potrzebujesz.

Co wyniesiesz z tego rozdzialu

• Kompletna dokumentacje CLI narzedzia skills
• Zrozumienie gdzie skills sa przechowywane dla kazdego edytora
• Wzorce zarzadzania skills w calym zespole
• Strategie rozwiazywania konfliktow miedzy skills

CLI Skills

Narzedzie skills jest dystrybuowane jako pakiet npm. Nie musisz go instalowac globalnie — npx uruchamia je bezposrednio.

Podstawowe polecenia

Polecenie	Co robi
npx skills add <owner/repo>	Instaluje skill z repozytorium GitHub
npx skills remove <owner/repo>	Usuwa zainstalowany skill
npx skills list	Wyswietla wszystkie zainstalowane skills
npx skills update	Aktualizuje wszystkie zainstalowane skills do najnowszych wersji
npx skills search <query>	Wyszukuje na marketplace skills.sh

Instalacja Skilla

npx skills add vercel-labs/agent-skills

To klonuje instrukcje z repozytorium skilla i umieszcza je we wlasciwym katalogu dla twojego agenta AI. Pojedyncze repozytorium moze zawierac wiele skills — na przyklad vercel-labs/agent-skills zawiera skills do React best practices, wytycznych projektowania webowego i wzorcow kompozycji Vercel.

Mozesz instalowac skills z dowolnego repozytorium GitHub, nie tylko z tych wymienionych na skills.sh:

# Official skills from well-known organizations
npx skills add anthropics/claude-code
npx skills add cloudflare/skills
npx skills add stripe/agent-toolkit

# Community skills
npx skills add your-org/internal-conventions

Listowanie zainstalowanych Skills

npx skills list

Pokazuje wszystkie aktualnie zainstalowane skills wraz z repozytorium zrodlowym i wersja.

Usuwanie Skilla

npx skills remove vercel-labs/agent-skills

Aktualizacja wszystkich Skills

npx skills update

Pobiera najnowsza wersje kazdego zainstalowanego skilla z jego repozytorium zrodlowego.

Wskazówka

Prompt do skopiowania do odkrywania skills:

“Search the skills marketplace for skills that match my project’s tech stack. My project uses Astro, React, Tailwind CSS, TypeScript, and Drizzle ORM. For each matching skill, show the install count, a brief description, and the install command.”

Gdzie zyja Skills

Skills sa przechowywane w roznych lokalizacjach w zaleznosci od edytora:

Cursor

Skills dla Cursor sa przechowywane jako pliki regul:

.cursor/rules/
  vercel-labs-agent-skills.md
  anthropics-claude-code.md

Cursor odczytuje wszystkie pliki .md w .cursor/rules/ i dolacza je do kontekstu AI. Mozesz tez recznie tworzyc wlasne pliki regul.

Claude Code

Claude Code przechowuje skills w dedykowanym katalogu:

.claude/skills/
  vercel-labs-agent-skills/
    instructions.md
  anthropics-claude-code/
    instructions.md

Claude Code odczytuje je na poczatku sesji i stosuje przez cala rozmowe. Mozesz sprawdzic co Claude Code widzi, przegladajac prompt systemowy na poczatku sesji.

Codex

Codex odczytuje skills ze swojej konfiguracji instrukcji:

.codex/
  instructions.md    # Combined skill instructions

Skills sa laczone w plik instrukcji, ktory Codex odczytuje przy starcie.

Zarzadzanie Skills w calym zespole

Commitowanie Skills do repozytorium

Skills to zwykle pliki markdown. Commituj je do swojego repozytorium, aby kazdy czlonek zespolu otrzymal te same instrukcje:

# Install a skill
npx skills add vercel-labs/agent-skills

# Commit the skill files
git add .claude/skills/ .cursor/rules/
git commit -m "Add Vercel agent skills (React best practices, web design, composition patterns)"

Gdy nowy deweloper sklonuje repozytorium, skills sa juz na miejscu. Nie potrzeba dodatkowej konfiguracji.

Tworzenie Skilla specyficznego dla projektu

Nie kazdy skill pochodzi z marketplace. Mozesz tworzyc skills specyficzne dla projektu, piszac wlasne pliki instrukcji.

Cursor

Utworz .cursor/rules/project-conventions.md:

# Project Conventions

## File Structure
- Components go in `src/components/` with PascalCase names
- API routes go in `src/pages/api/` with kebab-case names
- Utility functions go in `src/lib/` with camelCase names

## Code Style
- Use TypeScript strict mode
- Prefer interfaces over types for object shapes
- Use named exports, never default exports
- Add JSDoc comments to all public functions

## Testing
- Every component must have a test file: `Component.test.tsx`
- Use React Testing Library, not Enzyme
- Test behavior, not implementation details

Claude Code

Utworz .claude/skills/project-conventions/instructions.md:

# Project Conventions

## File Structure
- Components go in `src/components/` with PascalCase names
- API routes go in `src/pages/api/` with kebab-case names
- Utility functions go in `src/lib/` with camelCase names

## Code Style
- Use TypeScript strict mode
- Prefer interfaces over types for object shapes
- Use named exports, never default exports
- Add JSDoc comments to all public functions

## Testing
- Every component must have a test file: `Component.test.tsx`
- Use React Testing Library, not Enzyme
- Test behavior, not implementation details

Codex

Dodaj do .codex/instructions.md:

# Project Conventions

## File Structure
- Components go in `src/components/` with PascalCase names
- API routes go in `src/pages/api/` with kebab-case names
- Utility functions go in `src/lib/` with camelCase names

## Code Style
- Use TypeScript strict mode
- Prefer interfaces over types for object shapes
- Use named exports, never default exports
- Add JSDoc comments to all public functions

Wskazówka

Prompt do skopiowania do generowania skilla projektowego:

“Analyze the codebase and identify patterns we consistently follow: file naming conventions, import ordering, component structure, error handling patterns, and testing approaches. Generate a project conventions skill file that documents these patterns so the AI follows them automatically in future sessions.”

Rozwiazywanie konfliktow miedzy Skills

Gdy dwa skills daja sprzeczne instrukcje, AI zwykle podaza za ta instrukcja, ktora pojawia sie pozniej w kontekscie lub jest bardziej szczegolowa.

Typowe konflikty i rozwiazania

Dwa skills React z roznymi wzorcami komponentow. Usun mniej autorytatywny. Jesli vercel-labs/agent-skills i skill od spolecznosci sie nie zgadzaja, skill Vercel z wiekszym prawdopodobienstwem odzwierciedla aktualne najlepsze praktyki.

Skill frameworkowy koliduje z twoim skillem projektowym. Twoj skill projektowy powinien wygrac. Uczyno go bardziej konkretnym: zamiast “uzywaj named exports”, napisz “W tym projekcie, zawsze uzywaj named exports (nadpisujac kazda inna konwencje).”

Skill jest nieaktualny. Uruchom npx skills update, aby pobrac najnowsza wersje. Jesli autor skilla go nie zaktualizowal, rozwaz usuniecie go i uzycie Context7 MCP do dokumentacji na zywo.

Wskazówka

Prompt do skopiowania do wykrywania konfliktow:

“Read all installed skill files and identify any contradictions between them. For each conflict, tell me which skill has the more current or authoritative guidance, and recommend which one to keep.”

Gdy cos nie dziala

“npx skills: command not found.” Upewnij sie, ze Node.js jest zainstalowany i npx jest w twoim PATH. CLI skills wymaga Node.js 18 lub nowszego.

Skills sa zainstalowane, ale AI ich nie przestrzega. Sprawdz, czy pliki skills sa we wlasciwym katalogu dla twojego edytora. Uruchom npx skills list, aby zweryfikowac instalacje, a nastepnie sprawdz wymienione sciezki plikow.

Katalog skills jest w .gitignore. Jesli ktos dodal .claude/ lub .cursor/ do .gitignore, pliki skills nie beda commitowane do repozytorium. Usun szeroki wzorzec ignorowania i dodaj konkretne ignorowania dla plikow, ktore nie powinny byc commitowane (jak tokeny uwierzytelniania MCP), jednoczesnie zezwalajac na pliki skills.

Zbyt wiele skills spowalnia AI. Kazdy skill zajmuje miejsce w oknie kontekstu. Jesli masz wiecej niz 10 skills, zrob audyt i usun te, ktore sie pokrywaja lub ktorych juz nie potrzebujesz.

Aktualizacja skills wprowadza zmiany lamiqce. Przypnij konkretny commit, gdy stabilnosc jest krytyczna:

npx skills add vercel-labs/agent-skills@abc1234

Co dalej

Najlepsze Skills frontendowe Najlepsze skills dla React, Next.js i rozwoju frontendu.

Budowanie wlasnych Skills Tworzenie i publikowanie wlasnych skills na marketplace.