Skills: agentə hazır bacarığı necə qoşmaq olar

Təkrarladığınız bir xahiş var: dəyişikliklərə bax, bu faylları yoxla, bunu belə tərtib et, bura isə toxunma. Hər dəfə proseduru yenidən və bir az fərqli izah edirsiniz.

Nəticə də ifadə tərzi ilə birlikdə dəyişir. Bu gün əla alındı, sabah şərtlərin yarısını unutdunuz və agent vicdanla eşitdiyini etdi.

Bunun çarəsi agentin yaddaşı deyil, təlimatlı qovluqdur. Skill - bir dəfə yazılmış prosedurdur, Claude Code onu özü və ya sizin əmrinizlə qoşa bilər. Bu qovluğun harada yerləşdiyini, skill-in düzgün qurulduğuna necə əmin olmağı və ilk işə salmadan əvvəl nəyi yoxlamağı araşdıraq.

Skill nədir

Fayllara və sahələrə keçməzdən əvvəl ideyanı sadə nümunədə hiss edək.

Bir dülgəri təsəvvür edin. O, vərdiş etdiyi iş qaydasını bir dəfə yazıb, qeydlər, şablonlar və dəzgah üçün proqram hazırlayıb. İndi qısaca deyir: "hər şeyi yığışdır, burğunu itilə, sonra pişik üçün stul - CNC şablonunu işə sal". İşə saldı - və iş başladı.

Yazılı prosedur bütün işi bir arada saxlayır:

• Sizin qaydalarınızla nizam yaradır. İş masasını yığışdırır, alətləri yerbəyer edir - hər dəfə eyni cür, tam öyrəşdiyiniz kimi.
• Yazılmış sərhədlərə əməl edir. Mişar hələ fırlanır - yaxına getmir. İşin təhlükəsiz hissəsini dərhal, artıq sual vermədən görür.
• Lazım olanda qeydlərə baxır. Burğunu itiləmək lazımdır - itiləmə qaydasını açdı. Onu əvvəlcədən yadda saxlamır, yerindəcə götürür.
• Müxtəlif işlər üçün şablonlar saxlayır. Stoldan stullara keçdilər - hazır hazırlıq sxemini götürür.
• Mürəkkəb işi bir əmrlə işə salır. Təkrarlanan kəsimlərin proqramı artıq yanındadır. Demək kifayətdir: "Pişik üçün stul şablonunu tap və CNC-yə göndər" - dəzgah boşluqlara və əməliyyatların ardıcıllığına əməl edəcək.

Skill də eyni cür qurulub. Bu, agentin əlində daha bir alət deyil, paketlənmiş prosedurdur. Əsas təlimat ardıcıllığı və sərhədləri saxlayır, arayış faylları detalları yerində verir, şablonlar hazırlıqları saxlayır, skriptlər isə təkrarlanan mexanikanı işə salır. Bir dəfə təsvir etdiniz - sonra sadəcə çağırılır.

Skill formatı özü heç nəyi təcrid etmir. Təlimat işi tərtibatla məhdudlaşdıra bilər, amma CSS ilə məntiq arasında texniki divar yoxdur. Yaxşı skill iş sahəsini açıq adlandırır; işə saldıqdan sonra siz dəyişdirilmiş fayllara baxırsınız və səhifənin davranışını yoxlayırsınız. "İşləyir" və "görünür" - fərqli qatlardır, zəmanəti isə format deyil, yoxlama verir.

Skill harada yaşayır

Burada buludda heç bir sehr yoxdur. Skill - diskdə, elə sizin layihənizdə yerləşən qovluqdur:

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

Yolu seqmentlərə bölək: xidməti qovluq .claude, onun içində skills, onun içində - skill-in öz qovluğu (adını siz seçirsiniz), orada da SKILL.md faylı. Adi mətn faylıdır, istənilən proqramla açılır.

Layihədəki və ev qovluğundakı skill üçün qovluğun adı sleşli əmrin adına çevrilir, əgər faylın özü başqa ad təyin etmirsə (bu barədə aşağıda danışacağıq). Ona görə adı elə əvvəldən çatda necə görünəcəyini nəzərə alaraq seçin.

İndi ən yayğın təsəvvürə bir düzəliş: skill bir fayl deyil, qovluqdur. SKILL.md faylının yanında istənilən şey ola bilər.

.claude/
└── skills/
    └── web-design/
        ├── SKILL.md      # əsas fayl: təsvir və təlimat
        ├── palettes.md   # arayış, lazım olsa agent onu açacaq
        └── scripts/
            └── check.py  # işə salına bilən skript

Avtomatik seçim üçün agentə bütün mətn deyil, skill-in adı və qısa təsviri görünür. SKILL.md işə salınanda yüklənir, qonşu arayış faylları - lazım olduqca. Ona görə uzun qeyd konteksti əvvəlcədən doldurmur.

Adi lokal iş üçün skill-lərin üç mənbəyi vacibdir:

~ işarəsi istifadəçinin ev qovluğu deməkdir. Əmrlərdə onu olduğu kimi saxlayırlar; qovluğu əl ilə açırsınızsa, öz ev kataloqunuza keçin.

İlk iki yer arasındakı fərq sadədir və onu elə indi aydınlaşdırmağa dəyər.

Qovluğu layihəyə qoydunuz - skill yalnız bu layihədə işləyir. Qonşu layihəni açdınız, orada isə yoxdur.

Ev qovluğundakı skill bütün layihələrdə əlçatandır. Ümumi prosedur üçün rahatdır, amma gözləmədiyiniz yerdə işə düşə bilər. Universal olanı evə qoyurlar, layihəyə aid olanı layihədə saxlayırlar.

Claude Code ayrıca tədris profili ~/.claude-codegym/ ilə işə salınıbsa, şəxsi skill-lər onun skills/ qovluğunda yerləşir. Layihə yolu .claude/skills/ profildən asılı olaraq dəyişmir.

Description skill-in nə vaxt işə düşəcəyini həll edir

Tipik hekayə: qovluğu qoydunuz, fayl yerindədir, agent isə tam əvvəlki kimi davranır. Heç nə sınmayıb - o sadəcə bu skill-in burada uyğun olduğunu anlamadı.

Seçim anında agentin əlində nə olduğuna baxın. Skill-in mətnini o hələ oxumayıb: yalnız adlar və təsvirlər siyahısı yüklənib. Deməli, qərar təsvirə görə verilir, başqa heç nəyə görə yox.

Layihə üçün minimal skill-i başdan sona yığaq. Onun adı web-design-dır - qovluq belə adlanır və /web-design əmri də buradan götürülür. Burada faylın özündə adı yazmırıq, onu artıq qovluq verib:

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

İçində isə bu var, başqa heç nə lazım deyil:

---
description: Veb interfeysi qaydaya salır - müasir CSS, hamar keçidlər,
  uyğunlaşdırılmış palitra. Gözəl və ya zövqlü etməyi xahiş edəndə tətbiq et.
---

# Veb-dizayn

Yumşaq kölgələrdən, hamar keçidlərdən və düşünülmüş tipoqrafiyadan istifadə et.
Palitranı uyğun saxla, animasiyalar - üzərinə gətirmə və elementlərin görünməsi üçün.

Yuxarıda, üç defis arasında, xidməti blok, aşağıda adi təlimat mətni. Məcburi sahə yoxdur, amma description sahəsini həmişə yazmağa dəyər: onsuz agent skill-in təyinatını mətnin ilk abzasından təxmin edir, bu da lotereyadır.

Yaxşı təsvir iki suala cavab verir: skill nə edir və onu nə vaxt götürmək lazımdır. Üstəlik, sorğuları həqiqətən yazdığınız sözlərlə.

# susur: nə vaxt tətbiq etmək lazım olduğu aydın deyil
description: Tərtibatla kömək edir

# işə düşür: həm nə etdiyi, həm də nə vaxt deyilib
description: İnterfeysi qaydaya salır - CSS, tipoqrafiya, palitra.
  Gözəl, zövqlü etməyi və ya maketi düzəltməyi xahiş edəndə tətbiq et.

Skill-in nə vaxt özü işə düşəcəyini təsvir müəyyən edir. Amma bu yeganə giriş deyil: skill-in adı var və onu bu adla əl ilə çağırmaq olar. /web-design yazdınız - təsvirin burada heç bir rolu yoxdur, fayl oxunur və yerinə yetirilir.

Hazır skill-lərdə tez-tez name sahəsinə rast gəlinir. Layihədəki və ev qovluğundakı skill-lər üçün bu sahə / menyusunun göstərdiyi əmri müəyyən edir: deploy-staging qovluğunda name: deploy olan skill /deploy kimi çağırılır. Qovluğun adı da işləməyə davam edir. Plagində name plagin adından sonra gələn əmrin son hissəsini təyin edə bilər.

Deməli, işə salmanın iki yolu var, onlardan sonrakı hər şey isə eynidir.

Sol qol avtomatikdir: sorğu təsvirlə üst-üstə düşdü, agent skill-i götürdü. Sağ qol əl ilədir: /web-design yazdınız və skill təsvirdən asılı olmadan işə düşdü.

Skill-lər daxili əmrlərlə eyni / menyusuna düşür. .claude/commands/deploy.md faylı və .claude/skills/deploy/SKILL.md skill-i eyni /deploy əmrini yaradır; ikisi də varsa, skill qalib gəlir.

Quraşdırmaq və yoxlamaq

Qovluğu qoydunuz. Agentin onu həqiqətən gördüyünü, faylın sadəcə diskdə durmadığını necə bilmək olar?

/skills

Əmr skill-lərin siyahısını açır və onların mənbəyini göstərir. Bir-iki hərf yazın - siyahı süzüləcək. Qovluğunuzun adını və on vəziyyətini tapdınız - deməli, Claude Code skill-i görür və onun işə salınmasına icazə verir.

Ad, mənbə və on vəziyyəti skill-in əlçatan olduğunu təsdiqləyir

Adətən Claude Code yeni və ya dəyişdirilmiş SKILL.md faylını dərhal, işin gedişində götürür. Siyahıda ad yoxdursa, ardıcıllıqla yoxlayın:

Skill siyahıda var, amma özü işə düşmür? Yenidən yükləmənin buna aidiyyəti yoxdur. description sahəsini və disable-model-invocation: true sahəsini yoxlayın - bu sahə yalnız əl ilə işə salmağı saxlayır. Xahişi başqa cür ifadə edin və ya skill-i adı ilə çağırın. Əl ilə çağırış işləyirsə, deməli, quraşdırma qaydasındadır.

Etibar etməzdən əvvəl nəyi yoxlamalı

Burada həvəsi bir az cilovlamaq lazım gələcək. Skill taxıb-çıxarmaq olan tərtibat mövzusu və ya şəkil deyil. Bu, agentinizin sizin layihənizdə yerinə yetirəcəyi təlimatlardır.

Yalnız əsas faylı deyil, bütün qovluğu yoxlamaq lazımdır. Dörd şeydən başlayın:

• təsvir - skill-dən gözlədiyinizlə üst-üstə düşürmü və həddən artıq geniş işə düşmürmü;
• mətn və ondakı istinadlar - skill nə etməyi tapşırır və hansı qonşu faylları açmağı xahiş edir;
• scripts/ qovluğu, əgər varsa - orada hansı əmrlər işə salınır, onlar hansı fayllara və şəbəkə ünvanlarına toxunur;
• allowed-tools sahəsi - skill ayrıca sual vermədən hansı alətlərdən istifadəyə əvvəlcədən icazə verir.

---
name: pre-commit-style
description: Commit-dən əvvəl layihəni ümumi stilə gətirir
allowed-tools: Read, Write, Edit, Glob
---

Burada allowed-tools iş planını təsvir etmir və agentin imkanlarının tam dəstini məhdudlaşdırmır. Sahə yalnız sadalanan alətləri skill-in çağırıldığı addım üçün əvvəlcədən təsdiqləyir. Adların mənası sadədir:

• Read - faylları oxumaq;
• Write - yeni fayllar yaratmaq və mövcud faylları tamamilə yenidən yazmaq;
• Edit - mövcud faylın içində düzəliş etmək;
• Glob - faylları maskaya görə axtarmaq, yəni layihəni gəzib orada ümumiyyətlə nə olduğuna baxmaq.

Birinci və sonuncu yalnız baxır. Write və Edit faylları dəyişə bilir: təlimat belə bir hərəkətə gətirib çıxarsa, bu addımda ayrıca sual olmaya bilər. Amma icazənin olması agentin ondan mütləq istifadə edəcəyi demək deyil. Layihənin ümumi giriş qaydaları bu zaman da qüvvədə qalır.

Sahənin özü pis bir şey deyil: məhz istədiyiniz yerdə artıq təsdiqləri aradan qaldırır. Amma dəsti skill-in müəllifi seçib, ona görə də ilk işə salmadan əvvəl ona baxmağa dəyər.

Və sonuncu, daha az qorxulu, amma daha tez-tez rast gəlinən məqam. Skill agentə istiqamət verir, nəticəyə zəmanət vermir. İşə saldıqdan sonra dəyişdirilmiş fayllara baxın və nəticəni yoxlayın: tərtibat skill-i səhifəni gözəlləşdirə bilər, amma düymənin işlədiyini onun əvəzinə heç kim təsdiqləməyəcək.

Hazır skill-ləri haradan götürmək olar

Sınamaq üçün SKILL.md faylını sıfırdan yazmaq heç də vacib deyil. Hazır skill-ləri çox vaxt açıq repozitoriyalarda tapırlar və ya plaginlərlə birlikdə alırlar.

Ən qısa yol - agentdən uyğun variant tapmağı xahiş etmək, amma onu kor-koranə quraşdırmamaq. Xahiş belə ola bilər:

İnterfeys tərtibatı üçün skill tap. Mənbəyi, SKILL.md-ni və skriptləri göstər,
hansı fayllardan və alətlərdən istifadə etdiyini izah et. Mən təsdiqləyənə
qədər heç nə quraşdırma.

Mənbəyə və məzmuna baxdınız - sonra qovluğu layihənin .claude/skills/ qovluğuna qoymağı xahiş edin və nəticəni /skills ilə yoxlayın.

Müstəqil axtarış üçün Claude skills marketplace sorğusu uyğundur. Kataloq variant tapmağa kömək edir, amma təhlükəsizlik nişanı deyil: məzmunu yenə də quraşdırmadan əvvəl oxuyurlar.

SKILL.md açıq Agent Skills standartına əsaslanır, ona görə də baza struktur müxtəlif agentlər arasında köçürülə bilir. Amma Claude Code öz sahələrini və işə salma üsullarını əlavə edir. Skill-i başqa alətə köçürdünüz - orada hansı imkanları həqiqətən dəstəklədiyini yoxlayın.

Öz skill-inizi agentlə yığa bilərsiniz

Öz skill-inizi yaratmaq vaxtının çatdığını heç bir nəzəriyyə olmadan anlayırsınız: eyni proseduru üçüncü dəfə izah edirsiniz. Tapşırığı deyil, məhz hərəkətlərin ardıcıllığını - buna bax, bunu yoxla, bunu belə tərtib et, bura toxunma. Təkrarlanırsa, deməli, vaxtı çatıb.

Və burada yaxşı xəbər var. SKILL.md faylını boş vərəqdən yazmaq vacib deyil. Agent qaralamanı yığa bilər, sizdən isə prosedurun nə olduğunu və ondan nə gözlədiyinizi izah etmək tələb olunur. Bu, adi söhbət kimi görünür:

Commit hazırlığı üçün skill yarat. O, nəyin dəyişdiyinə baxmalı,
commit-ə artıq faylların düşüb-düşmədiyini yoxlamalı və mesajı
bizim şablona uyğun yazmalıdır. Onu özüm istəyəndə əl ilə işə salacağam.
Tələblər çatmırsa, əvvəlcə sual ver.

Diqqət edin, siz heç bir sahənin adını çəkmədiniz və faylın quruluşuna qarışmadınız. Tələblər sözlə deyilib, onları sahələrə çevirmək agentin işidir.

Məlumat çatmırsa, agent sual verəcək. Belə xahiş olmasa, o dərhal fərziyyələr edə bilər, ona görə də lazımi sətir artıq nümunədə var. Qaralamanı aldıqdan sonra faylları yoxlayın, skill-i /skills ilə tapın və sınaq üçün işə salın.

Proseduru əl ilə keçmək mümkündürsə, paketləməzdən əvvəl bunu agentlə birlikdə edin. Addım-addım edilmiş bir commit harada düzəliş lazım olduğunu və izahda nəyin çatmadığını göstərəcək. Canlı icra əsasında yazılmış skill xatirələr əsasında yazılandan daha dəqiq olur.

SKILL.md böyüyəndə

İlk öz skill-iniz demək olar ki, həmişə bir fayldan ibarət olur və bu, normaldır. Darısqallıq sonra başlayır: prosedur detallarla böyüyür, içəri uyğunluq cədvəli, qaydalar siyahısı, üç uzun nümunə köçür və bir gün dörd ekranlıq faylı açırsınız.

Hər şeyi bir yerə yığmaq lazım deyil və səbəbi yuxarıda artıq deyildi: skill işə düşən kimi onun mətni tamamilə yüklənir. Dörd ekranlıq arayış onlardan cəmi bir sətir lazım olduğu halda da işə gedəcək.

Ona görə detalları qonşu fayllara çıxarırlar, SKILL.md faylında isə istinad saxlayırlar: filan vəziyyət olsa - filan faylı aç. palettes.md və scripts/ olan qovluğu artıq görmüsünüz, içəridən isə belə görünür:

## Arayış

- Palitralar və rəng uyğunluqları - [palettes.md](palettes.md) faylında
- Hazır tərtibat nümunələri - [examples.md](examples.md) faylında
- Kontrastı yoxlamaq: scripts/check.py-ni işə sal

Arayışı agent lazım olduqca açır. Skripti bütün mənbə kodunu söhbətə avtomatik yükləmədən icra etmək olar, ona görə faylın ölçüsü konteksti demək olar ki, sərf etmir. Amma başqasının skriptini ilk işə salmadan əvvəl yenə də oxuyurlar: bu, icra olunan koddur və onun çıxışı agentin işinə düşəcək.

Faylları təyinatına görə bölmək rahatdır:

• SKILL.md - prosedurun özü: nə etməli, hansı ardıcıllıqla, nə etməməli. Çağırışdan əvvəl agent onun təsvirini görür, mətni isə işə salınanda yükləyir;
• arayış faylları - cədvəllər, qaydalar, uzun nümunələr, hər işə salmada lazım olmayan hər şey;
• scripts/ - sözlə təsvir etməkdənsə icra etmək daha asan olan şeylər. Başqasının skill-ində bu faylları işə salmadan əvvəl yoxlayırlar;
• şablonlar - skill-in əsas götürdüyü və tapşırığa uyğun düzəltdiyi fayllar.

Buradan tərs nəticə də çıxır, bu dəfə başqasının skill-ləri haqqında. Qısa SKILL.md "sadə skill" demək deyil. Qovluqda onun yanında nə olduğuna baxın.

Bu, işdə nəyi dəyişir

Hər şeyi bir neçə sətrə yığsaq:

• təkrarlanan xahiş qovluğa çevrilir. İş qaydasını bir dəfə təsvir etdiniz - sonra o, istənilən sessiyada və istənilən gün eyni cür təkrarlanır;
• öz skill-inizi boş vərəqdən yazmamaq olar. Proseduru sözlə izah edirsiniz, çatmayanı dəqiqləşdirməyi xahiş edirsiniz və yığılmış qaralamanı yoxlayırsınız;
• avtomatik işə salmada skill description ilə seçilir, əl ilə işə salmada - sleşli adla. Susursa, əvvəlcə onun siyahıda görünüb-görünmədiyini və avtomatik işə salmaya icazə olub-olmadığını aydınlaşdırın;
• /skills "o, ümumiyyətlə quruldumu" sualına cavab verir. Yarım dəqiqəlik yoxlama yarım saatlıq təxminlərə qənaət edir;
• başqasının skill-i quraşdırılmadan və işə salınmadan əvvəl, bağlı fayllar və skriptlərlə birlikdə oxunur;
• skill agentin işi necə gördüyünü dəyişir, amma düzəliş sahəsini təcrid etmir və nəticənin yoxlanmasını ləğv etmir.