Tinklaraštis

Claude Code įgūdžiai 2026 m.: kaip susikurti įgūdžių biblioteką

Markdown

Kaip 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:

  1. Metaduomenys (visada) – prasidėjus seansui Claude mato tik kiekvieno įgūdžio name ir description. Biudžetas: apie 100 žetonų įgūdžiui.
  2. Instrukcijos (suveikus aktyvikliui) – naudotojui pasakius ką nors susijusio, Claude įkelia SKILL.md turinį. Biudžetas: mažiau nei 5000 žetonų.
  3. 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

LygisKeliasTaikoma
ĮmonėsValdomi organizacijos nustatymaiVisiems įmonės naudotojams
Asmeninis~/.claude/skills/<name>/SKILL.mdVisiems jūsų projektams
Projektas.claude/skills/<name>/SKILL.mdTik šiam projektui
Papildinys<plugin>/skills/<name>/SKILL.mdTen, 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. anthropic ir claude yra 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/ ir examples/ 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:

LaukasPaskirtisPavyzdys
nameĮgūdžio pavadinimas; jei nenurodytas, naudojamas aplanko pavadinimasdeploy-to-prod
descriptionAutomatinio iškvietimo aktyviklisŽr. formulę toliau
when_to_usePapildomos aktyviklio frazės["deploy", "let's ship it"]
allowed-toolsĮrankiai, kuriuos galima naudoti neprašant leidimo["Read", "Bash(npm run build)"]
disable-model-invocationtrue – iškviesti gali tik naudotojasPavojingoms operacijoms
user-invocablefalse – iškviesti gali tik ClaudeFoninėms žinioms
pathsGlob šablonai, nurodantys, kur įgūdis aktyvus["src/**/*.ts"]
context: forkVykdyti izoliuotame subagenteKai kontekstas didelis
agentPaleidžiamo subagento tipasExplore, Plan, general-purpose
effortMąstymo lygislow, medium, high, xhigh, max
modelKurį modelį priskirti įgūdžiuiclaude-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“.

— Anthropic Skill Creator (SKILL.md), https://github.com/anthropics/skills/blob/main/skills/skill-creator/SKILL.md

Gero aprašymo formulė

Trys dalys:

  1. Ką jis daro – vienas sakinys apie rezultatą, o ne procesą. Ne „generuoja SQL“, bet „eksportuoja pardavimus į Telegram kanalo lentelę“.
  2. 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ą.
  3. 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ą:

  1. 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.
  2. 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).
  3. 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.
  4. Iteravimas – aprašymas perrašomas atsižvelgiant į nesėkmes, o testai atliekami dar kartą.
  5. Optimizavimas – galutinis poliravimas: tikrinama, ar neviršijama 1024 simbolių riba ir ar nėra konfliktų su esamais projekto įgūdžiais.
  6. 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:

KasKada naudotiPavyzdys
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žiaiPasikartojantis procesas, aktyvinamas pagal aktyviklį„Diegti į gamybinę aplinką“, „savaitės įrašų planas“, „uždaryti kliento mėnesio apskaitą“
SubagentaiLygiagretus darbas arba didelio konteksto izoliavimas„Saugumo auditas, kol planuoju naują funkciją“, „atskiroje sesijoje peržiūrėti kodo bazę“
MCPJungtis prie išorinės sistemos„Gauti duomenis iš CRM“, „paimti užduotis iš sekimo sistemos“, „patikrinti svetainę naršyklėje“
HooksAutomatinis 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“:

  1. Ar šios žinios reikalingos visą laiką? Pavyzdžiui, „projektas turi nustatytą kalbą“ arba „nenaudojame ilgųjų brūkšnių“. → Įrašykite jas į CLAUDE.md.
  2. 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į.
  3. Ar reikia prieigos prie išorinės sistemos? Pavyzdžiui, Stripe API arba CRM. → Prijunkite MCP serverį.
  4. Ar Claude Code turėtų automatiškai reaguoti į įvykį? Pavyzdžiui, po kiekvieno Edit paleisti linterį. → Parašykite kabliuką.
  5. 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.

— Claude Code dokumentacija, https://code.claude.com/docs/en/skills

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.

— Anthropic Agent Skills apžvalga, https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview

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.

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.

Visi straipsniai