Instaluj i zarządzaj skillami

Ten poradnik pokazuje, jak zapełnić obszar roboczy skillami z GitHuba: dodaj repozytorium jako źródło, zainstaluj wybrane z niego skille i utrzymuj je aktualne w czasie.

Najważniejsza rzecz do wiedzenia przed startem: repozytorium źródłowe jest niezaufane. Jego nazwę, opis i liczbę gwiazdek pisze ten, kto nim zarządza. Jedynym sygnałem bezpieczeństwa, któremu ufa Control Center, jest werdykt skanu antywirusowego, przez który przechodzi każda instalacja, zanim cokolwiek trafi na dysk albo do promptu agenta. Jeśli chcesz poznać uzasadnienie, przeczytaj sekcję o skillach w modelu agentów; ta strona koncentruje się na działaniu.

Skille znajdują się w Ustawienia → Obszar roboczy → Umiejętności (/workspaces/<id>/settings/workspace/skills). Mają zasięg obszaru roboczego: skille zainstalowane tutaj należą wyłącznie do tego obszaru roboczego. Strona ma dwie karty: Zainstalowane (skille lokalne, w tym edytor Nowa umiejętność) i Źródła (katalogi GitHub). Oba zapisy przechodzą przez tę samą bramkę skanu.

Dodaj repozytorium skilli

Otwórz Ustawienia → Obszar roboczy → Umiejętności i przełącz się na kartę Źródła.
Kliknij Dodaj repozytorium.
Wklej URL repozytorium GitHub, np. https://github.com/anthropics/skills, i potwierdź.

Serwer sprawdza, czy repozytorium istnieje i jest widoczne z użyciem jego poświadczeń, a następnie dodaje je do lewego panelu. Nie ma pośrodku żadnego kuratorowanego sklepu: każde repozytorium GitHub się nada, co oznacza też, że reputację oceniasz na własną rękę — liczba gwiazdek to poszlaka, nigdy gwarancja.

Skillami w repozytorium są katalogi zawierające plik SKILL.md (do trzech poziomów w głąb, plus układ Claude plugin-marketplace plugins/<plugin>/skills/<skill>, z pominięciem drzew zależności i vendor). Jeśli siatka później pokaże, że repozytorium nie ma skilli, to dokładnie to znaczy: żaden katalog w nim nie pasuje do konwencji skilli.

Zbadaj skill przed instalacją

Wybierz repozytorium w lewym panelu; jego skille pojawiają się jako siatka po prawej, a nad nią znajduje się pole filtra, które zawęża katalog według nazwy, opisu lub sluga. Kliknij kartę, aby otworzyć widok szczegółów. Pokazuje on trzy rzeczy:

README, renderowany jako markdown — plik README.md katalogu skilla albo treść SKILL.md, gdy nie ma README.
Podgląd skanu — werdykt (pass, warn lub quarantine), możliwości deklarowane przez treść skilla (uruchamia powłokę, zapisuje pliki, dostęp sieciowy…) i każde ustalenie zarejestrowane przez skaner.
Liczbę plików — instalacja zapisuje cały katalog skilla, nie tylko jego SKILL.md.

Podgląd skanuje dokładnie te bajty, które zapisałaby instalacja, więc werdykt, który widzisz, jest werdyktem, jaki otrzyma instalacja; nic nie jest oceniane ponownie za Twoimi plecami.

Zainstaluj skill

Otwórz widok szczegółów skilla.
Przeczytaj werdykt skanu. Przy werdykcie warn lub pass kliknij Zainstaluj.
Przy werdykcie quarantine instalacja pozostaje nieaktywna, dopóki nie zaznaczysz pola Rozumiem ryzyko — zainstaluj mimo to. To wymuszenie jest rejestrowane, a nie zakładane.

Instalacja zapisuje katalog skilla w obszarze roboczym, odnotowuje przypięcie w skills-lock.json (repozytorium źródłowe, ścieżkę, commit, z którego pochodzi, oraz hash treści), a skill staje się dostępny dla agentów w obszarze roboczym. Karta z oznaczeniem Nazwa zajęta oznacza, że ta nazwa należy już lokalnie do innego skilla — najpierw odinstaluj tamten.

Aktualizuj skille w czasie

Karty zainstalowanych skilli noszą plakietki: Zainstalowany lub Dostępna aktualizacja, gdy repozytorium wyprzedziło commit, do którego przypiąłeś skill. Otwórz widok szczegółów i kliknij Aktualizuj, aby pobrać go ponownie w nowym commicie. Aktualizacja przechodzi przez tę samą bramkę skanu co instalacja — skill, którego nowa wersja trafia do kwarantanny, zostaje odrzucony, a wersja, którą miałeś, pozostaje bez zmian. Hash starej wersji jest zachowywany w pliku lock jako referencja do wycofania.

Odinstaluj skill, usuń repozytorium

Odinstaluj (w widoku szczegółów zainstalowanego skilla albo usuń na karcie Zainstalowane) usuwa razem katalog skilla i jego przypięcie w pliku lock — odinstalowany skill nie zostawia po sobie nic.

Usunięcie repozytorium z lewego panelu usuwa tylko katalog: skille, które z niego zainstalowałeś, pozostają zainstalowane i nadal się aktualizują, bo przypięcie zapisuje repozytorium po nazwie, a nie przez odniesienie do wpisu źródła. Dodaj repozytorium ponownie, jeśli chcesz je znowu przeglądać.

Wywołaj skill

Skille są wywoływane w swojej własnej przestrzeni nazw, więc nigdy nie kolidują z wbudowanymi poleceniami slash (/plan, /goal, /loop, /compact):

/skill:<name> — skill zainstalowany w tym obszarze roboczym albo przypisany do agenta
/skill:<repo>:<name> — skill dostarczany przez repozytorium wyewidencjonowane w tej przestrzeni

Nazwa bez prefiksu, o ile nie jest wbudowana, nadal się rozwiązuje — dla wiadomości napisanych, zanim powstała ta przestrzeń nazw. /skill:plan to sposób, by dotrzeć do skilla o nazwie plan; /plan zawsze oznacza polecenie wbudowane.

Skille w zakresie repozytorium

Wyewidencjonowane repozytorium może dostarczać własne skille, w .agents/skills/, .agent/skills/, .claude/skills/, .opencode/skills/ lub skills/. Te nie są instalowane przez tę stronę. Agent nosi tylko skille repozytorium, w którym aktualnie pracuje; wymieniają się, gdy agent się przenosi. Kompozytor nie ma takiego ograniczenia: /skill:<repo>:<name> dociera do dowolnego repozytorium w przestrzeni.

Skille repozytorium przechodzą ten sam skan w trybie fail-closed (pass / warn / quarantine), zanim ich frontmatter trafi do promptu. warn jest dopuszczany; quarantine jest wstrzymywany, bez możliwości wymuszenia przez operatora na tej ścieżce.

Zob. Skille w zakresie repozytorium i Polecenia slash.

Powiązane poradniki

Powiązane koncepcje

Model agentów