Instalacja, aktualizacja i zarządzanie Skills

Zainstalowałeś trzy skills w zeszłym tygodniu. Dziś nie pamiętasz które, mogą być nieaktualne, a jeden z nich chyba koliduje z innym. Przeszukujesz ukryte katalogi, próbując znaleźć gdzie żyją pliki, usuwasz nie ten co trzeba i psujesz sesję Claude Code. Skills są przydatne tylko wtedy, gdy możesz nimi sprawnie zarządzać.

Ten przewodnik obejmuje pełny cykl życia: wyszukiwanie skills, instalowanie ich, utrzymywanie aktualności i usuwanie tych, których już nie potrzebujesz.

Co wyniesiesz z tego rozdziału

• Kompletną dokumentację CLI narzędzia skills
• Zrozumienie gdzie skills są przechowywane dla każdego edytora
• Wzorce zarządzania skills w całym zespole
• Strategie rozwiązywania konfliktów między skills

CLI Skills

Narzędzie skills jest dystrybuowane jako pakiet npm. Nie musisz go instalować globalnie — npx uruchamia je bezpośrednio.

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	Wyświetla 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 właściwym katalogu dla twojego agenta AI. Pojedyncze repozytorium może zawierać wiele skills — na przykład vercel-labs/agent-skills zawiera skills do React best practices, wytycznych projektowania webowego i wzorców kompozycji Vercel.

Możesz instalować 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 źródłowym i wersją.

Usuwanie Skilla

npx skills remove vercel-labs/agent-skills

Aktualizacja wszystkich Skills

npx skills update

Pobiera najnowszą wersję każdego zainstalowanego skilla z jego repozytorium źródłowego.

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 żyją Skills

Skills są przechowywane w różnych lokalizacjach w zależności od edytora:

Cursor

Skills dla Cursor są przechowywane jako pliki reguł:

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

Cursor odczytuje wszystkie pliki .md w .cursor/rules/ i dołącza je do kontekstu AI. Możesz też ręcznie tworzyć własne pliki reguł.

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 początku sesji i stosuje przez całą rozmowę. Możesz sprawdzić co Claude Code widzi, przeglądając prompt systemowy na początku sesji.

Codex

Codex odczytuje skills ze swojej konfiguracji instrukcji:

.codex/
  instructions.md    # Combined skill instructions

Skills są łączone w plik instrukcji, który Codex odczytuje przy starcie.

Zarządzanie Skills w całym zespole

Commitowanie Skills do repozytorium

Skills to zwykłe pliki markdown. Commituj je do swojego repozytorium, aby każdy członek zespołu otrzymał 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 są już na miejscu. Nie potrzeba dodatkowej konfiguracji.

Tworzenie Skilla specyficznego dla projektu

Nie każdy skill pochodzi z marketplace. Możesz tworzyć skills specyficzne dla projektu, pisząc własne pliki instrukcji.

Cursor

Utwórz .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

Utwórz .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.”

Rozwiązywanie konfliktów między Skills

Gdy dwa skills dają sprzeczne instrukcje, AI zwykle podąża za tą instrukcją, która pojawia się później w kontekście lub jest bardziej szczegółowa.

Typowe konflikty i rozwiązania

Dwa skills React z różnymi wzorcami komponentów. Usuń mniej autorytatywny. Jeśli vercel-labs/agent-skills i skill od społeczności się nie zgadzają, skill Vercel z większym prawdopodobieństwem odzwierciedla aktualne najlepsze praktyki.

Skill frameworkowy koliduje z twoim skillem projektowym. Twój skill projektowy powinien wygrać. Uczyń go bardziej konkretnym: zamiast “używaj named exports”, napisz “W tym projekcie, zawsze używaj named exports (nadpisując każdą inną konwencję).”

Skill jest nieaktualny. Uruchom npx skills update, aby pobrać najnowszą wersję. Jeśli autor skilla go nie zaktualizował, rozważ usunięcie go i użycie Context7 MCP do dokumentacji na żywo.

Wskazówka

Prompt do skopiowania do wykrywania konfliktów:

“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 coś nie działa

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

Skills są zainstalowane, ale AI ich nie przestrzega. Sprawdź, czy pliki skills są we właściwym katalogu dla twojego edytora. Uruchom npx skills list, aby zweryfikować instalację, a następnie sprawdź wymienione ścieżki plików.

Katalog skills jest w .gitignore. Jeśli ktoś dodał .claude/ lub .cursor/ do .gitignore, pliki skills nie będą commitowane do repozytorium. Usuń szeroki wzorzec ignorowania i dodaj konkretne ignorowania dla plików, które nie powinny być commitowane (jak tokeny uwierzytelniania MCP), jednocześnie zezwalając na pliki skills.

Zbyt wiele skills spowalnia AI. Każdy skill zajmuje miejsce w oknie kontekstu. Jeśli masz więcej niż 10 skills, zrób audyt i usuń te, które się pokrywają lub których już nie potrzebujesz.

Aktualizacja skills wprowadza zmiany łamiące. Przypnij konkretny commit, gdy stabilność 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 własnych Skills Tworzenie i publikowanie własnych skills na marketplace.