Skills: ako nasadiť agentovi hotovú zručnosť

Máte požiadavku, ktorú stále opakujete: pozri zmeny, skontroluj tieto súbory, sformátuj to takto a sem nelez. Zakaždým vysvetľujete procedúru nanovo a trochu inak.

Výsledok sa mení spolu s formuláciou. Dnes to vyšlo perfektne, zajtra ste zabudli polovicu podmienok a agent poctivo urobil to, čo počul.

Nerieši sa to pamäťou agenta, ale priečinkom s inštrukciou. Skill je raz zapísaná procedúra, ktorú Claude Code môže pripojiť sám alebo na váš príkaz. Rozoberieme, kde tento priečinok leží, ako si overiť, že sa skill načítal, a čo skontrolovať pred prvým spustením.

Čo je to skill

Skôr než rozoberieme súbory a polia, vytvorme si intuitívnu predstavu.

Predstavte si stolára. Raz si zapísal zaužívaný postup práce, pripravil si poznámky, šablóny a program pre stroj. Teraz stačí stručne: "uprac všetko, naostri vrták, ďalej stolička pre mačku - spusti CNC šablónu". Spustil - a ide sa.

Zapísaná procedúra drží celú prácu pokope:

• Robí poriadok podľa vašich pravidiel. Upratuje pracovný stôl, rozkladá náradie - zakaždým rovnako, presne ako ste zvyknutí.
• Dodržiava zapísané hranice. Píla sa ešte točí - nesiahne na ňu. Bezpečnú časť práce urobí hneď, bez zbytočných otázok.
• Nahliadne do poznámok, keď treba. Treba naostriť vrták - otvoril pravidlo o ostrení. Nedrží ho v hlave vopred, vytiahne ho, až keď ho potrebuje.
• Má šablóny na rôzne práce. Po stole prišli na rad stoličky - vezme hotovú schému prípravy.
• Spúšťa zložité veci jedným príkazom. Program opakovaných rezov už leží vedľa. Stačí povedať: "nájdi šablónu Stolička pre mačku a pusti ju na CNC" - stroj dodrží vôle aj poradie operácií.

Skill funguje rovnako. Nie je to ďalší nástroj v rukách agenta, ale zabalená procedúra. Hlavná inštrukcia uchováva poradie a hranice, príručky dodajú detaily, keď sú potrebné, šablóny držia polotovary a skripty spúšťajú opakovanú mechaniku. Raz to opíšete - potom to už len voláte.

Samotný formát skillu nič neizoluje. Inštrukcia môže obmedziť prácu len na vzhľad, ale technická stena medzi CSS a logikou neexistuje. Dobrý skill jasne vymedzí oblasť práce; po spustení si pozriete zmenené súbory a skontrolujete správanie stránky. "Funguje" a "vyzerá" sú rôzne vrstvy a záruku dáva kontrola, nie formát.

Kde sa skill nachádza

Žiadna mágia v cloude tu nie je. Skill je priečinok na disku, priamo vo vašom projekte:

.claude/skills/web-design/SKILL.md

Cestu si rozoberme po častiach: servisný priečinok .claude, v ňom skills, v ňom priečinok samotného skillu (názov vymýšľate vy) a v ňom súbor SKILL.md. Obyčajný textový súbor, otvoríte ho čímkoľvek.

Pri skilloch v projekte a v domovskom priečinku sa názov adresára stáva názvom príkazu s lomkou, ak samotný súbor neurčuje iný názov (viac o tom nižšie). Vymýšľajte ho teda hneď s ohľadom na to, ako bude vyzerať v chate.

Teraz oprava najčastejšej predstavy: skill nie je jeden súbor, ale priečinok. Vedľa SKILL.md môže ležať čokoľvek.

.claude/
└── skills/
    └── web-design/
        ├── SKILL.md      # hlavný súbor: popis a inštrukcia
        ├── palettes.md   # príručka, agent si ju otvorí, ak bude potrebná
        └── scripts/
            └── check.py  # skript, ktorý sa dá spustiť

Pri automatickom výbere má agent k dispozícii názov a krátky popis skillu, nie celé telo. SKILL.md sa načíta pri spustení, susedné príručky - podľa potreby. Preto dlhá príručka nezaberá kontext vopred.

Pre bežnú lokálnu prácu sú dôležité tri zdroje skills:

Znak ~ označuje domovský priečinok používateľa. V príkazoch ho nechávajte tak, ako je; ak priečinok otvárate ručne, prejdite do svojho domovského adresára.

Rozdiel medzi prvými dvoma miestami je jednoduchý a oplatí sa ho pochopiť hneď.

Dali ste priečinok do projektu - skill funguje len v tomto projekte. Otvoríte vedľajší a tam nie je.

Skill v domovskom priečinku je dostupný vo všetkých projektoch. Pre všeobecnú procedúru je to pohodlné, no môže sa zapnúť tam, kde ste ho nečakali. Univerzálne veci sa dávajú domov, projektové zostávajú v projekte.

Ak je Claude Code spustený so samostatným kurzovým profilom ~/.claude-codegym/, osobné skills ležia v jeho priečinku skills/. Projektová cesta .claude/skills/ sa profilom nemení.

Description rozhoduje, kedy sa skill spustí

Typická situácia: priečinok ste pridali, súbor je na mieste, ale agent sa správa presne ako predtým. Nič sa nepokazilo - len nepochopil, že sem tento skill patrí.

Pozrite sa, čo má agent k dispozícii v momente výberu. Telo samotného skillu ešte nečítal: načítaný je len zoznam názvov a popisov. Rozhoduje sa teda podľa popisu a podľa ničoho iného.

Zostavme minimálny skill pre projekt od začiatku do konca. Volá sa web-design - tak sa volá priečinok a odtiaľ sa berie aj príkaz /web-design. Osobitne do súboru tu názov nepíšeme, priečinok ho už určil:

.claude/skills/web-design/SKILL.md

A vo vnútri je toto, nič viac netreba:

---
description: Dáva webové rozhranie do poriadku - moderné CSS, plynulé prechody,
  zladená paleta. Použiť, keď niekto chce, aby to bolo pekné alebo štýlové.
---

# Webový dizajn

Používaj jemné tiene, plynulé prechody a premyslenú typografiu.
Paletu drž zladenú, animácie - pri prejdení myšou a pri objavení prvkov.

Hore, medzi trojitými pomlčkami, je servisný blok, dole obyčajný text inštrukcie. Povinné polia neexistujú, ale description sa oplatí písať vždy: bez neho agent háda účel skillu podľa prvého odseku tela, a to je lotéria.

Dobrý popis odpovedá na dve otázky: čo skill robí a kedy ho použiť. A to presne tými slovami, akými naozaj píšete požiadavky.

# mlčí: nie je jasné, kedy ho použiť
description: Pomáha so vzhľadom

# funguje: povedané, čo robí aj kedy
description: Dáva rozhranie do poriadku - CSS, typografia, paleta.
  Použiť, keď niekto chce, aby to bolo pekné, štýlové, alebo opraviť layout.

Popis rozhoduje o tom, kedy sa skill spustí sám. Nie je to však jediný vstup: skill má názov a podľa neho ho môžete zavolať ručne. Napíšete /web-design - a na popise vôbec nezáleží, súbor sa prečíta a vykoná.

V hotových skilloch sa často objavuje pole name. Pri skilloch v projekte a v domovskom priečinku toto pole určuje príkaz, ktorý sa zobrazí v menu po zadaní /: priečinok deploy-staging s name: deploy sa volá ako /deploy. Názov adresára pritom funguje ďalej. V plugine môže name určiť poslednú časť príkazu za názvom pluginu.

Cesty k spusteniu sú teda dve a všetko, čo nasleduje po nich, je rovnaké.

Ľavá vetva je automatická: požiadavka sa zhodla s popisom a agent siahol po skille. Pravá je ručná: napísali ste /web-design a skill sa spustil bez ohľadu na popis.

Skills sa dostanú do toho istého menu po / ako vstavané príkazy. Súbor .claude/commands/deploy.md a skill .claude/skills/deploy/SKILL.md vytvárajú ten istý príkaz /deploy; ak existujú oba, vyhráva skill.

Inštalácia a kontrola

Priečinok je na mieste. Ako zistiť, že ho agent naozaj vidí, a nie že len leží súbor na disku?

/skills

Príkaz otvorí zoznam skills a ukáže ich zdroj. Napíšte pár písmen - zoznam sa vyfiltruje. Našli ste názov svojho priečinka a stav on - Claude Code skill vidí a jeho spustenie povoľuje.

Názov, zdroj a stav on potvrdzujú, že je skill dostupný

Nový alebo zmenený SKILL.md Claude Code zvyčajne zachytí za chodu. Ak názov v zozname nie je, skúšajte postupne:

Skill v zozname je, ale sám sa nezapína? Reštart s tým nesúvisí. Skontrolujte description a pole disable-model-invocation: true - to ponechá len ručné spustenie. Preformulujte požiadavku alebo zavolajte skill podľa názvu. Ručné volanie funguje - inštalácia je teda v poriadku.

Čo skontrolovať, kým mu začnete dôverovať

Tu treba nadšenie trochu schladiť. Skill nie je téma vzhľadu ani obrázok, ktorý nasadíte a zase zložíte. Sú to inštrukcie, ktoré váš agent vykoná vo vašom projekte.

Kontrolovať treba nielen hlavný súbor, ale celý priečinok. Začnite štyrmi vecami:

• popis - či zodpovedá tomu, čo od skillu čakáte, a či sa nespúšťa príliš široko;
• telo a odkazy z neho - čo skill prikazuje robiť a ktoré susedné súbory žiada otvoriť;
• priečinok scripts/, ak existuje, - aké príkazy sa v ňom spúšťajú, na ktoré súbory a sieťové adresy siahajú;
• pole allowed-tools - ktoré nástroje skill vopred povoľuje používať bez samostatnej otázky.

---
name: pre-commit-style
description: Zjednotí štýl projektu pred commitom
allowed-tools: Read, Write, Edit, Glob
---

Pole allowed-tools tu neopisuje plán práce a neobmedzuje celú sadu možností agenta. Len vopred schvaľuje uvedené nástroje pre ten krok, v ktorom bol skill zavolaný. Názvy sa dajú rozlúštiť jednoducho:

• Read - čítať súbory;
• Write - vytvárať nové súbory a celé prepisovať existujúce;
• Edit - robiť úpravy vo vnútri existujúceho súboru;
• Glob - hľadať súbory podľa masky, čiže prechádzať projekt a pozerať, čo v ňom vôbec je.

Prvý a posledný sa len pozerajú. Write a Edit vedia súbory meniť: ak inštrukcia povedie k takej akcii, samostatná otázka v tomto kroku prísť nemusí. Povolenie však neznamená, že ho agent nutne využije. Všeobecné pravidlá prístupu v projekte pritom platia ďalej.

Samo osebe to pole nie je zlo: odstraňuje zbytočné potvrdenia tam, kde práve to chcete. Sadu nástrojov však vyberal autor skillu, preto sa ju oplatí pozrieť pred prvým spustením.

A posledná vec, menej strašidelná, ale oveľa častejšia. Skill agenta usmerňuje, ale výsledok nezaručuje. Po spustení si pozrite zmenené súbory a skontrolujte výsledok: skill na vzhľad môže stránku skrášliť, ale za funkčnosť tlačidla ručiť nebude.

Kde vziať hotové

Písať SKILL.md od nuly len preto, aby ste si to vyskúšali, vôbec nie je nutné. Hotové skills sa najčastejšie nájdu v otvorených repozitároch alebo prídu spolu s pluginmi.

Najkratšia cesta je požiadať agenta, aby našiel vhodnú možnosť, ale neinštaloval ju naslepo. Formulácia môže byť napríklad takáto:

Nájdi skill na úpravu vzhľadu rozhraní. Ukáž zdroj, SKILL.md a skripty,
vysvetli, aké súbory a nástroje používa. Kým to nepotvrdím,
nič neinštaluj.

Keď ste si pozreli zdroj a obsah, požiadajte agenta, aby priečinok vložil do .claude/skills/ projektu, a výsledok skontrolujte cez /skills.

Na samostatné hľadanie sa hodí dopyt Claude skills marketplace. Katalóg pomáha nájsť možnosti, ale nie je zárukou bezpečnosti: obsah si aj tak treba prečítať pred inštaláciou.

SKILL.md sa riadi otvoreným štandardom Agent Skills, takže základná štruktúra sa dá prenášať medzi rôznymi agentmi. Claude Code však pridáva vlastné polia a spôsoby spúšťania. Ak skill prenesiete do iného nástroja, overte si, ktoré možnosti tam naozaj podporuje.

Vlastný skill si môžete zostaviť s agentom

Moment, keď je čas založiť si vlastný skill, spoznáte aj bez teórie: ten istý postup vysvetľujete už tretíkrát. Nie úlohu, ale práve poradie krokov - pozri to, skontroluj toto, sformátuj takto, sem nelez. Opakuje sa to - tak dozrel čas.

A tu je dobrá správa. Písať SKILL.md od čistého listu nemusíte. Agent vie zostaviť návrh a od vás sa čaká len to, aby ste vysvetlili, o akú procedúru ide a čo od nej chcete. Vyzerá to ako bežný rozhovor:

Sprav skill na prípravu commitu. Má pozrieť, čo sa zmenilo,
skontrolovať, či sa do commitu nedostali zbytočné súbory, a napísať správu
podľa našej šablóny. Spúšťať ho budem ručne, keď sám budem chcieť.
Ak ti chýbajú požiadavky, najprv sa ma opýtaj.

Všimnite si, že ste nevymenovali ani jedno pole a do štruktúry súboru ste sa nepustili. Požiadavky sú povedané slovami, previesť ich do polí je práca agenta.

Ak agentovi chýbajú údaje, opýta sa. Bez takejto prosby môže rovno niečo predpokladať, preto je potrebný riadok už v príklade. Keď dostanete návrh, skontrolujte súbory, nájdite skill cez /skills a urobte skúšobné spustenie.

Ak sa dá procedúra prejsť ručne, urobte to s agentom ešte pred zabalením. Jeden commit krok za krokom ukáže, kde bolo treba zasiahnuť a čo vo vysvetlení chýbalo. Skill podľa živého prechodu je presnejší ako podľa spomienok.

Keď sa SKILL.md rozrastá

Prvý vlastný skill takmer vždy vyjde ako jeden súbor a je to v poriadku. Tesno začne byť neskôr: procedúra obrastá detailmi, presťahuje sa do nej tabuľka zhôd, zoznam pravidiel, tri dlhé príklady, a jedného dňa otvoríte súbor na štyri obrazovky.

Dávať všetko na jedno miesto netreba a dôvod už zaznel vyššie: telo sa načíta celé, len čo sa skill pustí do práce. Štyri obrazovky príručky sa načítajú aj vtedy, keď z nich treba jediný riadok.

Preto sa detaily presúvajú do susedných súborov a v SKILL.md zostane odkaz: ak nastane taká a taká situácia, otvor taký a taký súbor. Priečinok s palettes.md a scripts/ ste už videli, takto to vyzerá zvnútra:

## Príručky

- Palety a kombinácie farieb - v [palettes.md](palettes.md)
- Hotové príklady značkovania - v [examples.md](examples.md)
- Skontrolovať kontrast: spusti scripts/check.py

Príručku agent otvorí, keď ju potrebuje. Skript sa dá spustiť bez toho, aby sa celý jeho zdrojový kód automaticky načítal do konverzácie, takže veľkosť súboru kontext takmer nemíňa. Cudzí skript si však pred prvým spustením aj tak prečítajte: je to spustiteľný kód a jeho výstup sa dostane do práce agenta.

Rozdeľovať obsah sa oplatí podľa účelu:

• SKILL.md - samotná procedúra: čo robiť, v akom poradí, čo nerobiť. Pred volaním agent vidí jej popis, telo načíta pri spustení;
• príručky - tabuľky, pravidlá, dlhé príklady, všetko, čo netreba pri každom spustení;
• scripts/ - to, čo je jednoduchšie spustiť ako opísať slovami. V cudzom skille sa tieto súbory kontrolujú pred spustením;
• šablóny - súbory, ktoré skill vezme ako základ a upraví pre úlohu.

Z toho vyplýva aj opačný záver, tentoraz o cudzích skilloch. Krátky SKILL.md neznamená "jednoduchý skill". Pozrite sa, čo leží v priečinku vedľa neho.

Čo to zmení v práci

Ak to zhrnieme do pár riadkov:

• opakovaná požiadavka sa mení na priečinok. Raz opíšete postup práce - potom sa zopakuje rovnako, v ktorejkoľvek relácii a v ktorýkoľvek deň;
• vlastný skill nemusíte písať od čistého listu. Vysvetlíte procedúru slovami, poprosíte agenta, aby sa doptal na to, čo chýba, a skontrolujete zostavený návrh;
• pri automatickom spustení sa skill vyberá podľa description, pri ručnom - podľa názvu s lomkou. Ak mlčí, najprv zistite, či ho vidno v zozname a či je automatické spúšťanie povolené;
• /skills odpovedá na otázku "načítal sa vôbec". Pol minúty kontroly ušetrí pol hodiny hádania;
• cudzí skill sa číta pred inštaláciou a spustením, spolu so súvisiacimi súbormi a skriptami;
• skill mení to, ako agent robí prácu, ale neizoluje oblasť úprav a nenahrádza kontrolu výsledku.