Claude Skills: өз дағдыңызды нөлден қалай құруға болады

Тексерілді және жаңартылды: 2026 жылғы 4 шілде. Техникалық деректер сыртқы блогтармен емес, Anthropic мен Claude Code-тың ресми құжаттамасымен салыстырылды. Claude Code нұсқалары арасындағы айырмашылықтар мәтінде тікелей белгіленген.

Claude Skills — қайталанатын процедураны немесе білім жиынтығын SKILL.md файлында бір рет сипаттап, оны Claude Code автоматты түрде немесе сіздің пәрменіңіз бойынша қосатын тәсіл; сол арқылы бірдей нұсқаулықты әр чатқа қайта көшірудің қажеті болмайды. Бұл нұсқаулықта сіз бүкіл жолдан өтесіз: орнатылған Claude Code-ты тексеруден бастап, өз дағдыңызды құру, тестілеу, түзету және қауіпсіз тапсыруға дейін. Өтпелі мысал ретінде біз практикалық SEO Content Audit дағдысын жинаймыз — ол мақала жобасын SEO-тізім бойынша тексереді.

Нұсқаулық Claude Code-ты кемінде базалық деңгейде пайдаланатын және терминалда жұмыс істей алатын оқырманға арналған. Терең бағдарламалау қажет емес: дағды — бұл ішінде мәтіндік файлы бар қалта. Бүкіл процесс 13 қадамнан тұрады, әрқайсысында пәрмен, күтілетін нәтиже, әдеттегі қате және тексеру тәсілі берілген.

Осы нұсқаулықта нені жасайсыз

• seo-content-audit/ дағды каталогы;
• дұрыс YAML frontmatter және жұмыс істейтін нұсқаулығы бар SKILL.md файлы;
• references/ ішіндегі анықтамалық файлдар (SEO-тізім және жазу ережелері);
• templates/ ішіндегі есеп үлгісі;
• қалауыңыз бойынша — scripts/ ішіндегі қосымша валидатор скрипт;
• қолмен (/seo-content-audit) де, сұраныс мәні бойынша автоматты түрде де іске қосылатын жұмыс дағдысы.

Мазмұны

• Claude Skills: бұл не және қалай жұмыс істейді
• Claude Skills, CLAUDE.md, slash-пәрмендер және MCP: айырмашылығы неде
• Бастамас бұрын не қажет
• Claude Skills: алғашқы дағдыны қадамдап құру
• SKILL.md файлының құрылымы
• Claude Skill қалтасының құрылымы
• Claude Skills: практикалық мысалдар
• Claude Skills дағдыларын тестілеу
• Claude Skills: жиі кездесетін қателер мен шешімдер
• Claude Skills қауіпсіздігі
• Claude Skills бойынша үздік тәжірибелер
• Claude Skills: жиі қойылатын сұрақтарға жауаптар
• Claude Skills: қорытынды және келесі қадам
• Ресми дереккөздер

Claude Skills: бұл не және қалай жұмыс істейді

Claude Skills (Anthropic құжаттамасында — Agent Skills) — Claude-қа жаңа процедуралар мен білім қосатын модульдік кеңейтімдер. Техникалық тұрғыдан дағды дегеніміз — ішінде міндетті түрде SKILL.md файлы бар каталог. Бұл файл екі бөліктен тұрады: --- жолдары арасындағы YAML frontmatter (метадеректер — ең алдымен атау мен сипаттама) және дағды белсенді болғанда Claude орындайтын Markdown-нұсқаулық.

Дағдыны үш жағдайда құру орынды: бір нұсқаулықты немесе тексеру тізімін чатқа қайта-қайта қоясыз; көп қадамды процедураңыз бар (деплой, ревью, мақала дайындау); немесе CLAUDE.md файлыңыздағы бөлім «жоба туралы фактіден» «қадамдық процедураға» айналды. CLAUDE.md-тен айырмашылығы — дағдының денесі шынымен қажет болғанда ғана жүктеледі, сондықтан ұзын анықтамалықтар оларға жүгінбейінше контекст бойынша дерлік ештеңеге тұрмайды.

Контексттің прогрессивті ашылу принципі (progressive disclosure) — Claude Skills-тің негізгі идеясы. Ол былай жұмыс істейді:

1. Сессия басталғанда жүйелік промптқа әр дағдының тек name және description өрістері түседі — бұл токендер бойынша арзан.
2. SKILL.md-тың толық денесі дағды іске қосылғанда ғана жүктеледі (сипаттама бойынша немесе қолмен шақыру арқылы).
3. Қосымша файлдар (references/, templates/) одан кейін ғана оқылады — тек нұсқаулық оларға сілтесе.
4. scripts/ ішіндегі скриптер контекстке мүлде жүктелмейді: Claude оларды орындайды, ал контекстке тек нәтиже ғана түседі.

Дағдыны қосу екі түрлі болады. Автоматты — Claude description өрісіне сүйене отырып, дағдыны қолдануды өзі шешеді; сондықтан сипаттама дағдының не істейтінін және оны қашан қолдану керегін дәл атауы тиіс. Қолмен — сіз /дағды-атауы деп жазасыз, кәдімгі пәрмен сияқты.

Кәдімгі промптан айырмашылығы: промпт бір хабарлама ғана өмір сүреді және қайта пайдаланылмайды — дағды барлық сессиялар мен жобаларда қайта пайдаланылады (сақталу орнына байланысты). Жобаның тұрақты нұсқаулықтарынан (CLAUDE.md) айырмашылығы: CLAUDE.md ішіндегі фактілер әрқашан контексте, ал дағды сұраныс бойынша қосылады.

Артықшылықтары: қайта пайдалану, прогрессивті ашылу есебінен контекстті үнемдеу, біркелкі нәтиже, скриптер мен анықтамалықтарды қоса алу мүмкіндігі, git немесе плагиндер арқылы оңай тарату.

Шектеулері: белсендірілгеннен кейін SKILL.md денесі сессия соңына дейін контексте қалады (әр жол — қайталанатын токен құны), сондықтан құжаттама денені 500 жолға дейін ұстауды ұсынады; дағды көп болғанда сипаттамалар листинг бюджетінде қысқаруы мүмкін (модель контекст терезесінің шамамен 1%-ы).

Claude Skills, CLAUDE.md, slash-пәрмендер және MCP: айырмашылығы неде

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

Claude Skills-ті қашан таңдаймыз, ал CLAUDE.md немесе MCP-ні қашан

Қарапайым ереже. Claude жоба туралы фактіні (стек, атау келісімдері) әрқашан есте сақтауы керек болса — бұл CLAUDE.md. Сыртқы дерек көзін немесе сервисті (дерекқор, тапсырма трекері, API) қосу керек болса — бұл MCP. Көп қадамды процедураны немесе көлемді анықтамалықты сұраныс бойынша қайта пайдалану керек болса — бұл Claude Skills. Бұл механизмдер бірін-бірі толықтырады: дағды MCP-құралдарына сілтеп, CLAUDE.md фактілеріне сүйене алады.

Бастамас бұрын не қажет

Claude Code-тағы Claude Skills macOS, Linux және Windows жүйелерінде жұмыс істейді. Қажет болады: терминал, орнатылған әрі авторизацияланған Claude Code, кез келген код редакторы және бөлек тестілеу қалтасы. Барлығын кезекпен тексерейік — әр пәрменді бөлек блокпен көрсетемін.

Claude Code нұсқасын тексеру.

claude --version

Не істейді: орнатылған нұсқаны басып шығарады. Күтілетін нәтиже — 2.1.x түріндегі жол. Бұл маңызды, себебі кейбір мүмкіндіктер нұсқаға байланысты: /run мен /verify — v2.1.145+, ${CLAUDE_PROJECT_DIR} алмастыруы — v2.1.196+, бір хабарламадағы бірнеше дағды «стегі» — v2.1.199+ қажет етеді. command not found қатесі шықса, Claude Code орнатылмаған — келесі пәрменді қараңыз.

Claude Code-ты орнату немесе жаңарту (қажет болса).

npm install -g @anthropic-ai/claude-code

Не істейді: CLI-ды npm арқылы жаһандық орнатады (немесе жаңартады). Күтілетін нәтиже — сәтті орнату және жұмыс істейтін claude пәрмені. Node.js/npm болмаса немесе нативті орнатқышты пайдалансаңыз, ресми құжаттаманың ағымдағы орнату бетін тексеріңіз — орнату тәсілі ОЖ-ге қарай өзгешеленуі мүмкін.

Іске қосу және авторизация.

claude

Не істейді: ағымдағы қалтада Claude Code-тың интерактивті сессиясын іске қосады. Алғаш іске қосқанда авторизациядан өткізеді. Күтілетін нәтиже — чат шақыруы. Авторизация қатесі болса, терминалдағы нұсқау бойынша қайта кіріңіз.

Конфигурация диагностикасы.

/doctor

Не істейді: сессия ішінде конфигурация күйін көрсетеді, соның ішінде листинг бюджеті салдарынан қанша дағды сипаттамасы қысқарғанын немесе алынып тасталғанын. Дағды Claude-қа «көрінбегенде» пайдалы.

Дағдылар каталогына құқықты тексеру. Жеке дағдылар ~/.claude/skills/ ішінде жатады. Каталог жазуға қолжетімді екеніне көз жеткізіңіз:

mkdir -p ~/.claude/skills

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

Claude Skills: алғашқы дағдыны қадамдап құру

Бұл — негізгі бөлім. Біз seo-content-audit дағдысын жинаймыз. Әр қадам бірдей құрылған: мақсат → әрекет → пәрмен/жол → скриншот → күтілетін нәтиже → ықтимал қате → тексеру → бұл не үшін қажет.

1-қадам. Claude Code-ты тексеру

Мақсаты: CLI орнатылғанына және оның нұсқасы қажет мүмкіндіктерді қолдайтынына көз жеткізу.

claude --version

Күтілетін нәтиже: 2.1.x немесе жаңарақ нұсқа нөмірі. Ықтимал қате: command not found — «Не қажет» бөліміне оралыңыз. Тексеру: пәрменді қайта іске қосқанда нөмір шығады. Не үшін: келесі қадамдар дағдылардың өзекті жолдары мен әрекетіне сүйенеді.

2-қадам. Қауіпсіз тестілеу жобасын құру

Мақсаты: нақты жобада емес, бейтарап құм жәшігінде жұмыс істеу.

mkdir -p ~/projects/claude-skills-demo

Жол: ~/projects/claude-skills-demo. Күтілетін нәтиже: бос қалта құрылды. Ықтимал қате: ~/projects-ке жазу құқығы жоқ — басқа каталог таңдаңыз. Тексеру: ls ~/projects тізімінде claude-skills-demo көрінеді. Не үшін: демонстрациялық деректер (demo-project, example.com) нақты жобалармен және дербес деректермен араласпауы тиіс.

3-қадам. Дағды каталогын құру

Мақсаты: дағды каталогын жеке қоймада (барлық жобаларда қолжетімді) құру.

mkdir -p ~/.claude/skills/seo-content-audit

Күтілетін нәтиже: ~/.claude/skills/seo-content-audit каталогы пайда болды. Ықтимал қате: атаудағы қате — тек кіші әріптер, сандар және сызықшаларды қолданыңыз. Тексеру: ls ~/.claude/skills тізімінде seo-content-audit көрінеді. Не үшін: каталог атауы дағды пәрменіне айналады — /seo-content-audit.

4-қадам. SKILL.md файлын құру

Мақсаты: дағдының кіру нүктесін құру.

touch ~/.claude/skills/seo-content-audit/SKILL.md

Файлға қойылатын талаптар: атауы қатаң түрде SKILL.md (регистрді ескере отырып), дағды каталогының түбірінде орналасады. Күтілетін нәтиже: бос SKILL.md құрылды. Ықтимал қате: skill.md немесе Skill.md атауы танылмайды — қайта атаңыз. Тексеру: ls ~/.claude/skills/seo-content-audit тізімінде SKILL.md көрінеді. Не үшін: бұл файлсыз каталог дағды болып саналмайды.

5-қадам. Frontmatter толтыру

Мақсаты: Claude дағдыны табатын және қосатын метадеректерді орнату.

Ашық Agent Skills стандарты бойынша frontmatter екі өрісті — name мен description-ті талап етеді. Claude Code-та барлық өрістер міндетті емес, бірақ description қатты ұсынылады. Төменде — біздің дағдымызға арналған ең қарапайым дұрыс frontmatter:

---
name: seo-content-audit
description: Audits a draft article for on-page SEO. Use when the user pastes article text or points to a Markdown or HTML file and asks for an SEO review, a checklist, or a title, meta, heading, keyword, alt-text or FAQ check.
allowed-tools: Read Grep
---

Қолдау көрсетілетін өрістерді қарастырайық (жоқ өрістерді ойлап таппаймыз):

Күтілетін нәтиже: frontmatter жарамды. Ықтимал қате: бұзылған YAML — сонда Claude Code дағды денесін бос метадеректермен жүктейді (/атау жұмыс істейді, бірақ автоқосу болмайды). Тексеру: талдау қатесін көру үшін Claude-ты --debug жалаушасымен іске қосыңыз. Не үшін: дәл description Claude-тың дағды қашан қажет екенін түсінетінін анықтайды.

6-қадам. Дағды нұсқаулығын жазу

Мақсаты: дағды белсендірілгеннен кейін Claude орындайтын денені жазу. Қысқа тұжырымдаңыз: дене бүкіл сессия контексте қалады.

Нашар нұсқа (анық емес, құрылымсыз):

Мәтінді тексеріп, SEO тұрғысынан жақсы ма екенін айт. Кеңес бер.

Жақсы нұсқа (анық процедура және тексерілетін нәтиже):

# SEO Content Audit

Audit the article the user provides (pasted text or a file path). Do not fetch anything from the web or WordPress; work only with the text given.

## Steps
1. Read the article. If a file path is given, read that file.
2. Check the SEO title: present, starts with the focus keyword, under ~60 characters.
3. Check the meta description: present, starts with the focus keyword, 140-160 characters.
4. Check headings: exactly one H1; logical H2/H3 order; no skipped levels.
5. Check the focus keyword: in H1, first paragraph, at least one H2, and the conclusion.
6. Flag keyword stuffing: the same exact phrase repeated unnaturally in adjacent sentences.
7. Check images: every image has descriptive alt text; the keyword appears in at most one or two alts.
8. Suggest 2-3 internal links with anchor text.
9. Check that a visible FAQ section exists if FAQ schema is claimed.
10. Output the final report using templates/audit-report.md.

## Rules
- See references/seo-checklist.md for the full checklist.
- See references/writing-rules.md for tone and keyword-density limits.
- Never invent metrics you cannot verify from the text.

Күтілетін нәтиже: тексерілетін шығысы бар қайталанатын нұсқаулық. Ықтимал қате: бұлыңғыр тұжырымдар → Claude «жүзеді». Тексеру: дағдыны тестілік мақалада жүргізіп, есепті салыстырыңыз. Не үшін: нақтылық нақтылаушы хабарламалар санын азайтады.

7-қадам. Автоқосу үшін дәл сипаттама

Мақсаты: description-ті дағды қажетті сұраныстарда қосылатындай, ал бөгде сұраныстарда үндемейтіндей ету. Сипаттама үшінші жақта жазылады және «не істейді» мен «қашан қолдану керек» дегеннің екеуін де қамтиды — адамдар шынымен айтатын кілт сөздермен: «SEO-тексеру», «SEO checklist», «title мен meta тексер», «alt-мәтіндер», «FAQ». Мысал 5-қадамдағы description-ке салынған.

Тексеру: Claude-тан «What skills are available?» деп сұраңыз — дағды тізімде түсінікті сипаттамамен көрінуі тиіс.

8-қадам. Дағдыны қолмен іске қосу

Мақсаты: дағдының пәрмен бойынша іске қосылатынына көз жеткізу.

/seo-content-audit

Аргумент беруге болады — мысалы, жоба файлына жол:

/seo-content-audit drafts/example-article.md

Күтілетін нәтиже: Claude процедураны орындап, есеп береді. Ықтимал қате: пәрмен / мәзірінде көрінбейді — каталог атауы мен frontmatter жарамдылығын тексеріңіз. Тексеру: есеп үлгіге сәйкес келеді. Не үшін: қолмен шақыру — іске қосудың ең болжамды тәсілі.

9-қадам. Автоматты қосылуды тексеру

Мақсаты: сұраныс мәні бойынша автоқосуды тексеру.

Оң тест (іске қосылуы тиіс):

Мынау мақала жобасы, SEO-аудит жаса: title, meta, тақырыптар және alt-мәтіндерді тексер.

Теріс тест (іске қосылмауы тиіс):

Осы жобадағы тәуелділіктерді қайта орнатуға көмектес.

Күтілетін нәтиже: бірінші сұранысқа дағды қосылады, екіншісіне — жоқ. Ықтимал қате: тым жиі қосылады → description-ті тарылтыңыз; қосылмайды → кілт фразаларды қосыңыз. Тексеру: түзетуден кейін екі тестті қайталаңыз. Не үшін: автоқосу — дағды құндылығының жартысы.

10-қадам. Қосымша файлдарды қосу

Мақсаты: көлемді анықтамалық пен үлгіні SKILL.md-тен бөліп шығару, сонда дене қысқа қалады.

mkdir -p ~/.claude/skills/seo-content-audit/references ~/.claude/skills/seo-content-audit/templates ~/.claude/skills/seo-content-audit/scripts

references/seo-checklist.md мысалы (анықтамалық, сұраныс бойынша оқылады):

# SEO checklist

## Title and meta
- SEO title present and starts with the focus keyword
- SEO title under ~60 characters
- Meta description 140-160 characters, starts with the focus keyword

## Headings
- Exactly one H1
- H2/H3 in logical order, no skipped levels
- Focus keyword in H1, first paragraph, one H2, and the conclusion

## Keywords
- No unnatural repetition of the exact phrase in adjacent sentences
- Natural synonyms and related terms present

## Media and links
- Every image has descriptive alt text
- Focus keyword in at most one or two alt texts
- 2-3 relevant internal links with descriptive anchors

## FAQ
- Visible FAQ section exists if FAQ schema is used

templates/audit-report.md мысалы (қорытынды есеп үлгісі):

# SEO Content Audit — Report

**Article:** {{title}}
**Focus keyword:** {{keyword}}
**Date:** {{date}}

## Summary
{{one_paragraph_verdict}}

## Findings
| Check | Status | Note |
|---|---|---|
| SEO title | pass/fail | ... |
| Meta description | pass/fail | ... |
| Single H1 | pass/fail | ... |
| Keyword placement | pass/fail | ... |
| Keyword stuffing | pass/fail | ... |
| Image alt texts | pass/fail | ... |
| Internal links | pass/fail | ... |
| FAQ present | pass/fail | ... |

## Recommended internal links
- {{anchor}} -> {{target}}

## Action items
1. ...
2. ...

Қосымша scripts/validate.py скриптінің мысалы (контекстке жүктелмей, орындалады; тек стандартты кітапхананы қолданады):

#!/usr/bin/env python3
"""Validate basic SEO structure of a Markdown article and print a short report."""

import re
import sys
from pathlib import Path


def audit(text: str) -> list[str]:
    issues = []
    h1_count = len(re.findall(r"^# .+", text, flags=re.MULTILINE))
    if h1_count != 1:
        issues.append(f"Expected exactly one H1, found {h1_count}")

    images = re.findall(r"![(.*?)](.*?)", text)
    empty_alts = sum(1 for alt in images if not alt.strip())
    if empty_alts:
        issues.append(f"{empty_alts} image(s) missing alt text")

    return issues


def main() -> int:
    if len(sys.argv) != 2:
        print("Usage: validate.py <article.md>")
        return 2

    path = Path(sys.argv[1])
    if not path.exists():
        print(f"File not found: {path}")
        return 1

    problems = audit(path.read_text(encoding="utf-8"))
    if not problems:
        print("OK: no structural SEO issues found")
        return 0

    print("Issues found:")
    for item in problems:
        print(f"- {item}")
    return 1


if __name__ == "__main__":
    raise SystemExit(main())

Назар аударыңыз: references/ + templates/ + scripts/ құрылымы ресми қолдау көрсетілетін тәсілге сәйкес келеді — қосымша файлдар SKILL.md-пен қатар жатады, ал нұсқаулық оларға сілтейді. Тексеру: дағдыдан тізімді ескеруді сұраңыз — Claude references/seo-checklist.md-ті тек қажет болғанда оқуы тиіс. Не үшін: осылайша SKILL.md денесі қысқа қалады, ал анықтамалық қажет болмайынша контекстті шығындамайды.

11-қадам. Нәтижені тестілеу

Мақсаты: дағдыны сценарийлер матрицасы бойынша жүргізу (толық кесте — «Тестілеу» бөлімінде). Ең кемі: тікелей сұраныс, жанама сұраныс, қатысы жоқ сұраныс, әдейі қателермен мақала. Тексеру: есеп үлгі құрылымын тұрақты қайталайды. Не үшін: қосылу ≠ дұрыс нәтиже; бұл екі бөлек тексеру.

12-қадам. Қателерді түзету

Мақсаты: типтік ақауларды диагностикалау және түзету. Процесс: қайталау → локализациялау (frontmatter ма? жол ма? сипаттама ма?) → түзету енгізу → қайта тексеру. Тірі жаңарту: ~/.claude/skills/ ішіндегі түзетулер ағымдағы сессияда қайта іске қосусыз қабылданады; жаңа жоғарғы деңгейлі каталог құру қайта іске қосуды талап етеді. Толық талдау — «Жиі кездесетін қателер» бөлімінде.

13-қадам. Дағдыны басқа пайдаланушыға тапсыру

Мақсаты: дағдыны қауіпсіз бөлісу. Үш арна (құжаттама бойынша): жоба дағдылары — .claude/skills/-ті репозиторийге коммит ету; плагиндер — дағдыны плагиннің skills/ каталогына салу; ұйымдық — managed-параметрлер арқылы тарату. Тапсырар алдында дағдыда құпиялар, нақты жолдар және дербес деректер жоқ екеніне, ал алушы жоба дағдысындағы allowed-tools тек каталогқа сенім диалогын қабылдағаннан кейін белсенетінін түсінетініне көз жеткізіңіз.

SKILL.md файлының құрылымы

Барлығын біріктірейік. SEO Content Audit дағдысының толық жұмыс істейтін SKILL.md-і — «Hello World» емес, практикалық мысал:

---
name: seo-content-audit
description: Audits a draft article for on-page SEO. Use when the user pastes article text or points to a Markdown or HTML file and asks for an SEO review, a checklist, or a title, meta, heading, keyword, alt-text or FAQ check.
argument-hint: [path-to-article]
allowed-tools: Read Grep
---

# SEO Content Audit

Audit the article the user provides (pasted text or a file path in $ARGUMENTS). Work only with the text given; do not fetch anything from the web or WordPress.

## Steps
1. Read the article. If a path is given, read that file.
2. SEO title: present, starts with the focus keyword, under ~60 characters.
3. Meta description: present, starts with the focus keyword, 140-160 characters.
4. Headings: exactly one H1; logical H2/H3 order; no skipped levels.
5. Focus keyword: in H1, first paragraph, at least one H2, and the conclusion.
6. Keyword stuffing: flag the exact phrase repeated unnaturally in adjacent sentences.
7. Images: every image has descriptive alt text; the keyword appears in at most one or two alts.
8. Internal links: suggest 2-3 with descriptive anchor text.
9. FAQ: confirm a visible FAQ section exists if FAQ schema is used.
10. Output the report using templates/audit-report.md.

## Resources
- Full checklist: references/seo-checklist.md
- Tone and keyword limits: references/writing-rules.md
- Optional structural check: run scripts/validate.py <article.md>

## Constraints
- Never invent metrics you cannot verify from the text.
- Keep recommendations specific and actionable.

## Expected output
A completed report matching templates/audit-report.md, with a pass/fail table and a short action list.

Мұнда сіздің құрылым тізіміңіз бойынша не бар: YAML frontmatter, атау, сипаттама, қолдану аймағы (сақталу орнымен беріледі — жеке/жоба/плагин), негізгі нұсқаулық, аргументтер (argument-hint + $ARGUMENTS), қосымша файлдарға сілтемелер, шектеулер (## Constraints), күтілетін нәтиже пішімі (## Expected output) және тексеру критерийлері (үлгідегі pass/fail кестесі).

Claude Skill қалтасының құрылымы

Дағды каталогының көрнекі сұлбасы:

seo-content-audit/
├── SKILL.md
├── references/
│   ├── seo-checklist.md
│   └── writing-rules.md
├── templates/
│   └── audit-report.md
└── scripts/
    └── validate.py

Элементтердің мақсаты:

Claude Skills: практикалық мысалдар

1-мысал. SEO Content Audit Skill

Тапсырма: жобаны on-page SEO бойынша аудиттеу. Құрылым: жоғарыдағыдай. SKILL.md: алдыңғы бөлімді қараңыз. Сұраныс мысалы: «Осы жобаға SEO-аудит жаса: title, meta, H1–H3, кілт, alt-мәтіндер, FAQ». Күтілетін нәтиже: pass/fail кестесі мен әрекеттер тізімі бар есеп. Шектеулер: дағды WordPress-тен дерек алмайды және интернетке шықпайды — ол тек берілген мәтінмен жұмыс істейді. Тексеру критерийлері: дәл бір H1 табылды; кілт пен alt тексерісі есепте көрінеді; үлгі сақталған.

2-мысал. Code Review Skill

Тапсырма: коммитке түспеген өзгерістерді тәуекелдерге назар аудара отырып ревьюлеу.

---
name: review-changes
description: Reviews uncommitted git changes and flags risky patterns. Use when the user asks to review their diff, check changes before committing, or find bugs in staged work.
allowed-tools: Bash(git diff *) Bash(git status *)
---

# Review changes

## Current diff
!`git diff HEAD`

## Instructions
Summarise the diff in 2-3 bullets, then list risks: missing error handling, hardcoded values, secrets, and tests that need updating. If the diff is empty, say there are no uncommitted changes.

Сұраныс мысалы: «Не өзгерттім? Коммитке дейін тәуекел бар ма?». Күтілетін нәтиже: ағымдағы diff бойынша қысқа түйін мен тәуекелдер тізімі. Шектеулер: тек коммитке түспеген өзгерістерді ревьюлейді. Тексеру критерийлері: diff бос болғанда дағды өзгеріс жоқ екенін адал хабарлайды. !`git diff HEAD` жолы — динамикалық контекст инъекциясы: пәрмен Claude нұсқаулықты көргенге дейін орындалады, ал оның шығысы мәтінге қойылады.

3-мысал. WordPress Article Preparation Skill

Тапсырма: жобаны WordPress-те жариялауға ыңғайлы құрылымға келтіру (тақырыптар, мазмұн, блоктар, alt-мәтіндер, FAQ).

---
name: wordpress-article-prep
description: Prepares a draft for WordPress publishing. Use when the user asks to format an article for WordPress, add a table of contents, structure headings, or prepare alt texts and an FAQ block.
allowed-tools: Read
---

# WordPress article prep

## Steps
1. Read the draft (path in $ARGUMENTS or pasted text).
2. Ensure a single H1 and a logical H2/H3 outline.
3. Insert a clickable table of contents with anchor links.
4. Propose alt text for each image placeholder.
5. Draft an FAQ block of 6-10 questions suitable for FAQ schema.
6. Output clean Markdown ready to paste into the editor.

## Constraints
- Do not invent facts or statistics.
- Keep the focus keyword placement natural; no stuffing.

Сұраныс мысалы: «Осы жобаны WordPress-те жариялауға дайында: тақырыптар, мазмұн, alt-мәтіндер және FAQ». Күтілетін нәтиже: мазмұны мен FAQ-і бар таза Markdown. Шектеулер: дағды жарияламайды және сайтқа қосылмайды — ол сіз өзіңіз қоятын мәтінді дайындайды. Тексеру критерийлері: бір H1, жұмыс істейтін якорьлер, 6–10 сұрақтан тұратын FAQ.

Claude Skills дағдыларын тестілеу

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

Тексеруге арналған сценарийлер: тікелей сұраныс, жанама сұраныс, қатысы жоқ сұраныс, көп мағыналы сұраныс, толық емес бастапқы деректер, қайшы нұсқаулықтар, жоқ қосымша файл, дұрыс емес каталог құрылымы, frontmatter қатесі, құпия деректерге қол жеткізу әрекеті.

Тест-кейстер матрицасы (үлгі — жүргізу кезінде нақты нәтижелермен толтырыңыз):

Claude Skills: жиі кездесетін қателер мен шешімдер

Claude Skills қауіпсіздігі

Дағды — орындалатын бірлік, сондықтан оған кез келген кодқа қатысты гигиена ережелері қолданылады.

• API-кілттерді, токендерді және парольдерді ешқашан SKILL.md-ке немесе қосымша файлдарға қоймаңыз: дағды мазмұны контекстке де, репозиторийге де түсуі мүмкін. YOUR_API_KEY сияқты белгілерді қолданыңыз.
• .env-ті сақтамаңыз және таратпаңыз дағды каталогы ішінде. Құпиялардың орны онда емес.
• Бейтаныс скриптерді басқа дағдылардан оқымай іске қоспаңыз. Жобада allowed-tools тек каталогқа сенім диалогын қабылдағаннан кейін белсенеді — репозиторийге көзсіз сенбеңіз, себебі дағды өзіне құралдарға кең қол жеткізуді бере алады.
• Сыртқы көздерден келген дағдыларды тексеріңіз: SKILL.md мен scripts/ мазмұнын толық оқыңыз; деректерді сыртқа жіберетін пәрмендерге назар аударыңыз.
• Қол жеткізуді шектеңіз: disallowed-tools дағды кезінде артық құралдарды алып тастайды; қажет болса, параметрлердегі disableSkillShellExecution: true пайдаланушы дағдылары үшін shell-пәрмен инъекциясын бұғаттайды.
• Пәрмендерді іске қоспас бұрын тексеріңіз, әсіресе қайтарымсыздарын (файлдарды жою, жүйелік параметрлерді өзгерту).
• Тестілеу ортасында жұмыс істеңіз (claude-skills-demo), қауіпсіздігіне көз жеткізгенше.
• Жариялар алдында скриншоттар мен файлдарды тазалаңыз: нақты жолдарды, email-ді, токендерді, жабық жоба атауларын алып тастаңыз; құпия аймақтар үшін әлсіз бұлдырату емес, мөлдір емес құюды қолданыңыз.

Қауіпсіздік тізімі:

Claude Skills бойынша үздік тәжірибелер

• Бір дағды — бір түсінікті тапсырма.
• Дәл description үшінші жақта, нақты триггер-сөздермен.
• Тексерілетін нәтиже (есеп үлгісі, pass/fail критерийлері).
• Ең қажетті нұсқаулық; барлық көлемдісі — references/-те.
• Ешқандай құпия жоқ; example.com, demo-project сияқты демонстрациялық деректер.
• Жалған қосылуларды тестілеңіз (теріс тестер).
• SKILL.md денесін 500 жолға дейін ұстаңыз.
• Дағдыны git-те нұсқалаңыз; CHANGELOG мен README жүргізіңіз.
• Қайталанатын тестер жазыңыз; мүмкіндігінше өлшеу үшін skill-creator қолданыңыз.

Жариялау тізімі:

Claude Skills: жиі қойылатын сұрақтарға жауаптар

Claude Skills дегеніміз не? Бұл — Claude-тың модульдік кеңейтімдері: SKILL.md файлы бар каталог, онда Claude автоматты түрде немесе пәрмен бойынша қосатын процедура немесе білім сипатталады.

Claude Skills қайда сақталады? Жекелері — ~/.claude/skills/-те, жобалары — жобаның .claude/skills/-інде, плагиндері — плагиннің skills/ каталогында, ұйымдық — managed-параметрлер арқылы.

SKILL.md файлы дегеніміз не? Дағдының кіру нүктесі: YAML frontmatter (метадеректер, ең алдымен name мен description) және Markdown-нұсқаулық. Файл атауы қатаң түрде SKILL.md (регистрді ескере отырып).

Өз Claude Skill-іңді қалай құруға болады? ~/.claude/skills/-те каталог құрып, SKILL.md қосып, description-ті толтырып, нұсқаулық жазып, қажет болса references/, templates/, scripts/ қоса, содан соң қолмен де, автоқосуды да тестілеу.

Скриптерді іске қосуға бола ма? Иә. scripts/ ішіндегі скриптер орындалады (контекстке жүктелмейді); контекстке тек олардың шығысы түседі. API-ортада орындау кезінде желіге қол жеткізу мен пакет орнату жоқ — мұны ескеріңіз.

Claude Skills пен MCP айырмашылығы неде? MCP сыртқы құралдар мен деректерді серверлер арқылы қосады; Claude Skills процедуралар мен білімді қайта пайдаланады. Дағды MCP-құралдарына жүгіне алады, бірақ бұл — әртүрлі механизмдер.

Claude Skills пен CLAUDE.md айырмашылығы неде? CLAUDE.md әрқашан контексте және жоба фактілерін сақтайды; дағды сұраныс бойынша қосылады және процедуралар/анықтамалықтарды сақтайды.

Skills-ті басқа пайдаланушыларға беруге бола ма? Иә: .claude/skills/-ті репозиторийге коммит ету, плагин ресімдеу немесе managed-параметрлер арқылы тарату. Алдымен құпиялар мен дербес деректерді алып тастаңыз.

Claude Skill неге іске қосылмайды? Көбіне — қате жол/каталог атауы немесе бұзылған frontmatter, соның салдарынан сәйкестендіруге description болмайды. --debug пен дағдылар тізімін тексеріңіз.

Бөтен Skills орнату қауіпсіз бе? Тек тексергеннен кейін: SKILL.md мен барлық скриптерді оқыңыз, allowed-tools-ты бағалаңыз, бейтаныс репозиторийге сенім диалогын көзсіз қабылдамаңыз.

Skills Claude-тың барлық нұсқаларында жұмыс істей ме? Базалық дағдылар — иә, бірақ жекелеген мүмкіндіктер Claude Code-тың нақты нұсқаларын талап етеді (мысалы, /run мен /verify — v2.1.145+, ${CLAUDE_PROJECT_DIR} — v2.1.196+). claude --version-ды тексеріңіз.

Skills құру үшін бағдарламалау қажет пе? Жоқ. Дағды — ішінде мәтіндік файлы бар қалта. Бағдарламалау тек scripts/-ке скрипт қосқанда ғана керек.

Claude Skills: қорытынды және келесі қадам

Claude Skills қайталанатын жұмысты қайта пайдаланылатын құралға айналдырады. Сіз дағды каталогын құрдыңыз, SKILL.md-ті дұрыс frontmatter-мен толтырдыңыз, тексерілетін нұсқаулық жаздыңыз, анықтамалық пен үлгіні бөлек файлдарға шығардыңыз, валидатор скрипт қостыңыз, қолмен де, автоматты да іске қосуды тексердіңіз, типтік қателер мен қауіпсіздік ережелерінен өттіңіз. Енді өз тапсырмаңызға дағды жинап, онымен қауіпсіз бөлісе аласыз.

Нәтижені қалай тексеру керек: тестілік мақалада /seo-content-audit-ті іске қосып, есепті үлгімен салыстырыңыз; содан кейін автоқосудың оң және теріс тестерін қайталаңыз. Ұсынылатын келесі қадам — өзіңіздің қайталанатын процедураңызды (мысалы, ревью немесе жарияланым дайындау) дағдыға айналдырып, оны skill-creator арқылы жүргізіп, дағдысыз жұмыспен салыстырғандағы пайданы өлшеу.

Тәсілдерді салыстыру үшін Cifrum.kz сайтындағы Codex үшін Skill жасау нұсқаулығын оқыңыз. Anthropic-тің командалық жұмыс сценарийі қажет болса, Slack-та Claude Tag баптау материалын қараңыз.

Ресми дереккөздер

Басты сурет Cifrum.kz үшін жасанды интеллект жасаған концептуалды редакциялық иллюстрация болып табылады.