Ako vybrať plugin a bezpečne ho nainštalovať

Jeden skill citeľne vylepšil stránku a ďalší krok sa ponúka sám: nainštalovať nie jeden, ale rovno desať. Hneď nato pošle kolega odkaz: "nainštaluj, je to užitočná vec". Všetko sa to inštaluje jedným príkazom, a práve v tom je pasca. Plugin vyzerá ako zoznam schopností, no v skutočnosti je to kód, ktorý pobeží u vás na počítači s vašimi právami a zaberie miesto v každom rozhovore s agentom.

Rozoberieme, čím sa plugin líši od skillu a čo v ňom môže ležať, odkiaľ sa berú katalógy a ako rozoznať spoľahlivý zdroj od náhodného, čo Claude Code ukáže pred inštaláciou a ako to čítať. Potom prejdeme celú cestu: nainštalovať, vyskúšať na vlastnej úlohe, vypnúť, odstrániť. Na konci - čo urobiť pred každou inštaláciou a prečo to isté stojí za to urobiť s akýmkoľvek skillom, ktorý agent priniesol z internetu.

1. Skill a plugin

Stolár má zapísané postupy: ako pripraviť pracovný stôl, ako brúsiť, ako vyrobiť sériu podľa šablóny. Kým pracuje sám, ležia mu v zošite. Potom si o jeden požiada sused z dielne, o druhý učeň a o mesiac zavolá dielňa cez ulicu, a posielať každému samostatný lístok už otravuje. Vtedy pozbiera niekoľko postupov do škatule, na bok dá pečať dielne a dnu vloží lístok: čo tu je a ako to používať. Takú škatuľu možno odovzdať celú, aktualizovať a očíslovať.

To je presne plugin. Nie ďalšia schopnosť, ale obal okolo viacerých.

Sám osebe plugin nie je samostatná schopnosť, ale spôsob, ako rozdať viacero naraz. Všetko, čo dokáže, dokáže cez to, čo je vo vnútri: schopnosti, pomocníkov, automatické reakcie, pripojenia. Preto sa otázka "čo plugin vie" vždy zúži na inú: čo je vo vnútri.

Vlastný plugin sa skladá vtedy, keď o vaše skills začnú žiadať aj iní. Ak neviete presne, čo potrebujete - skill, pomocníka s vlastnou rolou alebo plugin -, opýtajte sa agenta, ale požiadajte ho, nech vám najprv položí otázky a neskladá hneď: pripraví návrh, no čo je vo vnútri, kontrolujete vy. Orientačné pravidlo je jednoduché: opakujete tú istú požiadavku - skill; vedľajšia práca zapratáva rozhovor - pomocník; tú istú sadu potrebujete v inom projekte - plugin. Ako sa plugin skladá krok za krokom, je samostatná téma. Tento článok je pre tých, ktorí škatuľu dostávajú.

2. Čo je vo vnútri pluginu

Najčastejšie má škatuľa päť priehradiek, a nie sú rovnako neškodné.

• skills - postupy, ktoré agent aplikuje sám podľa popisu alebo na váš príkaz;
• agents - pomocníci s vlastnou rolou, ktorým agent zverí časť práce;
• hooks - automatické reakcie na udalosti: spustia príkazy bez vašej žiadosti, keď sa niečo stane;
• MCP servers - pripojenia k externým službám, cez ktoré agent číta a mení niečo mimo vášho počítača;
• LSP servers - nápoveda ku kódu pre konkrétny jazyk; potrebujú samostatne nainštalovaný program.

Dve spodné priehradky sú dôvod, prečo sa škatuľa berie vážne, a nie odsúva do kúta. Plugin s hooks a MCP vie to, čo od "sady schopností" nečakáte: spúšťať príkazy a chodiť do externých služieb. Vo vnútri je živý nástroj pod prúdom, nie plagát na stenu. Čo presne sú hooks, MCP a agents zvlášť, je samostatná téma; tu stačí vedieť, čo znamenajú ako súčasť balíka. Priehradiek býva aj viac než týchto päť, napríklad predvolené nastavenia alebo štýl odpovedí agenta, no celkový obraz nemenia.

Ak kartu nemáte po ruke, požiadajte agenta, nech otvorí repozitár pluginu a povie, čo leží v jeho priečinkoch.

3. Názov s prefixom

Skills z pluginu sa volajú s prefixom: /názov-pluginu:názov-skillu, napríklad /commit-commands:commit. Sused môže mať tiež "upratovanie" a kým je na škatuli pečať, nepomýlite si ich.

Cenou je dlhší názov: za spoločnú sadu sa platí tým, že príkaz sa píše dlhšie. Vlastný skill v priečinku projektu prefix nemá.

Je v tom aj úžitok. Podľa prefixu v menu po / je vždy vidno, odkiaľ príkaz prišiel a čia je to škatuľa.

4. Katalóg a dva kroky

Škatule sa berú zo skladu. Katalóg pluginov, po anglicky marketplace, je zoznam cudzích pluginov, ktorý niekto vedie. Práca s ním má dva kroky: pridať katalóg, potom z neho inštalovať plugin po plugine. Samotné pridanie katalógu nič neinštaluje, dostanete len zoznam.

Prvý krok má väčšina už hotový. Príkaz /plugin otvorí panel so štyrmi záložkami: Discover - hľadať pluginy vo všetkých pripojených katalógoch; Installed - čo je nainštalované; Marketplaces - katalógy; Errors - chyby pri načítaní. Oficiálny katalóg Anthropic je pripojený od prvého spustenia a jeho pluginy vidno v Discover hneď: vybrať, otvoriť, nainštalovať. Ten istý zoznam je aj na stránke claude.com/plugins, ak sa chcete pozrieť bez Claude Code.

Druhý katalóg sa objaví vtedy, keď potrebný plugin v oficiálnom nie je: katalóg komunity alebo cudzí repozitár, v ktorom leží súbor katalógu. Pripája sa jedným príkazom, plugin z neho sa inštaluje tiež jedným:

/plugin marketplace add anthropics/claude-plugins-community   # pripojiť katalóg komunity
/plugin install názov-pluginu@claude-community                # nainštalovať jeden plugin z neho
/plugin list                                                  # skontrolovať, že plugin je v zozname

Cudzí katalóg sa pripája tým istým prvým príkazom, len s jeho adresou.

Jedna jemnosť, na ktorej sa ľudia potknú najčastejšie (ja nie som výnimkou). Názov katalógu na inštaláciu sa neberie z názvu repozitára, ale z popisu samotného katalógu: repozitár sa volá anthropics/claude-plugins-community, ale inštaluje sa z claude-community. Aký názov katalóg má, vidno v záložke Marketplaces.

V oficiálnom katalógu ležia pluginy rôznych typov. Integrácia s GitHubom je MCP, pripojenie k externej službe. Nápoveda ku kódu pre jazyk, povedzme typescript-lsp, je LSP. security-guidance kontroluje každú zmenu agenta na bežné zraniteľnosti.

5. Tri stupne dôvery k zdroju

Z priečinka sa plugin sám nenačíta: treba ho nainštalovať výslovne, a nie je to byrokracia. Vo vnútri je kód, ktorý sa vykoná s vašimi právami, čiže dokáže presne to isté ako vy na tomto počítači. Preto prvá otázka pri každom plugine nie je "čo vie", ale "odkiaľ je".

Oficiálny katalóg. Vedie ho Anthropic, ale väčšina pluginov v ňom pochádza od partnerov a ďalších autorov, nie od samotnej Anthropic. Pozornosti tu treba menej ako pri cudzom repozitári, ale popis a obsah si aj tak oplatí prečítať.

Katalóg komunity. Pluginy tretích strán, ktoré prešli automatickou kontrolou Anthropic; takmer každý je viazaný na konkrétnu verziu v katalógu. Je to filter, nie záruka: či plugin robí presne to, čo sľubuje, nikto neoveril.

Ľubovoľný repozitár alebo priečinok. Žiadna kontrola. Sami si pozriete, kto je autor, či je popis zrozumiteľný a čo leží v priečinkoch.

V jednej pracovnej relácii sa môžu stretnúť všetky tri stupne: dizajnový plugin z katalógu komunity, ďalší z katalógu Anthropic, tretí z cudzieho repozitára s jediným pluginom vo vnútri. To je v poriadku, ak viete, na akom stupni práve stojíte.

Mieru voľte podľa pluginu. Čím viac vie, teda čím viac má hooks a MCP, a čím ďalej je zdroj od oficiálneho, tým pozornejšie sa pozerajte.

6. Čo Claude Code ukáže pred inštaláciou

Zdroj určuje, ako pozorne sa pozerať. Detaily ukáže Claude Code sám: otvorte plugin zo záložky Marketplaces panela /plugin alebo príkazom /plugin install názov@katalóg a uvidíte jeho kartu. Karta zo zoznamu Discover je kratšia: odhad ceny v nej nie je.

Sú v nej tri riadky, kvôli ktorým sa to celé začalo. Posledné dva majú len pluginy z oficiálneho katalógu.

• Will install - obsah: koľko skills, agents, hooks, MCP a LSP pribudne;
• Context cost - koľko plugin pridá do okna agenta: Every turn - pri každej vašej požiadavke, When invoked - keď agent načíta jeho skills a agents;
• Last updated - kedy bol plugin naposledy aktualizovaný.

Will install:  skills: 8   agents: 1   hooks: 2   MCP servers: 1
Context cost:  Every turn: ~400 tokens   When invoked: ~1.5k tokens
Last updated:  2 weeks ago

Čísla aj podoba riadkov sú orientačné, každý plugin a každá verzia Claude Code má svoje. Čítať obsah je jednoduché, ale je to len prvé priblíženie: ak sú vo vnútri len skills, plugin skôr číta a radí; sú tam hooks alebo MCP, spúšťa príkazy alebo chodí von, a to je dôvod otvoriť popis a zistiť, ktoré presne. Karta neukazuje všetko: plugin môže priniesť aj spustiteľné súbory a predvolené nastavenia, ktoré v nej nie sú. Pri neznámom zdroji nazrite aj do repozitára.

A tretia otázka, ktorú karta nepoloží: hodí sa plugin vám. Aj dobrý plugin pokojne nemusíte inštalovať. Duplikuje váš skill, ťahá skripty pre iný operačný systém alebo rieši úlohu, ktorú nemáte.

7. Komu plugin pripadne

Komu škatuľa pripadne, sa rozhoduje vopred, pri inštalácii. Sú tri možnosti.

• user - vám, vo všetkých projektoch;
• project - všetkým, ktorí pracujú s týmto repozitárom: záznam ide do .claude/settings.json a cestuje spolu s projektom;
• local - vám a len v tomto projekte, kolegom to nie je vidno.

Existuje aj managed: nainštaluje ho administrátor a meniť sa nedá. Väčšina sa s ním nestretne.

Jedno pravidlo: najužší vhodný scope. Čím menej miest, kde je plugin zapnutý, tým menej situácií, v ktorých vôbec beží, a tým menej vecí treba neskôr upratovať. Pochybný plugin sa úzkym scope nezneškodní: tam, kde je zapnutý, dokáže presne to isté. Project scope si zaslúži samostatnú vetu: rozhodujete nielen za seba. Kolegovi, ktorý otvorí repozitár, bude plugin zapnutý, ale nenainštalovaný: v záložke Errors panela /plugin sa objaví upozornenie a nainštalovať plugin musí sám.

Pri inštalácii z panela sa na scope pýta; /plugin install tiež otvorí kartu s výberom.

8. Nainštalovať a skontrolovať

Ak inštalácia prebehla hladko, skončí jednou z dvoch viet. Buď je plugin už aktívny, alebo príde žiadosť spustiť /reload-plugins. V druhom prípade ho spustite; ak príkaz upozorní, že opätovné načítanie znovu prečíta rozhovor, zopakujte to s --force. Reštartovať Claude Code netreba.

Že sa plugin usadil, vidno cez /plugin list: je v zozname a jeho skills sa objavili pod prefixom v menu po /.

Otvorená škatuľa zaberá pracovný stôl. Zapnutý plugin od prvej sekundy pridáva do okna agenta oznámenia svojich skills: názvy a popisy. Celý obsah sa dotiahne, až keď skill ide do práce, ale oznámenia visia stále. Pri pripojeniach k externým službám prídu hneď názvy nástrojov, popisy podľa potreby; automatické reakcie okno takmer nezaberajú. Čím je okno plnšie, tým je každá odpoveď drahšia a pomalšia.

Skutočnú cenu vidno len porovnaním: /context ukáže, čím je okno zaplnené. Spustite ho pred inštaláciou aj po nej.

1) bez pluginu: vlastná úloha, výsledok si zapamätať
2) nainštalovať plugin, podľa potreby /reload-plugins
3) tá istá úloha znova
4) porovnať a rozhodnúť: ponechať, vypnúť, odstrániť

Výsledok porovnania tu zámerne chýba: každý ho má vlastný. Kritérium je jednoduché: viete v dvoch vetách povedať, čo plugin robí, a uviesť jeden dôvod ho ponechať alebo odstrániť - z vlastného behu, nie z popisu.

9. Vypnúť, odstrániť, zrušiť katalóg

Tri akcie, a sú rôzne. /plugin disable vypne, ale neodstráni: plugin prestane zaberať okno a vrátiť ho späť sa dá cez /plugin enable. /plugin uninstall odstráni úplne. /plugin marketplace remove zruší katalóg, a spolu s ním sa odstránia všetky pluginy, ktoré sa z neho inštalovali. Na to sa ľahko zabúda.

/plugin disable názov-pluginu@katalóg      # vypnúť, ale nestratiť
/plugin uninstall názov-pluginu@katalóg    # odstrániť úplne
/plugin marketplace remove katalóg         # zrušiť katalóg a všetko, čo sa z neho inštalovalo

Príkazy otvoria ten istý panel a nechajú ho otvorený, zavrieť sa dá cez Esc. V záložke Installed sa to isté robí bez príkazov: problémové pluginy sú zobrazené hore, vypnuté zbalené dole. Ak odstraňujete plugin zapnutý pre celý projekt, Claude Code sa opýta: len u vás, alebo pre všetkých.

Upratovanie. Pluginy, ktoré ste si nainštalovali sami a nepoužili ste ich dva týždne v priebehu desiatich relácií, Claude Code zoskupuje v záložke Installed pod nadpisom "Not used recently" a na karte ukáže, kedy plugin naposledy pracoval. Samostatne /doctor vymenuje nepoužívané pluginy spolu s ich cenou v kontexte. sada nástrojov zostáva sadou, pokým si pamätáte, čo v ňom je a prečo.

Aktualizácie. Oficiálne katalógy sa aktualizujú samy a žiadajú spustiť /reload-plugins; tie od tretích strán štandardne nie. Aktualizácia je takmer nová inštalácia: obsah sa môže zmeniť a kartu sa oplatí otvoriť znova.

Ak sa niečo pokazilo, aj priamo pri samotnej inštalácii: záložka Errors ukáže dôvod. Ďalej vypnúť, preinštalovať, v krajnom prípade vyčistiť cache pluginov a nainštalovať znova. Ak z Marketplaces zmizol oficiálny katalóg, vráti ho /plugin marketplace add anthropics/claude-plugins-official.

10. Nielen pluginy

Skill, ktorý agent na vašu žiadosť stiahol z cudzieho repozitára a vložil do priečinka projektu, je ten istý prípad, len bez katalógu, karty a scope. Nemá ho kto skontrolovať okrem vás.

Otázky sú tie isté. Odkiaľ je. Čo je vo vnútri: SKILL.md sa prečíta za minútu, ale kontroluje sa celý priečinok - aj skripty a súbory, na ktoré odkazuje. Aké nástroje si vopred povoľuje: pole allowed-tools. To ukazuje, čo je vopred schválené bez samostatnej otázky, nie úplný zoznam toho, čo sa môže stať. Skill z repozitára cudzej služby si celkom môže povoliť spúšťať príkazy, a pre skill, ktorý niečo posiela von, je to normálne. Ale vidieť to treba pred prvým spustením, nie po ňom.

Rozdiel oproti pluginu je jeden. Skill nemá kartu, zato celý jeho obsah leží hneď vedľa ako obyčajný text a prečítať si ho dá pred prvým spustením.

11. Čo urobiť pred každou inštaláciou

Šesť krokov, v poradí, v akom išli v článku.

1. Zdroj. Oficiálny katalóg, katalóg komunity alebo cudzí repozitár - to určuje, ako pozorne sa pozerať ďalej.
2. Obsah. Karta "Will install"; hooks a MCP znamenajú príkazy a výstup von, pre ne otvoriť popis.
3. Cena. "Context cost" na karte (pri oficiálnom katalógu) a /context pred a po: plugin sa platí z každej vašej požiadavky.
4. Scope. Najužší vhodný; project scope je rozhodnutie aj za kolegov.
5. Skúšobný beh. Jedna úloha pred a po, záver z vlastného testu, nie z popisu.
6. Rozhodnutie. Ponechať, vypnúť alebo odstrániť; o pár týždňov záložka Installed pripomenie, čo sa nepoužívalo.

Škatuľa s pečaťou bola vymyslená na to, aby sa postupy dali odovzdávať celé a bez posielania lístkov, a funguje to obojstranne. Ten, kto škatuľu dostáva, sa pozrie na pečať, otvorí veko a na pracovný stôl si položí len to, čo dnes potrebuje.

Panel pluginov a text jeho hlásení sa menia s verziou; ak sa vaša obrazovka líši od popísanej, riaďte sa významom riadkov, nie ich presným vzhľadom.