Claude Code Skills leta 2026: kako zgraditi knjižnico skills zase
MarkdownKako ustvariti Claude Code Skills: struktura SKILL.md, formula za opis, 5 pripravljenih zbirk Anthropic in Matta Pococka ter antipatterni. Korak za korakom v 30 minutah.
Preberi celoten članek
Ključne točke
Claude Code Skills so mape z datoteko SKILL.md, ki jo Claude naloži v kontekst samo, kadar jo potrebuje. CLAUDE.md je ves čas v pomnilniku in porablja proračun tokenov, skill pa se naloži ob sprožilcu — v enem projektu lahko brez težav sobivajo desetine skills. Najpomembnejši del skilla je njegov opis: Claude na njegovi podlagi odloči, ali naj skill aktivira. V tem članku razložim strukturo SKILL.md, formulo za opis, pripravljene zbirke in kako v 30 minutah ustvariti svoj prvi skill.
Dokumentacija Ailoot: API, ključi in nastavitev.
Kaj je Skill v Claude Code in zakaj ni zgolj »večji poziv«?
Ključne točke
Skill je imenik z datoteko SKILL.md, ki opisuje, kdaj in kako uporabiti določeno metodologijo. Anthropic primerja skill z navodili za novega zaposlenega: vsak dan mu ne narekujete vsakega koraka; podate mu postopek, ki ga sam uporabi v ustreznih situacijah. Glavna razlika od CLAUDE.md je v tem, da se skill naloži v kontekst samo po potrebi, zato lahko v projektu obstaja več deset skills brez prekoračitve proračuna tokenov.
Claude Code Skills so izvorna funkcija Claude Code, ki jo je Anthropic oktobra 2025 uvedel za Pro/Max/Team/Enterprise. Pozneje je odprl specifikacijo Agent Skills kot standard, ki deluje tudi zunaj Clauda. V kodi je to zgolj mapa:
.claude/skills/
├── deploy-to-prod/
│ ├── SKILL.md
│ └── scripts/
│ └── check-migrations.sh
├── weekly-content-plan/
│ └── SKILL.md
└── triage-support-tickets/
└── SKILL.md
Vsaka mapa predstavlja en skill. Datoteka SKILL.md je Markdown z YAML-frontmatter na vrhu in običajnimi navodili spodaj. Ko uporabnik reče »dajmo namestiti v produkcijo«, Claude vidi opis skilla deploy-to-prod, prepozna sprožilec »namestiti v produkcijo«, naloži telo SKILL.md v kontekst in sledi korakom.
Tri ravni postopnega nalaganja
Anthropic je zasnoval skills s postopnim nalaganjem: podatki se nalagajo po plasteh, ko so potrebni. V blogu Anthropic Engineering ekipa to opiše kot »osrednje načelo zasnove, zaradi katerega so Agent Skills prilagodljivi in razširljivi« (Anthropic Engineering).
Tri ravni nalaganja:
- Metapodatki (vedno) - ob začetku seje Claude vidi samo
nameindescriptionvsakega skilla. Proračun: približno 100 tokenov na skill. - Navodila (ob sprožilcu) - ko uporabnik reče kaj ustreznega, Claude naloži telo SKILL.md. Proračun: manj kot 5000 tokenov.
- Viri (na zahtevo) - priložene datoteke (primeri, predloge, nabori podatkov) se pridobijo samo, ko jih model sam poišče. Proračun: neomejen.
Prej je morala CLAUDE.md vsebovati vse, kar naj bi si AI »zapomnil« — projekt s 50 pravili pa je hitro dosegel omejitev konteksta. S skills lahko v projektu brez težav sobivajo desetine, saj so v začetnem kontekstu samo njihovi opisi.
Kje so skills: štiri ravni
| Raven | Pot | Velja za |
|---|---|---|
| Enterprise | Upravljane nastavitve organizacije | Vse zaposlene v podjetju |
| Osebna | ~/.claude/skills/<name>/SKILL.md | Vse vaše projekte |
| Projektna | .claude/skills/<name>/SKILL.md | Samo ta projekt |
| Plugin | <plugin>/skills/<name>/SKILL.md | Kjer je plugin omogočen |
Prednostni vrstni red: enterprise preglasi osebno, osebna preglasi projektno. Plugini uporabljajo imenski prostor plugin-name:skill-name in se ne spopadajo. To je priročno: splošne poklicne skills postavite v ~/.claude/skills/, projektno specifične pa v .claude/skills/ v repozitoriju.
Kaj vsebuje SKILL.md?
Ključne točke
SKILL.md je datoteka Markdown z YAML-frontmatter na vrhu in besedilom navodil spodaj. Vsebuje vsaj dve polji: name (do 64 znakov) in description (do 1024 znakov). Celotna shema vključuje allowed-tools, disable-model-invocation, paths, context: fork, agent in hooks. Anthropic priporoča, da telo navodil ostane znotraj 500 vrstic, vse drugo pa shranite v bližnje referenčne datoteke.
Tukaj je minimalen primer — dvajset vrstic in skill je pripravljen:
---
name: weekly-content-plan
description: Prepares a weekly post plan for a Telegram channel and short-form videos. Triggers - "make a post plan", "what should I post this week", "a 7-day channel plan". Do not activate if the request is about a website or email newsletter.
---
# Weekly Content Plan
## Steps
1. Read `knowledge/audience.md` - who we're writing for
2. Read `knowledge/tone-of-voice.md` - how we write
3. Read the last 10 posts in the channel - what has already been covered
4. Come up with 7 topics for the week: 3 sales-focused, 2 expert, 2 personal
5. For each, provide one hook line and three bullets about the post
6. Output as a table: day of the week | type | hook | plan
To je dovolj. Če uporabnik napiše »načrtujmo objave za ta teden«, Claude v opisu prepozna sprožilec, naloži SKILL.md, prebere navedene datoteke in pripravi tabelo.
Omejitve, ki jih je treba upoštevati
Uradna dokumentacija Claude API določa stroge omejitve:
name: do 64 znakov, samo male črke, številke in vezaji, brez oznak XML.anthropicinclaudesta rezervirana.description: do 1024 znakov v API-ju; obvezno, brez oznak XML.- Proračun seznama: v Claude Code opisi vseh skills skupaj zavzamejo približno 1% kontekstnega okna. Če je skills veliko, bodo opisi skrajšani — ključne besede, ki jih Claude potrebuje za ujemanje, pa lahko izginejo.
- Telo SKILL.md: Anthropic priporoča, naj telo ostane znotraj 500 vrstic. Vse daljše premaknite v datoteke v
references/,scripts/inexamples/ter jih naložite prek navodil.
Po strnitvi konteksta (/compact) Claude ohrani prvih 5000 tokenov vsakega prej uporabljenega skilla; skupni proračun za vse znova pripete skills je 25 000 tokenov. Če skill ne gre v proračun, je njegovo vedenje »pozabljeno«.
Celotna shema frontmatter
Uporabite vsaj name in description. Produkcijski skills uporabljajo tudi druga polja:
| Polje | Namen | Primer |
|---|---|---|
name | Ime skilla; če je izpuščeno, je privzeto ime mape | deploy-to-prod |
description | Sprožilec za samodejni priklic | Glejte formulo spodaj |
when_to_use | Dodatne sprožilne fraze | ["deploy", "let's ship it"] |
allowed-tools | Orodja, ki jih je mogoče uporabiti brez prošnje za dovoljenje | ["Read", "Bash(npm run build)"] |
disable-model-invocation | true - prikliče ga lahko samo uporabnik | Za nevarna opravila |
user-invocable | false - prikliče ga lahko samo Claude | Za osnovno znanje |
paths | Vzorci glob, ki določajo, kje je skill aktiven | ["src/**/*.ts"] |
context: fork | Zaženi v izoliranem podagentu | Ko je kontekst obsežen |
agent | Vrsta podagenta za zagon | Explore, Plan, general-purpose |
effort | Raven sklepanja | low, medium, high, xhigh, max |
model | Kateri model dodeliti skillu | claude-opus-4-7 |
hooks | Hooki v življenjskem ciklu skilla | Glejte razdelek o hookih |
Polje disable-model-invocation: true je nujno za vse, kar se ne sme zagnati samodejno. Na primer, skill deploy-to-prod s to zastavico je mogoče priklicati samo, če uporabnik izrecno vpiše /deploy-to-prod. Brez te zastavice bi Claude lahko izvedel namestitev, ker »je koda videti pripravljena«.
Zakaj opis predstavlja 90% dela in kako ga napisati?
Ključne točke
Opis je edino polje, ki ga Claude vidi na začetku seje. Če je slabo napisan, skill ne bo deloval, tudi če je telo navodil popolno. Dober opis ima tri dele: kaj počne + sprožilne fraze v narekovajih + kdaj ga NE uporabiti. Anthropic v svojem skill-creator priporoča, naj bodo opisi »nekoliko vsiljivi« — Claude pogosto premalo aktivira skills.
Najpogostejša napaka vibe-coderjev je opis, kot je »Pomočnik za X«. Skill fizično obstaja v svoji mapi, vendar ga Claude ne prikliče.
Slab opis
description: Build dashboards.
Česa Claude ne more razbrati: ko uporabnik prosi »pokaži mi prodajo za ta teden«, gre za nadzorno ploščo ali ne? Ko uporabnik prosi za »graf prihodkov«, gre za nadzorno ploščo ali samo za graf na splošno? Ko prosi za »mesečno poročilo«, to zagotovo ni nadzorna plošča?
Anthropicov lastni skill-creator priporočilo navaja neposredno:
Claude trenutno kaže težnjo k »premalo pogostemu sprožanju« skills — ne uporabi jih v situacijah, kjer bi bile koristne. To preprečite tako, da opise skills napišete nekoliko »vsiljivo«.
Formula za dober opis
Trije deli:
- Kaj počne - en stavek o rezultatu, ne o postopku. Ne »ustvari SQL«, temveč »izvozi prodajo v tabelo za kanal Telegram«.
- Kdaj ga sprožiti - 3-5 fraz v narekovajih, ki jih uporabniki dejansko izgovorijo. Ne ugibajte; poglejte zgodovino klepetov in podpore.
- Kdaj ga NE sprožiti - 1-2 frazi o podobnih opravilih, na katera se skill ne bi smel odzvati. Brez tega dela si bosta dva podobna skills nenehno nasprotovala.
Primer dobrega opisa iz mojega projekta (poenostavljenega in anonimiziranega):
description: |
Writes and publishes an SEO guide to the blog, following the editorial policy.
Triggers: "write a guide about X", "let's make a new pillar",
"a blog article about Y", "build a blog guide about Z".
Do not activate if the request is about an email newsletter,
a Telegram post, or an internal team instruction—
those are other skills.
Zakaj to deluje:
- Glagol »piše in objavlja« namesto »pomaga pri« določa konkreten rezultat.
- Štiri sprožilne fraze v narekovajih pokrivajo različne formulacije.
- Vključen je tudi angleški sprožilec — če uporabnik preklopi na jezik ekipe, bo skill še vedno deloval.
- Ločen razdelek »ne aktiviraj, če« preprečuje konflikte s skills za e-pošto in objave.
Kako preizkusiti opis
V skill-creator je Anthropic vključil metodologijo preverjanja sprožilcev: 20 pozivov za preverjanje, ali se skill aktivira. Deset se jih mora sprožiti, deset pa ne (vključno s skoraj ujemajočimi se primeri, kjer je formulacija podobna, opravilo pa drugačno).
V izrazih vibe-coderjev to pomeni: po pisanju opisa odprite prazen klepet in poskusite 5 fraz, ki jih res uporabljate, ter 3 podobne fraze, ki pomenijo nekaj drugega. Če se skill ne aktivira, ko bi se moral, ali se aktivira, ko se ne bi smel, popravite opis. Šele nato napišite telo navodil.
Katerih 5 skills bi najprej namestil?
Ključne točke
Najhitrejša strategija za podjetnika je, da začne s pripravljenimi zbirkami in jih prilagodi. Anthropic in Vercel sta objavila javne zbirke, ki jih je mogoče namestiti z enim ukazom in pokrivajo običajna opravila, kot sta priprava dokumentov in oblikovanje. Maja 2026 ima uradni repozitorij anthropics/skills približno 138 000 zvezdic.
Prva dva tedna porabiti za pisanje lastnih skills je slaba strategija. Začnite z namestitvijo pripravljenih zbirk in poglejte, kako so narejene; nato dodajte svoje po enakem pristopu. Ceneje je vzeti preverjene zbirke drugih in jih prilagoditi sebi kot vse graditi od začetka. Tukaj je pet zbirk, s katerimi bi začel:
1. anthropics/skills - uradna zbirka s skill-creator
Repozitorij: github.com/anthropics/skills. 138 000 zvezdic na GitHubu. Vsebuje uradne skills ekipe Anthropic: skill-creator (metaskill, ki piše druge skills), claude-api (pomaga graditi integracije API) in pripravljene dokumentne skills za PowerPoint, Excel, Word in PDF.
Namestite s Claude Code:
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills
Največja vrednost je skill-creator. Na podlagi vašega opisa napiše SKILL.md, nato izvede 20 preverjanj sprožilcev in popravlja opis, dokler se skill ne začne aktivirati, kjer je treba. V bistvu je to »skill za ustvarjanje skills«.
2. mattpocock/skills - viralna zbirka strokovnjaka za TypeScript
Vsebuje 12 aktivnih skills, med njimi:
grill-me- postavlja vprašanja po odločitvenem drevesu, dokler niso razjasnjene negotovosti pri opravilu. Glavno težavo vibe-coderjev — »Ne vem, kaj hočem« — obravnava že v prvem krogu.caveman- komunikacijo modela skrajša v telegrafski slog.diagnose- razhroščevanje po ciklu ponovi - poenostavi - postavi hipotezo - instrumentiraj - popravi - preveri regresijo.tdd- uveljavlja red-green-refactor: najprej neuspešen test, nato minimalni popravek in nazadnje refaktoriranje.to-issues- načrt pretvori v navpično razčlenjene GitHub issues (celoten sklad, vsako je mogoče namestiti neodvisno).
Namestitev:
npx skills@latest add mattpocock/skills
/setup-matt-pocock-skills
3. coreyhaines31/marketingskills - zbirka za tržnike
Če izvajate spletne programe, delate kot samostojni tržnik ali vodite agencijo, vam ni treba porabiti šestih mesecev za pisanje lastnih skills. Polovica opravil je že zapakirana.
4. vercel-labs/agent-skills - oblikovanje brez videza AI
Repozitorij: github.com/vercel-labs/agent-skills. UI-kodo preverja glede na več kot 100 pravil za dostopnost, zmogljivost in uporabnost.
Zraven je Anthropic frontend-design z več kot 110 000 tedenskimi namestitvami. AI prisili, da izbere slog, preden začne pisati kodo. Brez njega ima vsaka stran, ki jo ustvari Claude, pisavo Inter, vijoličen preliv in kartice v mreži. Rezultat je za vse enak.
5. obra/superpowers - večagentski potek dela
Če namestite prve tri zbirke s seznama — anthropics/skills, mattpocock/skills in coreyhaines31/marketingskills — bo imel vaš Claude Code na voljo več deset pripravljenih skills, ki v prvem mesecu pokrijejo večino podjetnikovih opravil.
Želite poleg nameščanja pripravljenih skills zgraditi tudi nastavitev, s katero bo Claude zares vaš pomočnik? Skills so eden od treh stebrov metodologije. Delujoča nastavitev ima tri dele: AI-klon (Skills kot zapakirano strokovno znanje) + Second Brain (struktura znanja za kontekst) + Context Engineering (kako Claude vidi projekt kot celoto). Ta nastavitev spremeni Clauda iz pomočnika, ki ugiba, v orodje, ki razmišlja po vaši logiki.
Katere ponavljajoče se naloge bi morali pretvoriti v skill?
Ključne točke
Pravilo je preprosto: vsako opravilo, ki ga izvajate več kot dvakrat na teden in poteka po približno enakih korakih, je kandidat za skill. Ne gre za zahtevno »letno poročilo za revizorja«, temveč rutinsko delo: načrt vsebine za kanal, preverjanje prejemkov strank, pozdravno e-poštno sporočilo za novega udeleženca. Skill enkratno delo spremeni v sredstvo, ki deluje brez vas.
Pri delu za stranke in v projektih drugih sem ta vzorec videl že več desetkrat. Nekdo ima »tisto opravilo, ki ga vsakič začne iz nič«. Vsak ponedeljek napiše isto vrsto poročila. Vsakič, ko pridobi novo stranko, gre skozi isti postopek. Vsaka objava sledi isti predlogi. In vsakič to traja 30-90 minut, ker si mora priklicati korake, odpreti prave datoteke in znova oblikovati poziv za Clauda.
Rešitev je, da opravilo enkrat zapakirate v skill. Nato izrečete eno frazo, Claude pa naloži metodologijo, prebere potrebne vire in pripravi rezultat. Trije primeri z različnih področij:
Primer 1. Samostojni tržnik - skill weekly-content-plan
Kaj naredi ročno: vsak ponedeljek pripravi tedensko zalogo objav Telegram za tri stranke. Odpre strankin vodnik za glas blagovne znamke, pregleda nedavne objave, si zamisli teme na podlagi koledarja izdelkov in sestavi tabelo z uvodnimi stavki in alinejami.
Kot skill to postane petstopenjsko navodilo: preberi strankino datoteko tona komunikacije, preberi koledar izdelkov, preveri zadnjih 10 objav glede ponavljanja, sestavi sedem tem po vrsti (prodajno usmerjene, strokovne, osebne) in izpiši tabelo.
Ukaz »načrtujmo objave za stranko X za ta teden« uro priprave spremeni v tri minute čakanja. Tržnik preveri rezultat, izvede ciljno usmerjene popravke in ga pošlje stranki.
Primer 2. Zunanji računovodja - skill monthly-receipts-close (avtorjev primer)
Kaj naredi ročno: za vsako stranko v portfelju vsak mesec izvozi bančni izpisek, ga uskladi s plačili v računovodskem sistemu, označi nerazvrščena plačila, pripravi predhodno poročilo o prihodkih in primerja strukturo prihodkov s prejšnjim mesecem.
Skill je šeststopenjsko navodilo in nekaj lupinskih skriptov v mapi scripts/ za razčlenjevanje bančnih izpiskov. Sprožilec »zaključi maj za stranko X« pozove Clauda, naj v 4-5 minutah pripravi poročilo z označenimi anomalijami.
Primer 3. Ustvarjalec spletnega programa - skill welcome-letter-new-participant
Kaj naredi ročno: nov udeleženec je plačal, zato mu je treba napisati pozdravno e-pošto. Dober pozdrav je oseben: upošteva kanal, prek katerega je prišel, kateri izdelek je kupil, v kateri skupini je in katera gradiva mu je treba poslati. Predloga »živjo, veseli smo se« tega ne naredi.
Skill naroči Claudu, naj prebere knowledge/audience.md (kdo so ti ljudje), knowledge/products/<product>.md (kaj dobijo) in zadnja tri pozdravna e-poštna sporočila (da prepreči ponavljanje), nato pa napiše e-pošto po tej strukturi: uvodni stavek - podrobnosti o izdelku - prvi trije koraki - zaključek.
Velikokrat hitreje kot ročno. Kakovost je bolj dosledna, ker se Claude spomni preveriti tri vire, medtem ko človek v naglici enega izpusti.
Česa NE pretvarjati v skill
- Enkratna opravila. Če nekaj naredite enkrat letno ob oddaji davčne napovedi, to preprosto opišite Claudu v klepetu. Skill se izplača po 3+ ponovitvah.
- Preveč splošna opravila. »Pomagaj mi pri trženju« ni skill; to je celotno trženje. Skill je »tedenski načrt vsebine« — konkretno opravilo s konkretnim rezultatom.
- Opravila brez ponovljivih korakov. Če je postopek vsakič drugačen, to ni skill, ampak enkratno delo.
Kako Skill Creator napiše skills za vas?
Ključne točke
Skill Creator je metaskill Anthropic, predstavljen z ukazom /skill-creator. Vodi vas skozi šest korakov: osnutek, preizkus, vrednotenje, ponavljanje, optimizacija in pakiranje. Rezultat je pripravljen SKILL.md, preverjen z 20 testi sprožilcev (10 se jih mora sprožiti, 10 pa ne). Za nekoga, ki ne programira, je to najhitrejši način za izdelavo prvega delujočega skilla — brez učenja YAML ali prerekanja s Claudom.
Težava je v tem, da je težko že prvič napisati dober skill. Opis je pogosto preozek ali preširok, spregleda fraze, ki jih uporabniki dejansko uporabljajo, ali je v konfliktu s sosednjim skillom. Anthropic je to naslovil z izdajo skill-creator, metaskilla, ki lahko ustvarja druge skills.
Ko namestite anthropics/skills, Claudu povejte /skill-creator (ali preprosto »ustvariva skill za tedensko poročilo«) in sledite šeststopenjskemu poteku dela:
- Osnutek - skill-creator postavlja vprašanja: kaj naj skill naredi, katere sprožilne fraze naj uporabi, katere vire naj prebere in katerim korakom naj sledi. Rezultat je prva različica SKILL.md.
- Preizkus - skill-creator ustvari 20 testnih pozivov: 10 takih, ki bi morali sprožiti skill, in 10 takih, ki so videti kot sprožilci, a ga ne bi smeli (skorajšnji zadetki).
- Vrednotenje - vsak poziv zažene v svežem klepetu in preveri, ali se je skill aktiviral. Če se aktivira, ko se ne bi smel, ali se ne aktivira, ko bi se moral, označi rezultat.
- Ponavljanje - na podlagi napak prepiše opis in znova izvede teste.
- Optimizacija - končno glajenje: preveri, ali je presežena omejitev 1024 znakov in ali prihaja do konfliktov z obstoječimi projektnimi skills.
- Pakiranje - končni SKILL.md in referenčne datoteke zapakira v pravilno strukturo.
V praksi je videti tako: s Claudom se pogovarjate 15-20 minut, odgovorite na 7-8 pojasnjevalnih vprašanj in na koncu dobite pripravljen, preizkušen skill, ki se aktivira ob pravih sprožilcih.
Druga prednost je, da skill-creator prikazuje zgleden slog pisanja SKILL.md. Odprete lahko njegovo datoteko in si ogledate obliko, ton in strukturo korakov. To je primer, ko orodje pokaže samega sebe — preberete ga in se naučite ustvariti svojega.
Skills, CLAUDE.md, podagenti, MCP in hooks: kaj uporabiti?
Ključne točke
Claude Code ima pet različnih osnovnih gradnikov za razširjanje vedenja in niso zamenljivi. CLAUDE.md vsebuje trajno znanje o projektu. Skills so ponovljivi poteki dela, ki jih sprožijo sprožilci. Podagenti izvajajo delo vzporedno v ločenem kontekstu. MCP povezuje zunanje sisteme (API-je, podatkovne zbirke). Hooks se samodejno odzivajo na dogodke. Najpogostejša napaka vibe-coderjev je, da vse natlačijo v CLAUDE.md ali poskušajo narediti skill s hookom.
Najpogostejša težava v projektih, ki sem jih pregledal, je, da CLAUDE.md vsebuje projektna pravila, navodila za objavo po korakih, predlogo za commit in opis podatkovne zbirke — vse skupaj. To preobremeni kontekst in v praksi tudi ne deluje: Claude ne izvede navodila »ko uporabnik prosi za objavo«, ker model celotno CLAUDE.md obravnava kot splošen kontekst brez izrecnih sprožilcev.
Rešitev je, da vsak element dodelite pravemu gradniku:
| Kaj | Kdaj uporabiti | Primer |
|---|---|---|
| CLAUDE.md | Znanje, ki je potrebno VEDNO | »Projekt uporablja določen jezik«, »v besedilu ni dolgih pomišljajev«, »ime znamke se piše z ‘o’« |
| Skills | Ponovljiv postopek, ki ga sproži določena fraza | »Objavi v produkcijo«, »tedenski načrt objav«, »zaključi strankine knjige za ta mesec« |
| Podagenti | Vzporedno delo ali osamitev obsežnega konteksta | »Varnostni pregled, medtem ko načrtujem novo funkcijo«, »preglej kodno zbirko v ločeni seji« |
| MCP | Povezovanje z zunanjim sistemom | »Pridobi podatke iz CRM«, »pridobi opravila iz sledilnika«, »preveri spletno mesto v brskalniku« |
| Hooks | Samodejni odziv na dogodek | »Zaženi preverjanje po Edit«, »blokiraj nevarne ukaze«, »pošlji obvestilo Telegram, ko končaš« |
Vse se skrči na preprosto logiko: Skills in MCP pokrivajo večino potekov dela; Hooks avtomatizirajo rutinska opravila — preverjanja kode, teste in varovalke. Podagenti so potrebni, kadar kontekst postane obsežen. Najpogostejša napaka je ustvariti podagenta, kadar bi morali uporabiti skill.
Odločitveno drevo
Ko pomislite: »Potrebujem, da Claude naredi X«:
- Ali je to znanje potrebno ves čas? Na primer: »Projekt uporablja določen jezik« ali »ne uporabljamo dolgih pomišljajev«. → Zapišite ga v
CLAUDE.md. - Je to postopek, ki se sproži ob določeni zahtevi in ga trenutno izvajate ročno? Na primer: »Vsak ponedeljek napišem poročilo.« → Ustvarite skill.
- Potrebujete dostop do zunanjega sistema? Na primer Stripe API ali vaš CRM. → Povežite strežnik MCP.
- Se mora Claude Code samodejno odzvati na dogodek? Na primer zagnati linter po vsakem Edit. → Napišite hook.
- Je opravilo obsežno, bo porabilo ves kontekst in morate vzporedno narediti še kaj? → Zaženite ga v podagentu.
90% opravil podjetnika-vibe-coderja spada v kategorije 1-3. Hooks in podagenti so orodja naslednje ravni, ko presežete pristop »eno opravilo naenkrat«.
Ukazi s poševnico in skills so ista stvar
Pomembna sprememba v Claude Code: stari sistem ukazov s poševnico (.claude/commands/) in skills sta se dejansko združila. Datoteka .claude/commands/deploy.md in .claude/skills/deploy/SKILL.md ustvarita ukaz /deploy. Če se imeni ujemata, ima prednost skill. Če še vedno uporabljate staro obliko ukazov s poševnico, preidite na skills; sintaksa je jasnejša in ponujajo več zmogljivosti.
7 napak, zaradi katerih skill ne deluje
Ključne točke
Najpogostejše težave s skills niso hrošči v Claudu, temveč napake v samem skillu. Opis brez sprožilcev, preobremenjen SKILL.md z 2,000 vrsticami, dva podobna skills v konfliktu ali poskus prenosa »vsega s tržnice«. Vsaka od teh napak prepreči aktivacijo skilla ali pokvari njegovo delovanje.
1. Opis brez sprožilcev: skill se ne aktivira
Simptom: napisali ste skill, preverili strukturo in vse je veljavno, vendar ga Claude ne prikliče pri uporabnikovih zahtevah. Vzrok je skoraj vedno isti: opis, kot je »Pomočnik za pisanje vsebine«. Claude ne ve, na katere fraze naj se odzove. Rešitev: v opis neposredno dodajte 3-5 dejanskih uporabniških fraz v narekovajih.
2. SKILL.md z več kot 500 vrsticami: pozornost začne uhajati
Anthropic izrecno priporoča, naj telo datoteke ostane znotraj 500 vrstic. Če imajo navodila 2,000 vrstic, Claude izgubi osredotočenost, upošteva le del korakov in se zmede glede vrstnega reda. Rešitev: velike razdelke premaknite v bližnje datoteke — examples/, references/, scripts/ — in se nanje sklicujte iz SKILL.md.
3. En skill za »vse o vsebini« namesto treh manjših
Mamljiva nastavitev: en velik skill content z objavami Telegram, pristajalnimi stranmi in e-pošto. Ne deluje. Skill se aktivira pri napačnih zahtevah, pomeša metodologije in ustvari povprečen rezultat. Rešitev: en skill = eno ponovljivo opravilo. Če imate dejansko tri rutine za »vsebino«, ustvarite tri skills: telegram-post, landing-section, email-broadcast.
4. Skill brez razdelka »Kdaj ga NE uporabiti«: konflikti
Simptom: v projektu sta dva podobna skills, Claude pa prikliče napačnega. Na primer, eden se nanaša na e-novice, drugi pa posebej na pozdravna e-poštna sporočila za udeležence programa. Brez izrecne klavzule »ne aktiviraj, če se zahteva nanaša na splošen poštni seznam« se bo skill za pozdravno e-pošto sprožil ob vsaki omembi »e-pošte«. Rešitev: v opisu izrecno navedite negativne primere.
5. 50 skills v projektu: opisi se skrajšajo
Imena skills so vedno vključena, če pa je skills veliko, so njihovi opisi skrajšani, da ostanejo znotraj omejitve znakov. Pri tem lahko izginejo ključne besede, ki jih Claude uporablja za ujemanje z vašo zahtevo. Proračun - 1% kontekstnega okna modela.
Če ste s tržnice prenesli 50 zbirk skills, bodo nekateri opisi skrajšani. Ključne besede, na katere ste računali, lahko izginejo. Rešitev: v aktivnem projektu obdržite 10-15 najbolj uporabnih skills. Preostale hranite v neaktivnem arhivu zunaj vseh imenikov, v katerih se odkrivajo skills, na primer v ločeni mapi skill-archive/ med svojim gradivom. V projektni ali osebni obseg namestite samo potrebne skills. ~/.claude/skills/ je nameščena osebna knjižnica, vidna v vseh projektih, zato premik tja skills ne odstrani iz odkrivanja.
6. Skills iz nepreverjenih virov: varnostno tveganje
Anthropic na to opozarja v uradni dokumentaciji:
Uporabljajte samo skills iz zaupanja vrednih virov: tiste, ki ste jih ustvarili sami ali prejeli od Anthropica. Zlonameren skill lahko povzroči, da Claude prikliče orodja ali izvede kodo na načine, ki se razlikujejo od navedenega namena skilla.
Naključen repo na GitHubu lahko vsebuje skill, ki ob prvem priklicu razkrije vaše ključe API. Rešitev: pred namestitvijo sami odprite in preberite SKILL.md. V pomembnih projektih ne zaganjajte skills neznanih avtorjev.
7. Skill brez mape znanja ustvari »povprečen ChatGPT«
Najbolj prikrit in najpogostejši antipattern. Skill je metodologija, vendar metodologija brez konteksta ne pomeni nič. Če napišete skill za »pripravo pozdravne e-pošte«, projekt pa nima datoteke z opisom občinstva in datoteke o glasu blagovne znamke, bo Claude napisal povprečno e-pošto, značilno za ChatGPT, ki je ni mogoče razlikovati od e-pošte kogar koli drugega.
Skill najbolje deluje šele, ko ste že zgradili projektni Second Brain po načelih iz vodnika o CLAUDE.md. Najprej zgradite strukturo znanja, nato ustvarite skills, ki se nanjo opirajo. Če vrstni red obrnete, boste namesto osebnega dela v svojem slogu dobili rutinsko delo povprečne kakovosti.
Kako v 30 minutah zgraditi svoj prvi skill
Ključne točke
Postopen recept za izdelavo prvega delujočega skilla: izberite eno ponovljivo opravilo, zapišite korake, ustvarite strukturo map, napišite opis po formuli, preizkusite ga s 5-8 pozivi in ponavljajte, dokler se ne aktivira, kjer je treba. Realen čas za prvi skill je 30-40 minut. Vsak naslednji traja 10-15 minut, ker format že poznate.
Tukaj je konkreten načrt, ki sem ga uporabil za izdelavo prvih skills v svojih projektih:
Korak 1. Izberite eno ponovljivo opravilo
Odprite koledar za pretekli mesec. Poiščite opravilo, ki ste ga izvedli vsaj 4-5-krat in vam vsakič vzame 30-60 minut. Ne širokega področja, kot je »trženje«, temveč nekaj specifičnega: »ponedeljkovo prodajno poročilo«, »uvajanje nove stranke« ali »posodobitev cenika za promocijo«.
Ožja kot je formulacija, preprostejši bo skill in čistejši sprožilec.
Korak 2. Postopek zapišite ročno
V ločeno datoteko ali klepet s Claudom (ne za skill, temveč za osnutek) zapišite korake, ki jih upoštevate:
1. Open the client database
2. Filter by status "awaiting welcome email"
3. Check which channel the client came from
4. Get the email template for that channel from the "templates" folder
5. Fill in the name, product, and start date
6. Send
To še ni skill, ampak zapiski. Brez njih pa boste pri pisanju SKILL.md že od začetka zmedeni.
Korak 3. Ustvarite strukturo map
mkdir -p .claude/skills/welcome-email-new-client
touch .claude/skills/welcome-email-new-client/SKILL.md
Če želite skill uporabljati v vseh projektih, ga shranite v ~/.claude/skills/.
Korak 4. Napišite SKILL.md po predlogi
Osnutek:
---
name: welcome-email-new-client
description: |
Prepares a welcome email for a new client using the template for their acquisition channel.
Triggers: "write a welcome email for new client X",
"onboard new participant Y", "welcome email for client from channel Z".
Do not activate if the request is about a general mailing list
or an email campaign—those are other skills.
---
# Welcome Email for a New Client
## Steps
1. Read `knowledge/audience/segments.md` - what client segments we have
2. Read `knowledge/templates/welcome/` - templates by channel
3. Identify the client's channel from the request context
4. Insert the client's name, product name, and start date
5. Check the length—it should be no more than 800 characters
6. Output the final email text in a copy-ready format
## Important
- Do not use “dear friend” or “hello”—use natural speech
- One paragraph, one idea
- End with one call to action, not two
Korak 5. Preizkusite s 5-8 pozivi
Odprite prazen klepet s Claude Code v tem projektu. Preizkusite 5 fraz, ki jih dejansko uporabljate, in 3 podobne, ki ne bi smele aktivirati skilla:
Sprožiti bi se moral:
- »Napiši pozdravno e-pošto za novega naročnika Ivanova«
- »Uvedi novega udeleženca, ki je kupil program X«
- »Pozdravno e-poštno sporočilo za stranko z Instagrama«
Ne bi se smel sprožiti:
- »Pošlji promocijsko e-pošto celotnemu seznamu«
- »E-poštna kampanja za novoletne praznike«
- »Napiši nadaljnje sporočilo stranki, ki ni plačala«
Pri vsakem preverite, ali se je skill aktiviral. Če se aktivira v napačnih primerih, zožite opis. Če se ne aktivira, ko bi se moral, razširite sprožilne fraze.
Korak 6. Ponavljajte z opisom
Po vsakem neuspešnem preizkusu uredite samo opis — telesa navodil se ne dotikajte. Po 2-3 ponovitvah se skill začne zanesljivo aktivirati. Shranite ga, naredite commit in ga nato uporabljajte vsak dan.
Zadnji nasvet: prvega skilla ne poskušajte izpiliti do popolnosti. Najprej naj deluje. Do glajenja pride po petem ali desetem skillu, ko začnete opažati vzorce v svojih formulacijah in Claudovih odgovorih.
Izberite eno ponavljajoče se opravilo iz koledarja za ta teden, rezervirajte 30 minut in sledite šestim zgornjim korakom. Potem bo Claude deloval po vaši metodologiji namesto ugibal.
Viri
- Razširite Clauda s skills - dokumentacija Claude Code
- Pregled Agent Skills - dokumentacija Claude Platform
- Opremljanje agentov za resnični svet z Agent Skills - blog Anthropic Engineering
- anthropics/skills - uradni repozitorij s skill-creator
- Skill Creator SKILL.md - vir metodologije trigger-evals
- vercel-labs/agent-skills - oblikovalske smernice
- Odprti standard Agent Skills - specifikacija
Delujoča nastavitev je AI-klon + Second Brain + Context Engineering. Trije deli ene metodologije.
Če potrebujete dostop do modelov AI prek Ailoot, si oglejte Ailoot.
Več podrobnosti
Vprašanja in odgovori: Claude Code Skills leta 2026: kako zgraditi knjižnico skills zase
Ali premik v ~/.claude/skills/ spretnost naredi neaktivno?
Ne. Ta imenik je nameščeni osebni obseg, zato je spretnost na voljo v vseh vaših projektih. Neuporabljene pakete hranite v arhivu zunaj vseh imenikov, v katerih se spretnosti odkrivajo, nato pa namestite le tiste, ki jih trenutno potrebujete.
Kako preverim, ali opis pravilno sproži spretnost?
Preizkusite pet povedi, ki bi morale sprožiti spretnost, in tri podobne zahteve, ki je ne bi smele. Uporabite sveže pogovore, zabeležite naloženo spretnost in prilagodite opis, kadar zgreši pravo zahtevo ali se sproži pri podobni, a neustrezni zahtevi.