Přeskočit na obsah

Instalujte a spravujte skilly

Tenhle návod ukazuje, jak do pracovního prostoru dostat skilly z GitHubu: přidat repozitář jako zdroj, nainstalovat z něj skilly, které chceš, a držet je aktuální.

Než začneš, jedno je třeba vědět: zdrojový repozitář je nedůvěryhodný. Jeho název, popis i počet hvězdiček píše ten, kdo ho vlastní. Jediný bezpečnostní signál, kterému Control Center věří, je verdikt antivirového skenu. Každá instalace jím projde, než se cokoli dostane na disk nebo do promptu agenta. Chceš-li zdůvodnění, přečti si sekci Skilly v modelu agentů; tahle stránka zůstává u postupu.

Skilly jsou v Nastavení → Pracovní prostor → Dovednosti (/workspaces/<id>/settings/workspace/skills). Patří k pracovnímu prostoru: co tu nainstaluješ, patří jen tomuhle pracovnímu prostoru. Stránka má dvě karty, Nainstalované (lokální skilly, včetně editoru Nová dovednost) a Zdroje (katalogy z GitHubu). Oba zápisy procházejí stejnou branou skenu.

Přidej repozitář se skilly

Sekce “Přidej repozitář se skilly”
  1. Otevři Nastavení → Pracovní prostor → Dovednosti a přepni na kartu Zdroje.
  2. Klepni na Přidat repozitář.
  3. Vlož URL repozitáře na GitHubu, třeba https://github.com/anthropics/skills, a potvrď.

Server ověří, že repozitář existuje a je s jeho přihlašovacími údaji viditelný, a přidá ho do lišty vlevo. Spravovaný katalog tu není: funguje libovolný repozitář na GitHubu, takže pověst si posuzuješ sám. Počet hvězdiček je doklad, nikdy záruka.

Skilly repozitáře jsou adresáře se souborem SKILL.md (až tři úrovně hluboko, plus rozložení Claude plugin-marketplace plugins/<plugin>/skills/<skill>; stromy závislostí a vendor se přeskakují). Když mřížka později hlásí, že repozitář žádné skilly nemá, znamená to právě tohle: žádný adresář v něm konvenci skillu neodpovídá.

Prohlédni si skill před instalací

Sekce “Prohlédni si skill před instalací”

Vyber repozitář v liště. Jeho skilly se vpravo objeví jako mřížka a nad ní je filtr, který katalog zužuje podle názvu, popisu nebo slugu. Klikni na kartu v mřížce a otevře se detail. Ukazuje tři věci:

  • README, vykreslené jako markdown. Je to README.md z adresáře skillu, nebo tělo SKILL.md, když README není.
  • Náhled skenu. Verdikt (pass, warn nebo quarantine), schopnosti, které obsah skillu deklaruje (spouští shell, zapisuje soubory, přístup k síti…), a každé zjištění, které skener zaznamenal.
  • Počet souborů. Instalace zapíše celý adresář skillu, nejen jeho SKILL.md.

Náhled skenuje přesně ty bajty, které by zapsala instalace, takže verdikt, který vidíš, je verdikt, který instalace dostane. Podruhé se to už neposuzuje.

  1. Otevři detail skillu.
  2. Přečti verdikt skenu. U verdiktu warn nebo pass klepni na Nainstalovat.
  3. U verdiktu quarantine zůstane Nainstalovat vypnuté, dokud nezaškrtneš Rozumím riziku — přesto nainstalovat. Přebití se zapíše. Nepředpokládá se.

Instalace zapíše adresář skillu do pracovního prostoru, do skills-lock.json uloží pin (zdrojový repozitář, cestu, commit, ze kterého přišel, a hash obsahu) a skill je k dispozici agentům v pracovním prostoru. Karta s označením Název se používá znamená, že ten název už lokálně vlastní jiný skill. Ten nejdřív odinstaluj.

Aktualizuj skilly v čase

Sekce “Aktualizuj skilly v čase”

Karty nainstalovaných skillů nesou odznaky: Nainstalováno, nebo Dostupná aktualizace, když se repozitář posunul za commit, ke kterému jsi skill připnul. Otevři detail a klepni na Aktualizovat. Skill se znovu stáhne na novém commitu. Aktualizace prochází stejnou branou skenu jako instalace. Skill, jehož nová verze skončí v karanténě, se odmítne a verze, kterou jsi měl, zůstane. Hash staré verze zůstane v zámku jako odkaz pro návrat.

Odinstaluj skill, odeber repozitář

Sekce “Odinstaluj skill, odeber repozitář”

Odinstalovat (v detailu nainstalovaného skillu, nebo Smazat na kartě Nainstalované) odebere adresář skillu i jeho pin v zámku najednou. Odinstalovaný skill po sobě nic nenechá.

Odebrání repozitáře z lišty odebere jen katalog. Skilly, které jsi z něj nainstaloval, zůstanou nainstalované a pořád se aktualizují, protože pin si repozitář pamatuje jménem, ne odkazem na položku zdroje. Chceš-li ho znovu procházet, přidej repozitář zpátky.

Skilly se vyvolávají ve vlastním jmenném prostoru, takže se nikdy nestřetnou s vestavěnými slash příkazy (/plan, /goal, /loop, /compact):

  • /skill:<name> — skill nainstalovaný v tomhle pracovním prostoru, nebo připojený k agentovi
  • /skill:<repo>:<name> — skill, který si veze repozitář vycheckoutovaný v tomhle prostoru

Holé jméno, které není vestavěný příkaz, se pořád vyřeší. Jde o zprávy napsané předtím, než jmenný prostor existoval. /skill:plan je to, co se dostane ke skillu jménem plan; /plan je vždycky vestavěný příkaz.

Skilly vázané na repozitář

Sekce “Skilly vázané na repozitář”

Vycheckoutovaný repozitář si může vézt vlastní skilly, v .agents/skills/, .agent/skills/, .claude/skills/, .opencode/skills/ nebo skills/. Přes tuhle stránku se neinstalují. Agent nese jen skilly repozitáře, ve kterém právě pracuje, a při přesunu se vymění. Composer takhle omezený není: /skill:<repo>:<name> dosáhne na libovolný repozitář v prostoru.

Skilly repozitáře projdou stejným skenem, který bez verdiktu nic nepropustí (pass / warn / quarantine), než se jejich frontmatter dostane do promptu. warn se připustí, quarantine se zadrží a na téhle cestě operátor přebití nemá.

Viz Skilly vázané na repozitář a Slash příkazy.