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 find [query]	Interaktywnie przeszukuje marketplace skills.sh
npx skills list (alias ls)	Wyświetla wszystkie zainstalowane skills
npx skills update [skills...] (alias upgrade)	Aktualizuje zainstalowane skills do najnowszych wersji
npx skills remove [skills...]	Usuwa zainstalowane skills po nazwie
npx skills experimental_install	Odtwarza skills z zacommitowanego skills-lock.json

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/skills
npx skills add cloudflare/skills
npx skills add stripe/agent-toolkit

# Curated skill libraries
npx skills add wondelai/skills

# Individual skills from a library
npx skills add wondelai/skills/clean-architecture

# 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

remove operuje na nazwie zainstalowanego skilla, nie na ścieżce repozytorium. Uruchom je bez argumentu, aby skorzystać z interaktywnego selektora:

# Remove a single skill by name
npx skills remove web-design-guidelines

# Or pick interactively
npx skills remove

Aktualizacja Skills

# Update every installed skill
npx skills update

# Update one skill by name
npx skills update web-design-guidelines

Bez argumentu update (alias upgrade) sprawdza każde źródło i pobiera najnowszą wersję każdego zainstalowanego skilla. Podaj nazwę skilla, aby zaktualizować tylko ten jeden.

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

CLI instaluje skills dla Cursor do współdzielonego katalogu otwartego standardu:

.agents/skills/
  web-design-guidelines/
    SKILL.md
  vercel-react-best-practices/
    SKILL.md

Skills projektowe żyją w .agents/skills/<name>/SKILL.md; globalne skills idą do ~/.cursor/skills/. Cursor odczytuje oba i dołącza pasujące skills do kontekstu AI.

Claude Code

Claude Code przechowuje skills w dedykowanym katalogu, każdy z SKILL.md jako wymaganym punktem wejścia:

.claude/skills/
  web-design-guidelines/
    SKILL.md
  vercel-react-best-practices/
    SKILL.md

Skills projektowe żyją w .claude/skills/<name>/SKILL.md; osobiste skills idą do ~/.claude/skills/. Claude Code wykrywa je automatycznie i ładuje pełny SKILL.md skilla dopiero gdy staje się istotny.

Codex

Codex współdzieli ten sam katalog otwartego standardu co Cursor:

.agents/skills/
  web-design-guidelines/
    SKILL.md
  vercel-react-best-practices/
    SKILL.md

Codex skanuje .agents/skills/ od twojego katalogu roboczego w górę aż do korzenia repozytorium i odczytuje osobiste skills z ~/.codex/skills/. Ładuje pełny SKILL.md dopiero gdy zdecyduje się użyć skilla (progressive disclosure).

Notatka

Skills projektowe dla Cursor i Codex współdzielą katalog .agents/skills/ (otwarty standard Agent Skills); Claude Code używa .claude/skills/. CLI zapisuje w odpowiednim miejscu dla tych agentów, których wykryje.

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 .agents/skills/ .claude/skills/
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.

Każdy skill to katalog z punktem wejścia SKILL.md. SKILL.md potrzebuje pól frontmatter name i description, aby agent mógł zdecydować, kiedy go zastosować.

Cursor

Utwórz .agents/skills/project-conventions/SKILL.md:

---
name: project-conventions
description: This project's file structure, code style, and testing rules. Apply when generating or editing code in this repo.
---

## 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/SKILL.md:

---
name: project-conventions
description: This project's file structure, code style, and testing rules. Apply when generating or editing code in this repo.
---

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

Utwórz .agents/skills/project-conventions/SKILL.md (Codex współdzieli katalog .agents/skills/ z Cursor):

---
name: project-conventions
description: This project's file structure, code style, and testing rules. Apply when generating or editing code in this repo.
---

## 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ł .agents/, .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. Nie ma składni przypinania commita w add — @ wybiera nazwę skilla w obrębie repozytorium (owner/repo@skill-name), a nie referencję gita. Dla powtarzalności commituj rozwiązane pliki skills razem z wygenerowanym skills-lock.json, a następnie przywróć dokładnie te same wersje wszędzie poleceniem:

npx skills experimental_install

To reinstaluje każdy skill zapisany w skills-lock.json, więc twoi koledzy z zespołu i CI dostaną identyczny zestaw, który zacommitowałeś.

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.