Claude Code Skills 2026 жылы: өзіңізге арналған skills кітапханасын қалай құруға болады

Ailoot құжаттамасы: API, кілттер және баптау.

Claude Code-тағы Skill деген не және ол неге «үлкенірек сұрау мәтіні» ғана емес?#

Claude Code Skills — Anthropic 2025 жылғы қазанда Pro/Max/Team/Enterprise жоспарларына арнап іске қосқан Claude Code-тың кіріктірілген мүмкіндігі. Кейін олар Agent Skills спецификациясын Claude-тан тыс жерде де жұмыс істейтін стандарт ретінде ашты. Кодта бұл жай ғана бума:

.claude/skills/
├── deploy-to-prod/
│   ├── SKILL.md
│   └── scripts/
│       └── check-migrations.sh
├── weekly-content-plan/
│   └── SKILL.md
└── triage-support-tickets/
    └── SKILL.md

Әр бума — бір skill. SKILL.md — жоғарғы жағында YAML frontmatter, одан кейін қарапайым нұсқаулар жазылған Markdown файлы. Пайдаланушы «өндіріске шығарайық» дегенде, Claude deploy-to-prod skill-інің сипаттамасын көріп, «өндіріске шығару» триггерін таниды, SKILL.md мазмұнын контекстке жүктеп, қадамдарды орындайды.

Біртіндеп жүктеудің үш деңгейі

Anthropic skills-ті қажеттілікке қарай қабат-қабат жүктелетіндей етіп құрды. Anthropic Engineering блогында топ мұны «Agent Skills-ті икемді әрі кеңейтілетін ететін негізгі жобалау қағидасы» деп сипаттайды (Anthropic Engineering).

Жүктеудің үш деңгейі:

1. Метадеректер (әрдайым) — сессия басталғанда Claude әр skill-дің тек name және description өрістерін көреді. Бюджет: әр skill-ге шамамен 100 токен.
2. Нұсқаулар (триггер бойынша) — пайдаланушы сәйкес нәрсе айтқанда, Claude SKILL.md мазмұнын жүктейді. Бюджет: 5000 токеннен аз.
3. Ресурстар (сұрау бойынша) — бірге берілген файлдар (мысалдар, үлгілер, деректер жиындары) модельдің өзі оларды іздегенде ғана алынады. Бюджет: шектеусіз.

Бұрын CLAUDE.md файлында AI «есте сақтауы» керек нәрсенің бәрін сақтау қажет болатын, ал 50 ережесі бар жоба контекст шегіне тез жететін. Skills көмегімен бір жобада ондаған skill оңай қатар тұра алады, өйткені бастапқы контекске тек олардың сипаттамалары ғана енеді.

Skills қайда орналасады: төрт деңгей

Басымдық реті: enterprise жеке баптауларды, ал жеке баптаулар жоба баптауларын басып озады. Плагиндер plugin-name:skill-name атаулар кеңістігін пайдаланады және қайшылық тудырмайды. Бұл ыңғайлы: жалпы кәсіби skills-ті ~/.claude/skills/ ішіне, ал жобаға тәндерін репозиторийдің .claude/skills/ ішіне орналастыруға болады.

SKILL.md ішінде не бар?#

Міне, ең қарапайым мысал — жиырма жол, skill дайын:

---
name: weekly-content-plan
description: Telegram арнасы мен қысқа видеолар үшін апта сайынғы жарияланым жоспарын дайындайды. Триггерлер - "жарияланым жоспарын жаса", "осы аптада не жариялайын", "арнаға 7 күндік жоспар". Сұрау веб-сайт немесе email-хат тарату туралы болса, іске қоспа.
---

# Weekly Content Plan

## Қадамдар

1. `knowledge/audience.md` файлын оқы - кімге арнап жазамыз
2. `knowledge/tone-of-voice.md` файлын оқы - қалай жазамыз
3. Арнадағы соңғы 10 жарияланымды оқы - қандай тақырыптар қамтылған
4. Аптаға 7 тақырып ойлап тап: сатылымға бағытталған 3, сараптамалық 2, жеке 2
5. Әрқайсысына бір ілмек сөйлемі мен жарияланым туралы үш тармақ ұсын
6. Кесте түрінде шығар: апта күні | түрі | ілмек | жоспар

Осы жеткілікті. Пайдаланушы «осы аптаға жарияланымдарды жоспарлайық» деп жазса, Claude сипаттамадағы триггерді көріп, SKILL.md файлын жүктеп, аталған файлдарды оқып, кесте шығарады.

Есте ұстайтын шектеулер

Claude API-дың ресми құжаттамасы қатаң шектеулер белгілейді:

• name: 64 таңбаға дейін; тек кіші әріптер, сандар және дефистер; XML тегтері болмауы керек. anthropic және claude — резервтелген атаулар.
• description: API-де 1024 таңбаға дейін; міндетті өріс, XML тегтері болмауы керек.
• Тізімдеу бюджеті: Claude Code-та барлық skills сипаттамалары бірге контекст терезесінің шамамен 1%-ын алады. Skill көп болса, сипаттамалар қысқарады да, Claude-ға сәйкестендіру үшін қажет кілт сөздер жоғалуы мүмкін.
• SKILL.md мазмұны: Anthropic мазмұнды 500 жолдан асырмауды ұсынады. Одан ұзын бөліктерді references/, scripts/ және examples/ файлдарына көшіріп, нұсқаулар арқылы жүктеңіз.

Контекст ықшамдалғаннан кейін (/compact), Claude бұрын іске қосылған әр skill-дің алғашқы 5000 токенін сақтайды; қайта тіркелетін барлық skills-тің жалпы бюджеті — 25 000 токен. Skill сыймаса, оның мінез-құлқы «ұмытылады».

Frontmatter толық схемасы

Ең аз дегенде name және description пайдаланыңыз. Өндірістік skills басқа өрістерді де қолданады:

disable-model-invocation: true өрісі автоматты түрде іске қосылмауы тиіс кез келген нәрсеге міндетті. Мысалы, осы жалаушасы бар deploy-to-prod skill-ін пайдаланушы /deploy-to-prod деп нақты тергенде ғана іске қосуға болады. Бұл жалауша болмаса, Claude «код дайын сияқты» деп ойлап, өндіріске шығарып жіберуі мүмкін.

Неге жұмыстың 90%-ы description-ға байланысты және оны қалай жазу керек?#

Vibe-coder-лердің ең жиі жіберетін қатесі — «X бойынша көмекші» деген сипаттама жазу. Skill бумасында тұрғанымен, Claude оны іске қоспайды.

Нашар сипаттама

description: Дашбордтар құрады.

Claude мыналарды ажырата алмайды: пайдаланушы «аптадағы сатылымды көрсет» десе, бұл дашбордқа қатысты ма? «Түсім графигін» сұраса, бұл дашборд па, әлде жай ғана график пе? «Айлық есеп» десе, оның дашбордқа қатысы жоқ екеніне сенімді бола аламыз ба?

Anthropic-тің өзінің skill-creator құралында бұл ұсыныс тікелей айтылған:

Жақсы сипаттама формуласы

Үш бөлік:

1. Не істейді — процесін емес, нәтижесін сипаттайтын бір сөйлем. «SQL жасайды» емес, «Telegram арнасына арналған сатылымдарды кестеге экспорттайды» деп жазыңыз.
2. Қашан іске қосу керек — пайдаланушылар шынымен айтатын тырнақшаға алынған 3-5 тіркес. Оларды болжаудың қажеті жоқ; чат пен қолдау қызметінің тарихына қараңыз.
3. Қашан іске ҚОСПАУ керек — skill жауап бермеуі тиіс ұқсас тапсырмаларға қатысты 1-2 тіркес. Бұл бөлім болмаса, ұқсас екі skill бір-бірімен қайшылыққа түсе береді.

Жобамдағы күшті сипаттаманың бір мысалы (ықшамдалып, анонимдендірілген):

description: |
  Редакциялық саясатты сақтап, блогқа SEO нұсқаулығын жазады және жариялайды.
  Триггерлер: "X тақырыбы туралы нұсқаулық жаз", "жаңа pillar жасайық",
  "Y туралы блог мақаласы", "Z туралы блог нұсқаулығын құрастыр".
  Сұрау email-хат тарату, Telegram жарияланымы немесе ішкі команда нұсқаулығы туралы болса,
  іске қоспа — бұлар басқа skills.

Мұнда жұмыс істейтіні:

• «көмектеседі» емес, «жазады және жариялайды» етістігі нақты нәтижені білдіреді.
• Тырнақшаға алынған төрт триггер тіркесі әртүрлі тұжырымдарды қамтиды.
• Ағылшын тіліндегі триггер де қосылған — пайдаланушы команда тілін ауыстырса да, skill жұмыс істейді.
• «Іске қоспа» деген жеке бөлім email және жарияланым skills-терімен қайшылықты болдырмайды.

Сипаттаманы қалай тексеруге болады

Anthropic өзінің skill-creator құралында триггерді бағалау әдісін енгізген: skill-дің іске қосылатынын тексеруге арналған 20 сұрау мәтіні. Олардың оны skill-ді іске қосуы, ал қалған онысы іске қоспауы керек (оның ішінде тұжырымы ұқсас, бірақ тапсырмасы басқаға жақын жағдайлар бар).

Vibe-coder тілінде бұл былай: сипаттаманы жазған соң, жаңа бос чат ашып, өзіңіз жиі қолданатын 5 тіркесті және мағынасы басқа болғанымен ұқсас естілетін 3 тіркесті байқап көріңіз. Skill қажет жерде іске қосылмаса немесе қажет емес жерде қосылса, сипаттаманы түзетіңіз. Содан кейін ғана нұсқаулар бөлігін жазыңыз.

Алдымен қай 5 skill-ді орнатар едім?#

Алғашқы екі аптада өз skills-іңізді жазу — ұтылыс стратегиясы. Алдымен дайындарын орнатып, қалай жасалғанын қараңыз; кейін сол тәсілмен өзіңіздікін қосыңыз. Басқалар сынақтан өткізген жинақтарды алып, өз қажетіңізге бейімдеу бәрін басынан жасағаннан арзанырақ. Мен мына бес жинақтан бастар едім:

1. anthropics/skills — skill-creator бар ресми жинақ

Репозиторий: github.com/anthropics/skills. GitHub-та 138,000 жұлдызы бар. Мұнда Anthropic командасының ресми skills-тері бар: skill-creator (басқа skills жазатын мета-skill), claude-api (API интеграцияларын жасауға көмектеседі) және PowerPoint, Excel, Word пен PDF құжаттарына арналған дайын skills.

Claude Code арқылы орнату:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Басты құндылығы — skill-creator. Ол сипаттамаңызға сүйеніп SKILL.md жазады, одан кейін 20 trigger-evals жүргізіп, skill қажетті жерде іске қосыла бастағанша сипаттаманы түзетеді. Негізінде, бұл — «skill жасайтын skill».

2. mattpocock/skills — TypeScript маманының кең тараған жинағы

Жинақта 12 белсенді skill бар, соның ішінде:

• grill-me — тапсырмаға қатысты белгісіздіктер жойылғанша, шешім қабылдау ағашы бойынша сұрақтар қояды. Vibe-coder-лердің ең үлкен түйткілі — «не қалайтынымды білмеймін» — алғашқы айналымда шешіледі.
• caveman — модельдің қарым-қатынасын телеграф стиліне дейін ықшамдайды.
• diagnose — қайта шығару - ықшамдау - болжам жасау - құралмен бақылау - түзету - регрессиялық сынақ циклін пайдаланып ақауларды жөндеу.
• tdd — red-green-refactor тәсілін міндеттейді: алдымен өтпейтін сынақ, содан кейін ең аз түзету, одан соң рефакторинг.
• to-issues — жоспарды тікелей толық стекпен қамтитын, жеке-жеке орналастыруға болатын GitHub мәселелеріне айналдырады.

Орнату:

npx skills@latest add mattpocock/skills
/setup-matt-pocock-skills

3. coreyhaines31/marketingskills — маркетологтарға арналған жинақ

Онлайн бағдарламалар жүргізсеңіз, фриланс-маркетолог болып жұмыс істесеңіз немесе агенттік басқарсаңыз, өз skills-іңізді жазуға алты ай жұмсаудың қажеті жоқ. Тапсырмалардың жартысы дайын жинаққа енгізілген.

4. vercel-labs/agent-skills — AI жасағандай көрінбейтін дизайн

Репозиторий: github.com/vercel-labs/agent-skills. Оның ең танымал skill-і — web-design-guidelines. Бұл skill UI кодын қолжетімділік, өнімділік және ыңғайлылыққа қатысты 100-ден астам ереже бойынша тексереді.

Сонымен қатар, Anthropic frontend-design skill-і де бар, ол аптасына 110,000-нан астам рет орнатылады. Код жазуды бастамас бұрын AI-ды стиль таңдауға мәжбүр етеді. Онсыз Claude жасайтын әр бетте Inter қарпі, күлгін градиент және торлы карточкалар болады. Нәтиже бәріне бірдей шығады.

5. obra/superpowers — көп агентті жұмыс үдерісі

Жалпы, тізімдегі алғашқы үшеуін — anthropics/skills, mattpocock/skills және coreyhaines31/marketingskills — орнатсаңыз, Claude Code-та алғашқы айда кәсіпкердің көптеген тапсырмасын қамтитын ондаған дайын skill болады.

Дайын skills-ті орнатып қана қоймай, Claude-ты нағыз көмекшіңізге айналдыратын баптау жасағыңыз келе ме? Skills — осы әдістеменің үш тірегінің бірі. Жұмыс істейтін баптау үш бөліктен тұрады: AI көшірмесі (тәжірибені жинақтаған Skills) + Second Brain (контекстке арналған білім құрылымы) + Контекст инженериясы (Claude жобаны тұтас қалай көретіні). Бұл баптау Claude-ты болжайтын көмекшіден сіздің логикаңызбен ойлайтын құралға айналдырады.

Қайталанатын қандай тапсырмаларды skill-ге айналдыру керек?#

Клиенттермен жұмыс істегенде және өзге адамдардың жобаларында бұл үлгіні ондаған рет көрдім. Біреу «әр жолы басынан жасайтын ісі» бар. Әр дүйсенбі сайын бірдей үлгідегі есеп жазады. Әр жаңа клиент келген сайын бір процедурадан өтеді. Әр жарияланым бір үлгімен жасалады. Қадамдарды еске түсіріп, тиісті файлдарды ашып, Claude-қа арналған сұрау мәтінін қайта құрастыруға тура келетіндіктен, бұған әр жолы 30-90 минут кетеді.

Шешімі — осыны бір рет skill-ге жинақтау. Содан кейін бір тіркес айтсаңыз болғаны, Claude әдістемені жүктеп, қажетті дереккөздерді оқып, нәтиже шығарады. Әртүрлі саладан үш мысал:

1-мысал. Фриланс маркетолог — weekly-content-plan skill-і

Қолмен не істейді: әр дүйсенбі сайын үш клиентке бір апталық Telegram жарияланымдарын дайындайды. Клиенттің бренд үні жөніндегі нұсқаулығын ашады, соңғы жарияланымдарды қарап шығады, өнім күнтізбесіне сүйеніп тақырыптар ойластырады да, ілмектер мен тармақтары бар кесте жасайды.

Skill түрінде бұл бес қадамдық нұсқауға айналады: клиенттің tone-of-voice файлын оқу, өнім күнтізбесін оқу, қайталанбас үшін соңғы 10 жарияланымды тексеру, түрлері бойынша (сатылымға бағытталған, сараптамалық, жеке) жеті тақырып ойлап табу және кесте шығару.

«X клиентке осы аптаға жарияланымдарды жоспарлайық» деген команда бір сағаттық дайындықты үш минут күтуге айналдырады. Маркетолог нәтижені тексеріп, нысаналы түзетулер енгізіп, клиентке жібереді.

2-мысал. Аутсорсингтегі бухгалтер — monthly-receipts-close skill-і (автор мысалы)

Қолмен не істейді: портфельдегі әр клиент бойынша ай сайын банк үзіндісін экспорттайды, оны бухгалтерлік жүйедегі төлемдермен салыстырады, санаты анықталмаған төлемдерді белгілейді, табыс туралы алдын ала есеп дайындайды және табыс құрылымын алдыңғы аймен салыстырады.

Skill — алты қадамдық нұсқау және банк үзінділерін талдайтын scripts/ бумасындағы бірнеше shell скрипті. «X клиент үшін мамыр айын жап» триггері Claude-қа аномалияларды белгілеп, 4-5 минутта есеп дайындауды тапсырады.

3-мысал. Онлайн бағдарлама авторы — welcome-letter-new-participant skill-і

Қолмен не істейді: жаңа қатысушы төлем жасады, енді оған қош келдіңіз хатын жазу керек. Жақсы хат жекелендірілген болады: қатысушының қай арнадан келгенін, қандай өнім сатып алғанын, қай топқа қосылғанын және онымен бірге қандай материалдар жіберу керегін ескереді. «Сәлеметсіз бе, қуаныштымыз» үлгісі мұны қамтымайды.

Skill Claude-қа knowledge/audience.md файлын (бұл адамдар кім), knowledge/products/<product>.md файлын (олар не алады) және қайталамау үшін соңғы үш қош келдіңіз хатын оқуды, одан кейін мына құрылыммен хат жазуды тапсырады: ілмек - өнімнің ерекшеліктері - алғашқы үш қадам - қоштасу.

Қолмен жасағаннан әлдеқайда жылдам. Сапасы біркелкі болады, өйткені Claude үш дереккөзді тексеруді ұмытпайды, ал асығыс адам біреуін өткізіп алуы мүмкін.

Skill-ге айналдыруға БОЛМАЙТЫН нәрселер

• Бір реттік тапсырмалар. Салық декларациясын тапсырғанда жылына бір рет жасасаңыз, Claude-қа чатта жай ғана түсіндіріңіз. Skill 3+ қайталаудан кейін ғана пайдасын өтейді.
• Тым жалпы тапсырмалар. «Маркетингке көмектес» — skill емес, бүкіл маркетинг саласы. Ал «апталық контент жоспары» — нақты нәтижесі бар нақты әрекет.
• Қайталанатын қадамдары жоқ тапсырмалар. Әр жолы үдеріс өзгеше болса, ол skill емес, бір реттік жұмыс.

Skill Creator сізге арналған skills-ті қалай жазады?#

Мәселе — бірден жақсы skill жазу қиын. Сипаттама тым тар не тым кең болып, пайдаланушылар шынымен қолданатын тіркестерді қамтымай қалуы немесе көршілес skill-мен қайшылыққа түсуі мүмкін. Anthropic бұл мәселені басқа skills жасай алатын мета-skill — skill-creator шығару арқылы шешті.

anthropics/skills орнатқан соң, Claude-қа /skill-creator деп айтыңыз (немесе «апталық есепке арналған skill жасайық» деңіз) де, алты кезеңдік жұмыс үдерісін орындаңыз:

1. Нобай жасау — skill-creator skill не істеуі керек, қандай триггер тіркестерін қолдану, қандай дереккөздерді оқу және қандай қадамдарды орындау керегін сұрайды. Нәтижесінде SKILL.md-дің алғашқы нұсқасы жасалады.
2. Сынау — skill-creator 20 сынақ сұрауын жасайды: skill-ді іске қосуы тиіс 10 сұрау және триггерге ұқсайтын, бірақ іске қоспауы тиіс 10 сұрау (жақын сәйкессіздіктер).
3. Бағалау — әр сұрауды жаңа чатта іске қосып, skill белсенген-белсенбегенін тексереді. Қажет емес жерде іске қосылса немесе қажет жерде іске қосылмаса, нәтижені белгілейді.
4. Қайталау — сәтсіздіктерге сүйеніп сипаттаманы қайта жазады да, сынақтарды қайта жүргізеді.
5. Оңтайландыру — соңғы өңдеу: 1024 таңбалық шектен аспағанын және жобаға орнатылған skills-пен қайшылық жоқтығын тексереді.
6. Жинақтау — соңғы SKILL.md мен анықтамалық файлдарды дұрыс құрылымға жинайды.

Іс жүзінде былай болады: Claude-пен 15-20 минут сөйлесіп, 7-8 нақтылау сұрағына жауап бересіз де, соңында қажетті триггерлерде іске қосылатын дайын, тексерілген skill аласыз.

Тағы бір пайдасы — skill-creator SKILL.md жазудың үлгілі стилін көрсетеді. Оның файлын ашып, қадамдардың пішімін, үнін және құрылымын көре аласыз. Бұл құрал өзін-өзі көрсететін жағдай: оны оқып, өз skill-іңізді қалай жазуды үйренесіз.

Skills, CLAUDE.md, Subagents, MCP, Hooks: қайсысын қолдану керек?#

Мен қарап шыққан жобалардағы ең жиі мәселе — CLAUDE.md ішінде жоба ережелері, жариялаудың қадамдық нұсқаулығы, commit үлгісі және дерекқор сипаттамасы араласып жүреді. Бұл контексті шамадан тыс толтырады әрі іс жүзінде де көмектеспейді: модель CLAUDE.md мәтінінің бәрін жалпы контекст деп қабылдап, нақты триггер көрмегендіктен, пайдаланушы жариялауды сұрағанда нұсқауды орындамайды.

Шешімі — әр элементті тиісті құралға орналастыру:

Skills пен MCP жұмыс үдерістерінің көбін қамтиды; Hooks код тексеру, сынақ және қорғаныс ережелері сияқты күнделікті әрекеттерді автоматтандырады. Контекст ауыр болғанда Subagents керек. Ең жиі қате — skill қолдану керек жерде subagent жасау.

Шешім қабылдау ағашы

«Claude-қа X істетуім керек» деп ойлағанда:

1. Бұл білім үнемі қажет пе? Мысалы, «жобаның белгіленген тілі бар» немесе «em-dash қолданбаймыз». → Оны CLAUDE.md ішіне жазыңыз.
2. Бұл қазір қолмен жасайтын, триггермен іске қосылатын процедура ма? Мысалы, «әр дүйсенбі сайын есеп жазамын». → Skill жасаңыз.
3. Сыртқы жүйеге қатынау керек пе? Мысалы, Stripe API немесе CRM. → MCP server қосыңыз.
4. Claude Code оқиғаға автоматты жауап беруі керек пе? Мысалы, әр Edit-тен кейін linter жүргізу. → Hook жазыңыз.
5. Тапсырма ауыр ма, бүкіл контексті жұмсай ма және қатар басқа іспен айналысу керек пе? → Оны subagent ішінде орындаңыз.

Кәсіпкер-vibe-coder тапсырмаларының 90%-ы 1-3 санатқа жатады. Hooks пен subagents — «бір уақытта бір тапсырмадан» асып кеткен кезде қолданылатын келесі деңгей құралдары.

Slash commands пен Skills — бір нәрсе

Claude Code-тағы маңызды өзгеріс: ескі slash-command жүйесі (.claude/commands/) мен skills іс жүзінде біріктірілген. .claude/commands/deploy.md және .claude/skills/deploy/SKILL.md файлдарының екеуі де /deploy командасын жасайды. Атаулары бірдей болса, skill басым болады. Сондықтан әлі ескі slash-command пішімін қолданып жүрсеңіз, skills-ке көшіңіз: синтаксисі түсініктірек, мүмкіндіктері де көбірек.

Skill-дің жұмыс істеуіне кедергі болатын 7 қате#

1. Триггерлері жоқ сипаттама: skill іске қосылмайды

Белгісі: skill жазып, құрылымын тексердіңіз, бәрі дұрыс, бірақ Claude оны пайдаланушы сұрауларына қоспайды. Себебі көбіне біреу: «Контент жазуға көмекші» деген сипаттама. Claude қандай тіркестерге жауап беру керегін білмейді. Шешімі: пайдаланушылар шынымен айтатын 3-5 тіркесті тырнақшаға алып, сипаттаманың өзіне енгізіңіз.

2. 500 жолдан асатын SKILL.md: зейін шашырайды

Anthropic файл мазмұнын 500 жолдан асырмауды тікелей ұсынады. Нұсқауларыңыз 2,000 жол болса, Claude зейінін жоғалтып, қадамдардың кейбірін ғана орындайды және ретін шатастырады. Шешімі: үлкен бөлімдерді examples/, references/, scripts/ сияқты жақын файлдарға көшіріп, оларды SKILL.md ішінен атаңыз.

3. Үш шағын skill орнына «контент туралы бәріне» арналған бір skill

Азғыратын нұсқа — Telegram жарияланымдары, лендингтер мен email-дің бәрін қамтитын үлкен content skill жасау. Бұл жұмыс істемейді. Skill қате сұрауларда іске қосылып, әдістемелерді шатастырып, орташа нәтиже береді. Шешімі: бір skill — бір қайталанатын әрекет. Егер «контентке» қатысты үш тұрақты жұмысыңыз болса, үш skill жасаңыз: telegram-post, landing-section, email-broadcast.

4. «Қашан ҚОЛДАНБАУ керек» бөлімі жоқ skill: қайшылықтар

Белгісі: жобада бір-біріне ұқсас екі skill бар, Claude қате біреуін іске қосады. Мысалы, бірі email-хат таратуға, екіншісі бағдарлама қатысушыларына арналған қош келдіңіз хаттарына арналған. «Сұрау жалпы тарату тізімі туралы болса, іске қоспа» деген нақты шарт болмаса, қош келдіңіз хаттарының skill-і «email» аталған кез келген сұрауда іске қосылады. Шешімі: сипаттамада теріс жағдайларды нақты көрсетіңіз.

5. Жобада 50 skill: сипаттамалар қысқарады

Claude Code құжаттамасынан:

Маркетплейстен 50 skills жинағын жүктесеңіз, кейбір сипаттамалар қысқарады. Сіз үміт артқан кілт сөздер жоғалуы мүмкін. Шешімі: белсенді жобада ең пайдалы 10-15 skill-ді қалдырыңыз. Қалғанын дағдылар табылатын барлық қалтадан тыс белсенді емес мұрағатта, мысалы өз материалдарыңыздағы бөлек skill-archive/ қалтасында сақтаңыз. Қажет дағдыларды ғана жоба не жеке ауқымға орнатыңыз. ~/.claude/skills/ — жобалар арасында көрінетін орнатылған жеке кітапхана, сондықтан дағдыларды сонда көшіру оларды табудан алып тастамайды.

6. Тексерілмеген дереккөздерден алынған skills: қауіпсіздік қатері

Anthropic бұл туралы ресми құжаттамасында ескертеді:

Кездейсоқ GitHub репозиторийінде алғашқы іске қосқанда API кілттеріңізді сыртқа жіберетін skill болуы мүмкін. Шешімі: орнатпас бұрын SKILL.md файлын ашып, өзіңіз оқыңыз. Маңызды жобаларда бейтаныс авторлардың skills-ін іске қоспаңыз.

7. Білім бумасы жоқ skill «орташа ChatGPT» нәтижесін береді

Ең нәзік әрі жиі кездесетін қате тәсіл. Skill әдістемені береді, бірақ контекст болмаса, әдістеменің өзі ештеңе білдірмейді. «Қош келдіңіз хатын жаз» skill-ін жасасаңыз, бірақ жобада аудиторияны сипаттайтын файл да, бренд үні туралы файл да болмаса, Claude ешкімнің жұмысынан айырмашылығы жоқ орташа ChatGPT имейлін жазады.

Skill жобаға арналған Second Brain жүйесін CLAUDE.md туралы нұсқаулықтағы қағидалармен алдын ала құрғанда ғана барынша жақсы жұмыс істейді. Әуелі білім құрылымын жасап, содан кейін соған сүйенетін skills құрыңыз. Ретін керісінше өзгертсеңіз, стиліңізге бейімделген жұмыстың орнына бірсарынды, орташа сапаға ие боласыз.

Алғашқы skill-ді 30 минутта қалай жасауға болады#

Міне, жобаларымда алғашқы skills-ті жасау үшін қолданған нақты жоспар:

1-қадам. Қайталанатын бір әрекетті таңдаңыз

Өткен айдағы күнтізбеңізді ашыңыз. Әр жолы 30-60 минут кететін және кемінде 4-5 рет жасаған тапсырманы табыңыз. Жалпы «маркетинг» емес, нақты нәрсе болсын: «дүйсенбілік сатылым есебі», «жаңа клиентті тіркеу» немесе «науқанға арналған прайс-парақты жаңарту».

Тұжырым неғұрлым нақты болса, skill соғұрлым қарапайым, ал триггер соғұрлым дәл болады.

2-қадам. Үдерісті қолмен жазып шығыңыз

Бөлек файлға немесе Claude-пен чатқа (skill үшін емес, нобай ретінде) орындайтын қадамдарыңызды жазыңыз:

1. Клиенттер дерекқорын ашу
2. "қош келдіңіз хат күтіп тұр" мәртебесі бойынша сүзу
3. Клиенттің қай арнадан келгенін тексеру
4. Сол арнаға арналған email үлгісін "templates" бумасынан алу
5. Атын, өнімді және басталу күнін енгізу
6. Жіберу

Бұл әлі skill емес, жай жазбалар. Бірақ олар болмаса, SKILL.md жазуды басынан шатастырасыз.

3-қадам. Бума құрылымын жасаңыз

mkdir -p .claude/skills/welcome-email-new-client
touch .claude/skills/welcome-email-new-client/SKILL.md

Немесе skill-ді барлық жобаларыңызда пайдаланғыңыз келсе, оны ~/.claude/skills/ ішіне орналастырыңыз.

4-қадам. Үлгі бойынша SKILL.md жазыңыз

Қаңқасы:

---
name: welcome-email-new-client
description: |
  Жаңа клиентке келген арнасына сай үлгіні пайдаланып қош келдіңіз хатын дайындайды.
  Триггерлер: "жаңа X клиентіне қош келдіңіз хатын жаз",
  "жаңа Y қатысушысын тірке", "Z арнасынан келген клиентке қош келдіңіз хаты".
  Сұрау жалпы тарату тізімі немесе email науқаны туралы болса,
  іске қоспа — бұл басқа skills.
---

# Жаңа клиентке арналған қош келдіңіз хаты

## Қадамдар

1. `knowledge/audience/segments.md` файлын оқы - клиент сегменттері қандай
2. `knowledge/templates/welcome/` бумасын оқы - арналар бойынша үлгілер
3. Сұрау мәтінінің контекстінен клиент келген арнаны анықта
4. Клиенттің атын, өнім атауын және басталу күнін енгіз
5. Ұзындығын тексер — 800 таңбадан аспауға тиіс
6. Дайын хат мәтінін көшіруге ыңғайлы пішімде шығар

## Маңызды

- «Құрметті досым» немесе «сәлем» деп жазба — табиғи тіл қолданып жаз
- Бір абзац — бір ой
- Екі емес, бір әрекетке шақырумен аяқта

5-қадам. 5-8 сұрау мәтінімен тексеріңіз

Осы жобада Claude Code-пен бос чат ашыңыз. Өзіңіз шынымен қолданатын 5 тіркесті және іске қосылмауы тиіс, бірақ ұқсас 3 тіркесті байқап көріңіз:

Іске қосылуы тиіс:

• «Жаңа Иванов клиентіне қош келдіңіз хатын жаз»
• «X бағдарламасын сатып алған жаңа қатысушыны тірке»
• «Instagram арнасынан келген клиентке қош келдіңіз хаты»

Іске қосылмауы тиіс:

• «Тізімдегі бәріне науқан хатын жібер»
• «Жаңа жыл мерекесіне арналған email науқаны»
• «Төлем жасамаған клиентке кейінгі хат жаз»

Әр тіркес үшін skill іске қосылған-қосылмағанын тексеріңіз. Қате жағдайларда іске қосылса, сипаттаманы тарылтыңыз. Қажет жерде іске қосылмаса, триггер тіркестерін кеңейтіңіз.

6-қадам. Сипаттаманы жетілдіріңіз

Әр сәтсіз сынақтан кейін тек сипаттаманы өзгертіңіз — нұсқаулар бөлігін қозғамаңыз. 2-3 қайталаудан кейін skill сенімді іске қосыла бастайды. Сақтап, commit жасап, күнделікті пайдаланыңыз.

Соңғы кеңес: алғашқы skill-іңізді мінсіз етуге тырыспаңыз. Жұмыс істесін. Бесінші не оныншы skill-ден кейін ғана әсемдеп өңдеңіз: сол кезде тіркестеріңіз бен Claude жауаптарынан үлгілерді байқай бастайсыз.

Осы аптада күнтізбеңізден қайталанатын бір тапсырманы таңдап, 30 минут бөліңіз де, жоғарыдағы алты қадамды орындаңыз. Сонда Claude болжам жасаудың орнына сіздің әдістемеңізге сай жұмыс істейді.

Жұмыс істейтін баптау — AI көшірмесі + Second Brain + Контекст инженериясы. Бір әдістеменің үш бөлігі.

Ailoot арқылы AI модельдеріне қатынау қажет болса, Ailoot сайтын қараңыз.