Claude Code įgūdžiai 2026 m.: kaip susikurti įgūdžių biblioteką
MarkdownKaip kurti Claude Code įgūdžius: SKILL.md struktūra, aprašymo formulė, paruoštos Anthropic kolekcijos ir antikonstrukcijos. Žingsnis po žingsnio per 30 minučių.
Skaityti visą straipsnį
Svarbiausia
Claude Code įgūdžiai yra aplankai su failu SKILL.md, kurį Claude įkelia į kontekstą tik tada, kai jo reikia. CLAUDE.md nuolat lieka atmintyje ir naudoja žetonų biudžetą, o įgūdis įkeliamas suveikus aktyvikliui, todėl viename projekte gali lengvai veikti dešimtys įgūdžių. Svarbiausia įgūdžio dalis yra jo aprašymas: pagal jį Claude sprendžia, ar įgūdį aktyvinti. Šiame straipsnyje paaiškinu SKILL.md struktūrą, aprašymo formulę, paruoštas kolekcijas ir tai, kaip per 30 minučių susikurti pirmąjį įgūdį.
Ailoot dokumentacija: API, raktai ir sąranka.
Kas yra Claude Code įgūdis ir kodėl tai nėra tiesiog „didesnis raginimas“?
Svarbiausia
Įgūdis yra katalogas su failu SKILL.md, kuriame aprašoma, kada ir kaip taikyti konkrečią metodiką. Anthropic įgūdį lygina su instrukcijomis naujam darbuotojui: kasdien nenurodinėji kiekvieno žingsnio, o pateiki procedūrą, kurią darbuotojas pats pritaiko tinkamose situacijose. Pagrindinis skirtumas nuo CLAUDE.md tas, kad įgūdis įkeliamas į kontekstą tik tada, kai jo reikia, todėl projekte gali būti dešimtys įgūdžių neviršijant žetonų biudžeto.
Claude Code įgūdžiai yra vietinė Claude Code funkcija, kurią Anthropic pristatė 2025 m. spalį Pro/Max/Team/Enterprise naudotojams. Vėliau jie atvėrė Agent Skills specifikaciją kaip standartą, veikiantį ir už Claude ribų. Kode tai tiesiog aplankas:
.claude/skills/
├── deploy-to-prod/
│ ├── SKILL.md
│ └── scripts/
│ └── check-migrations.sh
├── weekly-content-plan/
│ └── SKILL.md
└── triage-support-tickets/
└── SKILL.md
Kiekvienas aplankas yra vienas įgūdis. Failas SKILL.md yra Markdown dokumentas: viršuje pateikiama YAML priekinė dalis, po ja – įprastos instrukcijos. Kai naudotojas paprašo „dabar diekime į gamybinę aplinką“, Claude pamato įgūdžio deploy-to-prod aprašymą, atpažįsta aktyviklį „diegti į gamybinę aplinką“, įkelia SKILL.md turinį į kontekstą ir vykdo nurodytus veiksmus.
Trys laipsniško įkėlimo lygiai
„Anthropic“ sukūrė įgūdžius su laipsnišku įkėlimu: duomenys įkeliami sluoksniais, kai jų prireikia. „Anthropic Engineering“ tinklaraštyje „Anthropic“ tai apibūdina kaip „pagrindinį projektavimo principą, dėl kurio Agent Skills yra lankstūs ir pritaikomi“ (Anthropic Engineering).
Trys įkėlimo lygiai:
- Metaduomenys (visada) – prasidėjus seansui Claude mato tik kiekvieno įgūdžio
nameirdescription. Biudžetas: apie 100 žetonų įgūdžiui. - Instrukcijos (suveikus aktyvikliui) – naudotojui pasakius ką nors susijusio, Claude įkelia SKILL.md turinį. Biudžetas: mažiau nei 5000 žetonų.
- Ištekliai (pareikalavus) – pridėti failai (pavyzdžiai, šablonai, duomenų rinkiniai) gaunami tik tada, kai jų ieško pats modelis. Biudžetas: neribotas.
Anksčiau CLAUDE.md turėjo būti viskas, ką AI turėtų „atsiminti“, o projektas su 50 taisyklių greitai pasiekdavo konteksto ribą. Naudojant įgūdžius, viename projekte gali lengvai veikti dešimtys įgūdžių, nes į pradinį kontekstą patenka tik jų aprašymai.
Kur laikomi įgūdžiai: keturi lygiai
| Lygis | Kelias | Taikoma |
|---|---|---|
| Įmonės | Valdomi organizacijos nustatymai | Visiems įmonės naudotojams |
| Asmeninis | ~/.claude/skills/<name>/SKILL.md | Visiems jūsų projektams |
| Projektas | .claude/skills/<name>/SKILL.md | Tik šiam projektui |
| Papildinys | <plugin>/skills/<name>/SKILL.md | Ten, kur įjungtas papildinys |
Pirmenybės tvarka: įmonės lygis turi pirmenybę prieš asmeninį, o asmeninis – prieš projekto lygį. Papildiniai naudoja vardų sritį plugin-name:skill-name ir nesukelia konfliktų. Tai patogu: bendruosius profesinius įgūdžius laikykite ~/.claude/skills/, o konkretaus projekto įgūdžius – saugyklos .claude/skills/ aplanke.
Kas yra SKILL.md faile?
Svarbiausia
SKILL.md yra Markdown failas, kurio viršuje yra YAML priekinė dalis, o apačioje – instrukcijų tekstas. Mažiausiai jame turi būti du laukai: name (iki 64 simbolių) ir description (iki 1024 simbolių). Visa schema taip pat apima allowed-tools, disable-model-invocation, paths, context: fork, agent ir hooks. Anthropic rekomenduoja instrukcijų turinį sutalpinti į 500 eilučių, o visa kita laikyti gretimuose nuorodų failuose.
Štai minimalus pavyzdys – dvidešimt eilučių, ir įgūdis paruoštas:
---
name: weekly-content-plan
description: Prepares a weekly post plan for a Telegram channel and short-form video platforms. 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
Tiek ir užtenka. Jei naudotojas parašo „suplanuokime savaitės įrašus“, Claude aprašyme pamato aktyviklį, įkelia SKILL.md, perskaito nurodytus failus ir pateikia lentelę.
Įsidėmėtini apribojimai
Oficialioje Claude API dokumentacijoje nustatyti griežti apribojimai:
name: iki 64 simbolių; leidžiamos tik mažosios raidės, skaičiai ir brūkšneliai, XML žymos negalimos.anthropicirclaudeyra rezervuoti.description: API leidžiama iki 1024 simbolių; laukas privalomas, XML žymos negalimos.- Įgūdžių sąrašo biudžetas: Claude Code visų įgūdžių aprašymai kartu užima apie 1 % konteksto lango. Jei įgūdžių daug, aprašymai bus sutrumpinti, todėl gali dingti raktažodžiai, kuriuos Claude turi atpažinti.
- SKILL.md turinys: Anthropic rekomenduoja neviršyti 500 eilučių. Ilgesnę medžiagą perkelkite į
references/,scripts/irexamples/failus, o instrukcijose nurodykite juos įkelti.
Po konteksto sutraukimo (/compact) Claude išsaugo pirmuosius 5000 kiekvieno anksčiau iškviesto įgūdžio žetonų; bendras visų vėl prijungiamų įgūdžių biudžetas yra 25 000 žetonų. Jei įgūdis netelpa, jo veikimas „pamirštamas“.
Visa priekinės dalies schema
Mažiausiai naudokite name ir description. Gamybiniai įgūdžiai taip pat naudoja kitus laukus:
| Laukas | Paskirtis | Pavyzdys |
|---|---|---|
name | Įgūdžio pavadinimas; jei nenurodytas, naudojamas aplanko pavadinimas | deploy-to-prod |
description | Automatinio iškvietimo aktyviklis | Žr. formulę toliau |
when_to_use | Papildomos aktyviklio frazės | ["deploy", "let's ship it"] |
allowed-tools | Įrankiai, kuriuos galima naudoti neprašant leidimo | ["Read", "Bash(npm run build)"] |
disable-model-invocation | true – iškviesti gali tik naudotojas | Pavojingoms operacijoms |
user-invocable | false – iškviesti gali tik Claude | Foninėms žinioms |
paths | Glob šablonai, nurodantys, kur įgūdis aktyvus | ["src/**/*.ts"] |
context: fork | Vykdyti izoliuotame subagente | Kai kontekstas didelis |
agent | Paleidžiamo subagento tipas | Explore, Plan, general-purpose |
effort | Mąstymo lygis | low, medium, high, xhigh, max |
model | Kurį modelį priskirti įgūdžiui | claude-opus-4-7 |
hooks | Įgūdžio gyvavimo ciklo kabliukai | Žr. kabliukų skyrių |
Laukas disable-model-invocation: true būtinas viskam, kas neturi būti paleidžiama automatiškai. Pavyzdžiui, įgūdis deploy-to-prod su šia vėliava gali būti iškviestas tik tada, kai naudotojas aiškiai įveda /deploy-to-prod. Be šios vėliavos Claude galėtų diegti, nes „kodas atrodo paruoštas“.
Kodėl aprašymas sudaro 90 % darbo ir kaip jį parašyti?
Svarbiausia
Aprašymas yra vienintelis laukas, kurį Claude mato seanso pradžioje. Jei jis parašytas prastai, įgūdis neveiks, net jei jo instrukcijų turinys tobulas. Gerą aprašymą sudaro trys dalys: ką jis daro + aktyviklio frazės kabutėse + kada jo NENAUDOTI. Savo įrankyje skill-creator Anthropic rekomenduoja aprašymus rašyti „šiek tiek įsakmiai“ – Claude linkęs per retai aktyvinti įgūdžius.
Dažniausia „vibe coder“ klaida – parašyti tokį aprašymą kaip „X pagalbininkas“. Įgūdis fiziškai yra aplanke, bet Claude jo neiškviečia.
Prastas aprašymas
description: Build dashboards.
Claude negali žinoti: ar naudotojui paprašius „parodyk savaitės pardavimus“ tai susiję su valdymo skydeliu? Ar paprašius „pajamų diagramos“ turima omenyje valdymo skydelis, ar tiesiog bendra diagrama? Ar paprašius „mėnesinės ataskaitos“ tikrai neturimas omenyje valdymo skydelis?
Anthropic savo skill-creator rekomendaciją pateikia tiesiogiai:
Šiuo metu Claude linkęs „per retai aktyvinti“ įgūdžius – nenaudoti jų tais atvejais, kai jie būtų naudingi. Kad tai kompensuotumėte, aprašymus formuluokite šiek tiek „įsakmiai“.
Gero aprašymo formulė
Trys dalys:
- Ką jis daro – vienas sakinys apie rezultatą, o ne procesą. Ne „generuoja SQL“, bet „eksportuoja pardavimus į Telegram kanalo lentelę“.
- Kada jį aktyvinti – 3–5 kabutėse pateiktos frazės, kurias naudotojai iš tiesų sako. Nespėliokite: peržiūrėkite savo pokalbių ir pagalbos užklausų istoriją.
- Kada jo NEaktyvinti – 1–2 frazės apie panašias užduotis, į kurias įgūdis neturėtų reaguoti. Be šios dalies du panašūs įgūdžiai nuolat konfliktuos.
Stipraus aprašymo pavyzdys iš mano projekto (supaprastintas ir nuasmenintas):
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.
Kas čia veikia:
- Veiksmažodis „rašo ir publikuoja“, o ne „padeda“, nurodo konkretų rezultatą.
- Keturios aktyviklio frazės kabutėse apima skirtingas formuluotes.
- Įtraukta ir frazė anglų kalba – jei naudotojas pereis prie komandos kalbos, įgūdis vis tiek veiks.
- Atskira skiltis „neaktyvinti, jei“ neleidžia kilti konfliktams su el. laiškų ir įrašų įgūdžiais.
Kaip patikrinti aprašymą
Savo skill-creator įrankyje Anthropic įdiegė aktyviklių vertinimo metodiką: 20 raginimų įgūdžio aktyvinimui patikrinti. Dešimt jų turėtų jį aktyvinti, o dešimt – ne (įskaitant beveik sutampančius scenarijus, kai formuluotė panaši, bet užduotis kita).
„Vibe coding“ terminais tai reiškia: parašę aprašymą atidarykite tuščią pokalbį ir išbandykite 5 dažnai vartojamas frazes bei 3 panašias frazes, reiškiančias ką kita. Jei įgūdis nesuveikia, kai turėtų, arba suveikia, kai neturėtų, pataisykite aprašymą. Tik tada rašykite instrukcijų turinį.
Kuriuos 5 įgūdžius įdiegčiau pirmiausia?
Svarbiausia
Greičiausia strategija verslininkui – pradėti nuo paruoštų kolekcijų ir jas pritaikyti. Anthropic ir Vercel paskelbė viešas kolekcijas, kurias galima įdiegti viena komanda ir kurios apima įprastas užduotis, pavyzdžiui, dokumentų rengimą ir dizainą. 2026 m. gegužės duomenimis, oficialioje anthropics/skills saugykloje buvo apie 138 000 žvaigždučių.
Pirmąsias dvi savaites skirti savų įgūdžių rašymui – pralaiminti strategija. Pradėkite įdiegdami paruoštus įgūdžius ir išsiaiškindami, kaip jie sukurti, o tada tuo pačiu būdu pridėkite savus. Pritaikyti kitų patikrintas kolekcijas sau kainuoja mažiau nei kurti viską nuo nulio. Štai penkios kolekcijos, nuo kurių pradėčiau:
1. anthropics/skills – oficiali kolekcija su skill-creator
Saugykla: github.com/anthropics/skills. 138 000 GitHub žvaigždučių. Joje yra oficialūs Anthropic komandos įgūdžiai: skill-creator (metaįgūdis, kuriantis kitus įgūdžius), claude-api (padeda kurti API integracijas) ir paruošti dokumentų įgūdžiai, skirti PowerPoint, Excel, Word ir PDF.
Įdiegimas naudojant Claude Code:
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills
Didžiausia vertė – skill-creator. Jis pagal jūsų aprašymą parašo SKILL.md, tada atlieka 20 aktyviklių vertinimų ir taiso aprašymą, kol įgūdis pradeda suveikti ten, kur reikia. Iš esmės tai „įgūdžių kūrimo įgūdis“.
2. mattpocock/skills – virusiniu tapusi TypeScript eksperto kolekcija
Kolekcijoje yra 12 aktyvių įgūdžių, įskaitant:
grill-me– užduoda klausimus pagal sprendimų medį, kol išsprendžiami neaiškumai. Pirmoje iteracijoje išsprendžiama pagrindinė „vibe coder“ problema – „nežinau, ko noriu“.diagnose– derinimas pagal ciklą: atkurti klaidą – sumažinti – iškelti hipotezę – įdėti instrumentavimą – pataisyti – atlikti regresinį testą.tdd– užtikrina red-green-refactor eigą: pirma nesėkmingas testas, tada minimalus pataisymas, o po to refaktoringas.to-issues– paverčia planą vertikaliai suskaidytais „GitHub“ klausimais (visas stekas, kuriuos galima diegti atskirai).
Įdiegimas:
npx skills@latest add mattpocock/skills
/setup-matt-pocock-skills
3. coreyhaines31/marketingskills – rinkodaros specialistų kolekcija
Jei vykdote internetines programas, dirbate laisvai samdomu rinkodaros specialistu ar valdote agentūrą, nereikia pusės metų skirti savų įgūdžių rašymui. Pusė užduočių jau paruošta.
4. vercel-labs/agent-skills – dizainas be dirbtinio intelekto išvaizdos
Saugykla: github.com/vercel-labs/agent-skills. Pagrindinis įgūdis – web-design-guidelines, įdiegiamas apie 133 000 kartų per savaitę. Jis tikrina UI kodą pagal daugiau kaip 100 prieinamumo, našumo ir patogumo taisyklių.
Kartu verta paminėti Anthropic frontend-design, įdiegiamą daugiau kaip 110 000 kartų per savaitę. Jis priverčia AI pasirinkti stilių prieš pradedant rašyti kodą. Be jo kiekviename Claude sukurtame puslapyje būna Inter šriftas, violetinis gradientas ir kortelių tinklelis. Rezultatas visiems vienodas.
5. obra/superpowers – kelių agentų darbo eiga
Apskritai, įdiegus pirmąsias tris sąrašo kolekcijas – anthropics/skills, mattpocock/skills ir coreyhaines31/marketingskills – Claude Code turės dešimtis paruoštų įgūdžių, apimančių daugumą verslininko užduočių per pirmąjį mėnesį.
Norite ne tik įdiegti paruoštus įgūdžius, bet ir susikurti sąranką, kuri Claude paverstų tikru jūsų asistentu? Įgūdžiai – vienas iš trijų metodikos ramsčių. Veikiančią sąranką sudaro trys dalys: AI klonas (įgūdžiai kaip supakuota ekspertinė patirtis) + Second Brain (žinių struktūra kontekstui) + konteksto inžinerija (kaip Claude mato visą projektą). Ši sąranka Claude iš spėliojančio asistento paverčia įrankiu, kuris mąsto pagal jūsų logiką.
Kurias pasikartojančias užduotis verta paversti įgūdžiu?
Svarbiausia
Taisyklė paprasta: bet kuris veiksmas, kurį atliekate daugiau nei du kartus per savaitę ir kurio žingsniai iš esmės visada tie patys, gali tapti įgūdžiu. Ne sudėtinga „kartą per metus auditoriui rengiama ataskaita“, o įprastas darbas: kanalo turinio planas, kliento kvitų tikrinimas, sveikinimo laiškas naujam dalyviui. Įgūdis vienkartines pastangas paverčia ištekliumi, veikiančiu be jūsų.
Dirbdamas su klientais ir kitų žmonių projektais šį šabloną mačiau dešimtis kartų. Kažkas turi „tą darbą, kurį kaskart atlieka nuo pradžių“. Kiekvieną pirmadienį parašo tokio paties tipo ataskaitą. Kaskart atsiradus naujam klientui atlieka tą pačią procedūrą. Kiekvienas leidinys kuriamas pagal tą patį šabloną. Ir kaskart tai užtrunka 30–90 minučių, nes reikia prisiminti veiksmus, atidaryti reikiamus failus ir vėl suformuluoti Claude užklausą.
Sprendimas – vieną kartą supakuoti tai į įgūdį. Tada pasakote vieną frazę, o Claude įkelia metodiką, perskaito reikiamus šaltinius ir parengia rezultatą. Štai trys pavyzdžiai iš skirtingų sričių:
1 pavyzdys. Laisvai samdomas rinkodaros specialistas – įgūdis weekly-content-plan
Ką jis daro rankiniu būdu: kiekvieną pirmadienį trims klientams parengia savaitės Telegram įrašus. Atidaro kliento prekės ženklo balso gaires, peržiūri naujausius įrašus, sugalvoja temas pagal produktų kalendorių ir sudaro lentelę su įžanginėmis frazėmis bei punktais.
Pavertus tai įgūdžiu, gaunama penkių žingsnių instrukcija: perskaityti kliento tono ir balso failą, perskaityti produktų kalendorių, patikrinti 10 paskutinių įrašų, kad nesikartotų temos, sugalvoti septynias skirtingų tipų temas (pardavimo, ekspertines, asmenines) ir pateikti lentelę.
Komanda „suplanuokime šios savaitės įrašus klientui X“ valandą pasiruošimo paverčia trijų minučių laukimu. Rinkodaros specialistas patikrina rezultatą, atlieka konkrečius pakeitimus ir siunčia jį klientui.
2 pavyzdys. Buhalteris užsakomosioms paslaugoms – įgūdis monthly-receipts-close (autoriaus pavyzdys)
Ką jis daro rankiniu būdu: kiekvienam klientui iš savo portfelio kas mėnesį eksportuoja banko išrašą, sutikrina jį su apskaitos sistemos mokėjimais, pažymi nesuklasifikuotus mokėjimus, parengia preliminarią pajamų ataskaitą ir palygina pajamų struktūrą su praėjusiu mėnesiu.
Įgūdis yra šešių žingsnių instrukcija ir keli apvalkalo scenarijai scripts/ aplanke banko išrašams analizuoti. Aktyviklis „uždaryk gegužę klientui X“ paragina Claude per 4–5 minutes parengti ataskaitą su pažymėtomis anomalijomis.
3 pavyzdys. Internetinės programos kūrėjas – įgūdis welcome-letter-new-participant
Ką jis daro rankiniu būdu: naujas dalyvis sumokėjo, tad reikia parašyti sveikinimo el. laišką. Geras pasveikinimas yra asmeniškas: atsižvelgiama į kanalą, iš kurio dalyvis atėjo, įsigytą produktą, jo grupę ir siunčiamą medžiagą. Šablonas „sveiki, džiaugiamės“ to neužtikrina.
Įgūdis nurodo Claude perskaityti knowledge/audience.md (kas tie žmonės), knowledge/products/<product>.md (ką jie gauna) ir tris paskutinius sveikinimo laiškus (kad nesikartotų), tada parašyti laišką tokia struktūra: įžanga – produkto ypatumai – pirmi trys žingsniai – atsisveikinimas.
Daug kartų greičiau nei dirbant rankiniu būdu. Kokybė nuoseklesnė, nes Claude nepamiršta patikrinti trijų šaltinių, o skubantis žmogus vieną iš jų praleidžia.
Ko NEpaversti įgūdžiu
- Vienkartinės užduotys. Jei tai darote kartą per metus teikdami mokesčių deklaraciją, tiesiog aprašykite užduotį Claude pokalbyje. Įgūdis atsiperka po 3 ar daugiau pakartojimų.
- Pernelyg bendros užduotys. „Padėk man su rinkodara“ nėra įgūdis – tai visa rinkodara. Įgūdis yra „savaitės turinio planas“ – konkretus veiksmas su konkrečiu rezultatu.
- Užduotys be pasikartojančių žingsnių. Jei procesas kaskart kitoks, tai ne įgūdis, o vienkartinis darbas.
Kaip Skill Creator sukuria įgūdžius už jus?
Svarbiausia
Skill Creator yra Anthropic metaįgūdis, paleidžiamas komanda /skill-creator. Jis veda per šešis etapus: parengimą, testavimą, vertinimą, iteravimą, optimizavimą ir supakavimą. Rezultatas – paruoštas naudoti SKILL.md, patikrintas 20 aktyviklių vertinimų (10 turėtų aktyvinti, 10 neturėtų). Ne programuotojui tai greičiausias būdas parašyti pirmą veikiantį įgūdį – nereikia aiškintis YAML ar ginčytis su Claude.
Sunkumas tas, kad gerą įgūdį iš pirmo karto parašyti sunku. Aprašymas dažnai būna per siauras arba per platus, jame trūksta frazių, kurias naudotojai iš tikrųjų vartoja, arba jis konfliktuoja su greta esančiu įgūdžiu. Anthropic tai sprendė išleisdama skill-creator – metaįgūdį, kuriantį kitus įgūdžius.
Įdiegę anthropics/skills, pasakykite Claude /skill-creator (arba tiesiog „sukurkime įgūdį savaitės ataskaitai“) ir atlikite šešių etapų eigą:
- Parengimas – skill-creator užduoda klausimus: ką įgūdis turėtų daryti, kokias aktyviklio frazes naudoti, kokius šaltinius skaityti ir kokius veiksmus atlikti. Rezultatas – pirmoji SKILL.md versija.
- Testavimas – skill-creator sukuria 20 testinių raginimų: 10, kurie turėtų aktyvinti įgūdį, ir 10, kurie skamba kaip aktyvikliai, bet neturėtų jo aktyvinti (beveik sutampantys atvejai).
- Vertinimas – kiekvienas raginimas paleidžiamas naujame pokalbyje ir tikrinama, ar įgūdis aktyvuotas. Jei jis aktyvuojamas netinkamoje situacijoje arba nesuveikia ten, kur turėtų, pažymimas rezultatas.
- Iteravimas – aprašymas perrašomas atsižvelgiant į nesėkmes, o testai atliekami dar kartą.
- Optimizavimas – galutinis poliravimas: tikrinama, ar neviršijama 1024 simbolių riba ir ar nėra konfliktų su esamais projekto įgūdžiais.
- Supakavimas – galutinis SKILL.md ir nuorodų failai sudedami į tinkamą struktūrą.
Praktiškai tai atrodo taip: 15–20 minučių kalbatės su Claude, atsakote į 7–8 patikslinančius klausimus ir galiausiai gaunate paruoštą, patikrintą įgūdį, suveikiantį nuo tinkamų aktyviklių.
Kita nauda – skill-creator parodo pavyzdinį SKILL.md rašymo stilių. Galite atidaryti jo paties failą ir pamatyti žingsnių formatą, toną bei struktūrą. Tai įrankis, demonstruojantis pats save: perskaitote jį ir išmokstate kurti savo įgūdžius.
Įgūdžiai, CLAUDE.md, subagentai, MCP, Hooks: ką pasirinkti?
Svarbiausia
Claude Code turi penkis skirtingus elgsenos išplėtimo įrankius, kurie nėra tarpusavyje pakeičiami. CLAUDE.md skirtas nuolatinėms projekto žinioms. Įgūdžiai – pasikartojančioms darbo eigoms, aktyvinamoms pagal aktyviklius. Subagentai atlieka darbą lygiagrečiai, atskirame kontekste. MCP jungia išorines sistemas (API, duomenų bazes). Hooks automatiškai reaguoja į įvykius. Dažniausia „vibe coder“ klaida – viską sukelti į CLAUDE.md arba mėginti sukurti įgūdį su kabliuku.
Dažniausia problema mano peržiūrėtuose projektuose – CLAUDE.md vienu metu pateikiamos projekto taisyklės, nuoseklios publikavimo instrukcijos, įsipareigojimo šablonas ir duomenų bazės aprašymas. Tai perkrauna kontekstą ir praktiškai neveikia: Claude nevykdo instrukcijos „kai naudotojas paprašo publikuoti“, nes modelis visą CLAUDE.md traktuoja kaip bendrą kontekstą be aiškių aktyviklių.
Sprendimas – kiekvieną dalyką priskirti tinkamam įrankiui:
| Kas | Kada naudoti | Pavyzdys |
|---|---|---|
| CLAUDE.md | Žinios, reikalingos VISADA | „Projektas turi nustatytą kalbą“, „tekste nenaudoti ilgųjų brūkšnių“, „prekės ženklo pavadinime rašoma raidė „o““ |
| Įgūdžiai | Pasikartojantis procesas, aktyvinamas pagal aktyviklį | „Diegti į gamybinę aplinką“, „savaitės įrašų planas“, „uždaryti kliento mėnesio apskaitą“ |
| Subagentai | Lygiagretus darbas arba didelio konteksto izoliavimas | „Saugumo auditas, kol planuoju naują funkciją“, „atskiroje sesijoje peržiūrėti kodo bazę“ |
| MCP | Jungtis prie išorinės sistemos | „Gauti duomenis iš CRM“, „paimti užduotis iš sekimo sistemos“, „patikrinti svetainę naršyklėje“ |
| Hooks | Automatinis atsakas į įvykį | „Paleisti patikrą po Edit“, „blokuoti pavojingas komandas“, „baigus siųsti pranešimą į Telegram“ |
Trumpai tariant, viskas susiveda į paprastą logiką: įgūdžiai ir MCP apima daugumą darbo eigų, o Hooks automatizuoja įprastas užduotis – kodo patikras, testus ir apsaugos priemones. Subagentų reikia, kai kontekstas tampa didelis. Dažniausia klaida – kurti subagentą ten, kur turėtų būti naudojamas įgūdis.
Sprendimų medis
Kai pagalvojate „noriu, kad Claude atliktų X“:
- Ar šios žinios reikalingos visą laiką? Pavyzdžiui, „projektas turi nustatytą kalbą“ arba „nenaudojame ilgųjų brūkšnių“. → Įrašykite jas į
CLAUDE.md. - Ar tai procedūra, kurią dabar atliekate rankiniu būdu ir kuri aktyvinama pagal poreikį? Pavyzdžiui, „kiekvieną pirmadienį rašau ataskaitą“. → Sukurkite įgūdį.
- Ar reikia prieigos prie išorinės sistemos? Pavyzdžiui, Stripe API arba CRM. → Prijunkite MCP serverį.
- Ar Claude Code turėtų automatiškai reaguoti į įvykį? Pavyzdžiui, po kiekvieno Edit paleisti linterį. → Parašykite kabliuką.
- Ar užduotis didelė, užims visą kontekstą ir jums reikia lygiagrečiai daryti ką nors kita? → Paleiskite subagentą.
90 % verslininko ir „vibe coder“ užduočių patenka į 1–3 kategorijas. Hooks ir subagentai – pažangesni įrankiai, skirti laikui, kai jau peržengėte „po vieną užduotį“ ribą.
Pasvirojo brūkšnio komandos ir įgūdžiai yra tas pats
Svarbus Claude Code pokytis: senoji pasvirojo brūkšnio komandų sistema (.claude/commands/) ir įgūdžiai iš esmės susiliejo. Failas .claude/commands/deploy.md ir failas .claude/skills/deploy/SKILL.md abu sukuria komandą /deploy. Jei pavadinimai sutampa, pirmenybė teikiama įgūdžiui. Tad jei vis dar naudojate seną pasvirojo brūkšnio komandų formatą, pereikite prie įgūdžių: sintaksė aiškesnė, o galimybių daugiau.
7 klaidos, trukdančios įgūdžiui veikti
Svarbiausia
Dažniausios įgūdžių problemos nėra Claude klaidos – tai pačių įgūdžių trūkumai. Aprašymas be aktyviklių, perkrautas 2 000 eilučių SKILL.md, konfliktuojantys panašūs įgūdžiai arba bandymas atsisiųsti „viską iš prekyvietės“. Kiekviena iš šių klaidų sutrikdo įgūdžio aktyvinimą arba jo veikimą.
1. Aprašyme nėra aktyviklių: įgūdis neaktyvinamas
Požymis: sukūrėte įgūdį, patikrinote struktūrą, viskas galioja, bet Claude jo neiškviečia gavęs naudotojo užklausą. Priežastis beveik visada ta pati: aprašymas, pavyzdžiui, „Turinio rašymo pagalbininkas“. Claude nežino, į kokias frazes reaguoti. Sprendimas: pačiame aprašyme kabutėse pateikite 3–5 tikras naudotojų frazes.
2. SKILL.md ilgesnis nei 500 eilučių: dėmesys išsisklaido
Anthropic aiškiai rekomenduoja failo turinį sutalpinti į 500 eilučių. Jei instrukcijas sudaro 2 000 eilučių, Claude praranda dėmesį, vykdo tik dalį žingsnių ir susipainioja dėl jų tvarkos. Sprendimas: dideles skiltis perkelkite į gretimus failus – examples/, references/, scripts/ – ir nurodykite juos SKILL.md.
3. Vienas įgūdis „viskam apie turinį“ vietoj trijų mažų
Viliojanti sąranka: vienas didelis įgūdis content, apimantis Telegram įrašus, nukreipimo puslapius ir el. laiškus. Tai neveikia. Įgūdis aktyvuojamas netinkamoms užklausoms, suplaka metodikas ir pateikia vidutinį rezultatą. Sprendimas: vienas įgūdis – vienas pasikartojantis veiksmas. Jei iš tiesų turite tris su „turiniu“ susijusias rutinas, sukurkite tris įgūdžius: telegram-post, landing-section, email-broadcast.
4. Įgūdyje nėra skilties „Kada jo NENAUDOTI“: kyla konfliktų
Požymis: projekte yra du panašūs įgūdžiai, o Claude iškviečia netinkamą. Pavyzdžiui, vienas įgūdis skirtas el. pašto naujienlaiškiui, o kitas – konkrečiai sveikinimo laiškams programos dalyviams. Jei aprašyme aiškiai nenurodyta „neaktyvinti, kai užklausa susijusi su bendru naujienlaiškiu“, sveikinimo laiškų įgūdis suveiks vos paminėjus „el. laišką“. Sprendimas: aprašyme aiškiai nurodykite netinkamus atvejus.
5. Projekte yra 50 įgūdžių: aprašymai sutrumpinami
Iš Claude Code dokumentacijos:
Įgūdžių pavadinimai visada įtraukiami, tačiau, kai įgūdžių daug, jų aprašymai sutrumpinami, kad tilptų į simbolių limitą, todėl gali dingti raktažodžiai, pagal kuriuos Claude susieja juos su užklausa. Biudžetas – 1 % modelio konteksto lango.
Jei iš prekyvietės atsisiuntėte 50 įgūdžių kolekcijų, kai kurie aprašymai bus sutrumpinti. Raktažodžiai, kuriais rėmėtės, gali dingti. Sprendimas: aktyviame projekte palikite 10–15 naudingiausių įgūdžių. Likusius laikykite neaktyviame archyve už visų aptinkamų skills katalogų ribų, pavyzdžiui, atskirame skill-archive/ savo medžiagos aplanke. Į projekto ar asmeninę sritį diekite tik reikalingus įgūdžius. ~/.claude/skills/ yra visuose projektuose matoma įdiegta asmeninė biblioteka, todėl perkėlimas ten nepašalina įgūdžių iš aptikimo.
6. Įgūdžiai iš nepatikrintų šaltinių: saugumo rizika
Anthropic apie tai įspėja oficialioje dokumentacijoje:
Naudokite tik patikimų šaltinių įgūdžius: savo sukurtus arba gautus iš Anthropic. Kenkėjiškas įgūdis gali paskatinti Claude iškviesti įrankius arba vykdyti kodą kitaip, nei nurodyta įgūdžio paskirtyje.
Atsitiktinėje GitHub saugykloje gali būti įgūdis, kuris pirmą kartą jį iškvietus nutekina jūsų API raktus. Sprendimas: prieš diegdami patys atidarykite ir perskaitykite SKILL.md. Nevykdykite nepažįstamų autorių įgūdžių svarbiuose projektuose.
7. Įgūdis be žinių aplanko pateikia „vidutinį ChatGPT“ rezultatą
Subtiliausia ir dažniausia antikonstrukcija. Įgūdis yra metodika, bet be konteksto metodika nieko nereiškia. Jei parašysite įgūdį „parašyti sveikinimo laišką“, bet projekte nebus auditorijos aprašymo ir prekės ženklo balso failo, Claude parašys eilinį ChatGPT el. laišką, niekuo neišsiskiriantį iš kitų.
Įgūdis geriausiai veikia tik tada, kai jau esate sukūrę projekto Second Brain pagal vadovo apie CLAUDE.md principus. Pirmiausia sukurkite žinių struktūrą, tada – ja pagrįstus įgūdžius. Pasielgę atvirkščiai gausite įprastą, vidutinės kokybės rezultatą, o ne jūsų stiliui pritaikytą darbą.
Kaip per 30 minučių sukurti pirmąjį įgūdį?
Svarbiausia
Žingsnis po žingsnio pateikiamas pirmojo veikiančio įgūdžio kūrimo receptas: pasirinkite vieną pasikartojantį veiksmą, surašykite žingsnius, sukurkite aplankų struktūrą, parašykite aprašymą pagal formulę, išbandykite jį su 5–8 raginimais ir kartokite, kol jis aktyvuosis ten, kur reikia. Realistiškai pirmasis įgūdis užtrunka 30–40 minučių. Kiekvienas kitas užtrunka 10–15 minučių, nes formatas jau pažįstamas.
Štai konkretus planas, pagal kurį kūriau pirmuosius įgūdžius savo projektuose:
1 žingsnis. Pasirinkite vieną pasikartojantį veiksmą
Atidarykite praėjusio mėnesio kalendorių. Raskite užduotį, kurią atlikote bent 4–5 kartus ir kuri kaskart užtrunka 30–60 minučių. Ne bendrą „rinkodarą“, o ką nors konkretaus: „pirmadienio pardavimų ataskaita“, „naujo kliento įvedimas“ arba „akcijos kainoraščio atnaujinimas“.
Kuo tiksliau suformuluota užduotis, tuo paprastesnis įgūdis ir aiškesnis aktyviklis.
2 žingsnis. Rankiniu būdu surašykite procesą
Atskirame faile arba pokalbyje su Claude (ne įgūdžiui, o kaip juodraštį) surašykite veiksmus, kuriuos atliekate:
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
Tai dar nėra įgūdis – tik užrašai. Tačiau be šių užrašų rašant SKILL.md nuo pat pradžių kils painiava.
3 žingsnis. Sukurkite aplankų struktūrą
mkdir -p .claude/skills/welcome-email-new-client
touch .claude/skills/welcome-email-new-client/SKILL.md
Arba, jei norite naudoti įgūdį visuose projektuose, įdėkite jį į ~/.claude/skills/.
4 žingsnis. Parašykite SKILL.md pagal šabloną
Griaučiai:
---
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
5 žingsnis. Išbandykite su 5–8 raginimais
Šiame projekte atidarykite tuščią pokalbį su Claude Code. Išbandykite 5 frazes, kurias iš tikrųjų vartojate, ir 3 panašias frazes, kurios neturėtų aktyvinti įgūdžio:
Turėtų aktyvinti:
- „Parašyk sveikinimo laišką naujam klientui Ivanovui“
- „Priimk naują dalyvį, kuris įsigijo X programą“
- „Sveikinimo laiškas klientui iš Instagram“
Neturėtų aktyvinti:
- „Išsiųsk akcijos laišką visam sąrašui“
- „El. pašto kampanija Naujųjų metų šventėms“
- „Parašyk priminimą klientui, kuris nesumokėjo“
Patikrinkite kiekvieną frazę ir įsitikinkite, ar įgūdis buvo aktyvintas. Jei jis suveikia netinkamais atvejais, susiaurinkite aprašymą. Jei nesuveikia ten, kur turėtų, praplėskite aktyviklio frazes.
6 žingsnis. Iteruokite aprašymą
Po kiekvieno nesėkmingo testo redaguokite tik aprašymą – nelieskite instrukcijų turinio. Po 2–3 iteracijų įgūdis pradeda patikimai aktyvuotis. Išsaugokite jį, įtraukite į įsipareigojimą ir naudokite kasdien.
Paskutinis patarimas: nesistenkite, kad pirmasis įgūdis būtų tobulas. Padarykite, kad jis veiktų. Gludinkite jį sukūrę penktą ar dešimtą įgūdį, kai pastebėsite savo formuluočių ir Claude atsakymų dėsningumus.
Šią savaitę išsirinkite vieną pasikartojančią užduotį iš kalendoriaus, skirkite jai 30 minučių ir atlikite šešis pirmiau aprašytus žingsnius. Tada Claude dirbs pagal jūsų metodiką, o ne spėlios.
Šaltiniai
- Išplėskite Claude naudodami įgūdžius – Claude Code dokumentacija
- Agent Skills apžvalga – Claude Platform dokumentacija
- Agentų paruošimas darbui realiame pasaulyje su Agent Skills – Anthropic Engineering tinklaraštis
- anthropics/skills – oficiali saugykla su skill-creator
- Skill Creator SKILL.md – aktyviklių vertinimo metodikos šaltinis
- vercel-labs/agent-skills – dizaino gairės
- Agent Skills atvirasis standartas – specifikacija
Veikiančią sąranką sudaro AI klonas + Second Brain + konteksto inžinerija. Trys vienos metodikos dalys.
Jei reikia prieigos prie AI modelių per Ailoot, apsilankykite Ailoot.
Išsamiau
Klausimai ir atsakymai
Ar perkėlus įgūdį į ~/.claude/skills/ jis tampa neaktyvus?
Ne. Šis katalogas yra įdiegta asmeninė sritis, suteikianti prieinamumą visuose projektuose. Nenaudojamus paketus laikykite archyve už visų aptinkamų katalogų ribų, tada diekite tik dabar reikalingus įgūdžius.
Kaip patikrinti, ar aprašymas tinkamai sužadina įgūdį?
Išbandykite penkias frazes, kurios turi jį iškviesti, ir tris panašias užklausas, kurios neturi. Naudokite naujus pokalbius, fiksuokite įkeltą įgūdį ir koreguokite aprašą, jei jis praleidžia tikrą užklausą ar suveikia artimam netinkamam atvejui.