Claude Skills, ทำให้ Claude เป็น 'นักเฉพาะทาง' ในงานของคุณ ด้วยโฟลเดอร์เดียว

ทุกคนที่ใช้ Claude Code มาสักพักจะรู้สึก pattern เดิม ๆ ว่าเราเอา prompt เดียวกัน (เช่น "เขียน PR description ตามแบบของบริษัท", "ทำ migration ตาม checklist 8 ขั้นนี้") แปะซ้ำทุก session จน CLAUDE.md โต 600 บรรทัดและกินบริบทไปครึ่งหนึ่ง

ตั้งแต่ Oct 2025 Anthropic ปล่อยฟีเจอร์ Agent Skills ออกมา, ห่อความรู้ของคุณเป็น "package" ที่ Claude หยิบมาใช้เองเฉพาะตอนต้องใช้ ไม่กิน context ตอนไม่จำเป็น และ distribute ข้ามทีมได้

บทความนี้คือ primer สำหรับนักพัฒนาที่อยากเริ่มเขียน skill ของตัวเองวันนี้

Skill คืออะไร (ในประโยคเดียว)

ref: Agent Skills overview

Skill คือ โฟลเดอร์บน filesystem ที่มีไฟล์ SKILL.md (พร้อม YAML frontmatter) + ไฟล์ supporting อื่น ๆ (markdown reference, script, asset) ที่ Claude โหลดเมื่อจำเป็น ตามที่ task ตรงกับ description ของ skill นั้น

หน่วยของ skill คือโฟลเดอร์ตรง ๆ ไม่ใช่ binary หรือ DSL พิเศษ:

my-skill/
├── SKILL.md # entrypoint (required, มี YAML frontmatter)
├── reference.md # โหลดเมื่อจำเป็น
└── scripts/
    └── helper.py # Claude สั่ง bash รันได้, code ไม่เข้า context

ต่างจาก prompt / CLAUDE.md / MCP server ยังไง?

จุดสำคัญ: Skill ไม่ใช่ tool ใหม่. มันคือ "ห่อความรู้" บอก Claude ว่า "task แบบนี้ต้องทำตามขั้นตอนนี้ มี script ตัวช่วยด้วย", Claude ยังใช้ tool เดิมของตัวเอง (Bash, Read, Edit, ...) แต่มี playbook ชัดเจน

ทำไมต้องมี Skill, design problem ที่มันแก้

ref: Best practices

3 ปัญหาที่ doc พูดตรง ๆ:

1. Context bloat, ถ้าแปะ "คู่มือเขียน PR" 800 บรรทัดทุก session, context หาย + คู่มือล้าสมัยได้ง่าย. Skill โหลดแค่ metadata (~100 tokens) ตอน startup, body โหลดเฉพาะเมื่อ task ตรง
2. Repeated instructions, ทีมเขียน checklist เดียวกันแปะใน chat ทุกคน. ถ้ารวมเป็น skill ก็ commit ไว้ใน repo จบ
3. CLAUDE.md โตเกินไป, ถ้า CLAUDE.md ของ project นายมี section ที่กลายเป็น "ขั้นตอน" 8 ขั้น แทนที่จะเป็น "ข้อเท็จจริง", นั่นแหละต้องแยกเป็น skill

ปัญหาที่ 4 (จาก announcement):

"Skills can include executable code for tasks where traditional programming is more reliable than token generation."

ตัวอย่าง: ถ้าให้ Claude validate JSON schema ด้วย "การคิด" จะพลาดได้, แต่ถ้า skill มี validate.py แล้วบอก Claude ว่า "รันสคริปต์นี้", ผลลัพธ์ deterministic

Before / After, มันต่างจากเดิมยังไง

เปรียบเทียบ 2 sceanario ที่ทีมไทยเจอบ่อย:

Scenario A: PR description ตามมาตรฐานทีม

Before, ทุกคนแปะ prompt เดียวกัน:

ช่วยเขียน PR description ตามรูปแบบของทีมเรานะ
มี 3 ส่วน: Why, What, Test plan
ใน Why ใส่ context + ticket link
ใน What เป็น bullet list ของไฟล์ที่แก้
Test plan เป็น checkbox markdown
ห้ามใส่ emoji ห้ามใส่ " Generated with..."
... (อีก 20 บรรทัด)

แปะทุก turn, บางคนจำได้บางคนลืม, format ไม่เหมือนกันใน team

After, มี .claude/skills/pr-description/SKILL.md:

---
name: pr-description
description: Write a PR description in our team's standard 3-section format (Why, What, Test plan). Use when the user asks to write or update a PR description, or after committing.
---
 
## Format
- ## Why, context + ticket link
- ## What, bullet of changed files
- ## Test plan, markdown checkbox list
 
## Rules
- No emoji
- No "Generated with..." trailer
- ...

นาย commit เข้า repo, ทีมทุกคนใช้เหมือนกัน, prompt ลดเหลือ "ช่วยเขียน PR description", Claude trigger skill เอง

Scenario B: deploy ไป ECS ของบริษัท

Before, ทุก dev ของทีมจำขั้นตอนเอง, พลาดบ่อย:

"ลืม update task definition ก่อน aws ecs update-service"
"secret ARN ของ service นี้คืออะไรนะ"
"Jenkinsfile pattern ที่ทีมใช้คือ deployEcsService ใช่ปะ"

After, .claude/skills/uplift-deploy/SKILL.md + reference.md ของ secret ARN ทั้งหมด + scripts/check-task-def.py (deterministic verification):

.claude/skills/uplift-deploy/
├── SKILL.md # ขั้นตอนหลัก
├── reference.md # secret ARN ของ 12 service
├── jenkinsfile.md # pattern + คำเตือน
└── scripts/
    └── check-task-def.py

Claude อ่าน SKILL.md (5k tokens) แล้วชี้ไป reference.md เฉพาะถ้าต้องเช็ค secret. Script check-task-def.py รันได้เลย Claude ไม่เดา. ทุก dev ใน team ใช้ pattern เดียวกัน, ทุก deploy reproducible

ผลลัพธ์ที่ต่างกัน

องค์ประกอบของ skill

SKILL.md ฉบับเล็กที่สุด

---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---
 
# PDF Processing
 
## Quick start
Use pdfplumber for text extraction:
 
​```python
import pdfplumber
with pdfplumber.open("file.pdf") as pdf:
    text = pdf.pages[0].extract_text()
​```

Frontmatter, ที่ใช้บ่อย

Supporting files ของ skill จริง (pdf ของ Anthropic)

ref: github.com/anthropics/skills

pdf/
├── SKILL.md # high-level guide (โหลดเมื่อ trigger)
├── FORMS.md # form-filling guide (โหลดเฉพาะถ้าทำ form)
├── reference.md # API reference (โหลดเฉพาะถ้าต้องดู)
├── examples.md
└── scripts/
    ├── analyze_form.py # bash exec, code ไม่เข้า context
    ├── fill_form.py
    └── validate.py

นี่คือ canonical pattern: SKILL.md เป็น "table of contents" ที่ชี้ไปหา reference.md กับ scripts/ ตอนจำเป็น

Progressive Disclosure, mental model ที่ต้องเข้าใจ

ref: Overview

นี่คือเหตุผลที่ skill จะไม่ทำ context พัง:

แปลว่า:

• ติดตั้ง skill 100 ตัวกิน context แค่ ~10k tokens ตอน startup, ถูกมาก
• Script ที่ bundle ใน skill กิน 0 token เพราะ Claude สั่ง bash:python scripts/validate.py แล้วได้ output กลับ, source code ของ script ไม่เข้า context เลย
• Skill จะ ship reference 50 หน้าก็ได้ ถ้า task ไม่ต้องใช้ก็ไม่กินอะไร

Skill อยู่ที่ไหนได้บ้าง

ref: Claude Code skills

Precedence: enterprise → personal → project (สูงกว่าทับล่าง). Plugin ใช้ namespace plugin-name:skill-name กันชน

เขียน skill ให้ดี, 3 กฎสำคัญ

ref: Best practices

1. description คือทุกอย่างสำหรับการ trigger

doc พูดตรง ๆ ว่า "critical for skill selection". Claude มี skill 100+ ตัวให้เลือก, มันใช้ description ของแต่ละตัวตัดสิน

ดี:

description: Generate descriptive commit messages by analyzing git diffs. Use when the user asks for help writing commit messages or reviewing staged changes.

แย่:

description: Helps with documents

บุรุษที่ 1 (ทำลายการ trigger):

description: I can help you with X

2. แยก SKILL.md กับ reference

• SKILL.md body < 500 บรรทัด: คำสั่งหลัก + quick-start
• reference.md / examples.md: API detail, edge case, code ตัวอย่างยาว, Claude อ่านเฉพาะถ้าจำเป็น
• scripts/: ของ deterministic (validation, migration). Code ไม่เข้า context, มี output ออกมาเท่านั้น

3. อย่าสอนสิ่งที่ Claude รู้แล้ว

"Default assumption: Claude is already very smart. Only add context Claude doesn't already have."

อย่าเสียที่อธิบายว่า PDF คืออะไร, HTTP คืออะไร, ตัด

Skill vs MCP server, ใช้ตัวไหน

Rule of thumb: ถ้าสิ่งที่จะเพิ่มอธิบายเป็น "ขั้นตอนทำสิ่งนี้ + ดู doc นี้" → เขียน skill. ถ้าเป็น "call ระบบเป็น ๆ ไปเอา/แก้ data" → ใช้ MCP

Distribution, จะแจกจ่ายยังไง

ref: anthropics/skills repo

4 ทางหลัก:

1. commit โฟลเดอร์ตรง ๆ ใน .claude/skills/ ของ project, distribute ผ่าน git ปกติ. ง่ายสุด, audit ผ่าน PR ได้, ทีมเห็น diff ปกติ
2. Anthropic plugin marketplace, repo anthropics/skills:

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

3. skills.sh, cross-tool marketplace (Open Agent Skills Ecosystem). ติดตั้ง skill ตัวเดียวใช้ได้ทั้ง Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini, Cline และอื่น ๆ:

npx skills add <owner>/<repo>

เหมาะถ้าทีมใช้ tool หลายตัว ไม่อยาก lock เข้า Claude อย่างเดียว 4. Third-party marketplace ส่วนตัว, repo GitHub ใด ๆ ที่มีโครงสร้างถูกใช้เป็น marketplace ได้ (Notion ทำเอง Notion Skills)

ฝั่ง Claude API: upload skill ผ่าน POST /v1/skills แล้วอ้างถึงด้วย skill_id ในตอน call Messages API

Reference ที่ควรดูก่อนเขียน skill แรก

• anthropics/skills, source ของ pdf, xlsx, docx, pptx skill ที่ powers Claude.ai เอง. อ่าน SKILL.md ของแต่ละตัวเป็น reference ที่ดีที่สุด
• skills.sh, community-curated, search ตามชื่อ tool ได้
• Claude Code skills docs, frontmatter reference ครบทุก field
• Best practices guide, naming, description, degree of freedom, สำคัญถ้าจะเขียนให้ Claude trigger ถูก

Gotcha สำคัญสำหรับ developer ไทย

ref: Overview > Security

1. name ใส่ภาษาไทยไม่ได้, [a-z0-9-] เท่านั้น. ภาษาไทยใน body / description ได้ปกติ แต่ลอง include English trigger keyword ใน description เผื่อ Claude คิดเป็นอังกฤษ
2. Path มี space ต้อง quote, ถ้า script ใน skill อ้าง $CLAUDE_SKILL_DIR แล้ว path เป็น /Volumes/My SSD/... ลืม quote = สคริปต์พัง: bash -c "cd \"$CLAUDE_SKILL_DIR\" && ..."
3. Security: skill รัน code ได้, doc เตือนตรง ๆ: "Use Skills only from trusted sources... a malicious Skill can direct Claude to invoke tools or execute code in ways that don't match the Skill's stated purpose.", audit scripts/ ก่อน install
4. Secret leak, อย่า hardcode token ใน SKILL.md หรือ !`cat .env` ใน body. body ถูก inject เข้า conversation context แล้วจะติด log
5. Lifecycle ใน Claude Code, พอ skill ถูก invoke แล้ว body จะค้างใน session ทั้งหมด แก้ไฟล์ระหว่าง session = ไม่ refresh จนกว่าจะ trigger ใหม่หรือเริ่ม session ใหม่
6. ห้ามใช้คำว่า claude / anthropic ใน name, reject ทันที
7. Cross-surface ยังไม่ sync, upload claude.ai ไม่ทำให้ API หรือ Claude Code เห็น. 3 surface นี้แยกกัน

สรุป

Skill คือเครื่องมือที่ทำให้ "ความรู้ในหัวคุณ" → "asset ที่ทีมรียูสได้" ใน 3 คำ:

• เลิกแปะ prompt ซ้ำ → ทำ skill 1 ครั้ง รียูสทุก session
• เลิกพัง context → progressive disclosure โหลดเฉพาะจำเป็น
• เลิกพึ่ง LLM เดาเรื่อง deterministic → bundle script เข้าไป Claude จะรันให้

ถ้านายมี checklist หรือ workflow ที่ทำซ้ำในหัว, ลอง mkdir -p ~/.claude/skills/my-first-skill && touch SKILL.md แล้วเขียน frontmatter + 10 บรรทัดของ instruction ดูก่อน. Claude จะ trigger ตอนนายทำงานที่ตรงกับ description เอง

ลองดูตัวอย่างจริง ๆ ที่ anthropics/skills, เปิด SKILL.md ของ pdf หรือ xlsx แล้ว reverse-engineer ว่า frontmatter / structure / scripts/ จัดยังไง. หรือ search skill ที่คนอื่นเขียนไว้แล้วที่ skills.sh, บางทีของที่นายจะเขียนมีคนทำเสร็จแล้ว ติดตั้ง npx skills add <repo> จบ

30 นาทีคุณจะมี skill แรกของตัวเองพร้อม commit ลง .claude/skills/ ของ project