ถ้าคุณมีงานที่สั่ง Claude ซ้ำๆ และต้องอธิบายวิธีทำใหม่ทุกครั้ง นั่นคือสัญญาณว่างานนั้นควรเป็นสกิล สกิลช่วยให้ Claude ทำงานเรื่องนั้นแบบเดิมทุกครั้งโดยไม่ต้องสั่งยาว และตอนนี้สกิลเป็นมาตรฐานเปิดที่เครื่องมือมากกว่า 70 ตัวรองรับ
บทความนี้จะพาเขียนสกิลจริงหนึ่งตัว: สกิลเขียนแคปชันขายของภาษาไทย
สกิลหน้าตาเป็นยังไง
สกิลคือโฟลเดอร์ ข้างในต้องมีไฟล์ SKILL.md อย่างน้อยหนึ่งไฟล์ ที่เหลือมีหรือไม่มีก็ได้
thai-caption/
├── SKILL.md จำเป็น: ข้อมูลสกิล + วิธีทำ
├── references/ ไม่บังคับ: เอกสารอ้างอิง
├── assets/ ไม่บังคับ: เทมเพลต รูป ข้อมูล
└── scripts/ ไม่บังคับ: สคริปต์ที่สั่งรันได้
เข้าใจก่อน: Claude อ่านสกิลทีละชั้น
นี่คือหัวใจของการเขียนสกิลให้ดี Claude ไม่ได้อ่านทุกอย่างในทุกสกิลตลอดเวลา
ที่มา: สเปก Agent Skills ที่ agentskills.io
ผลที่ตามมาคือ คำอธิบาย (description) สำคัญที่สุด เพราะเป็นส่วนเดียวที่ Claude เห็นตอนตัดสินใจว่าจะหยิบสกิลไหน ถ้าคำอธิบายไม่ดี สกิลจะไม่ถูกเรียกใช้เลย
ขั้นที่ 1: ตั้งชื่อ
ชื่อสกิลต้องเป็นไปตามกฎของสเปก
- ยาว 1 ถึง 64 ตัวอักษร
- ใช้ได้เฉพาะ a ถึง z ตัวเล็ก ตัวเลข และขีด
- - ห้ามขึ้นต้นหรือลงท้ายด้วยขีด และห้ามมีขีดติดกันสองตัว
- ต้องตรงกับชื่อโฟลเดอร์
ตัวอย่างที่ใช้ได้: thai-caption ตัวอย่างที่ใช้ไม่ได้: Thai-Caption (มีตัวใหญ่), -caption (ขึ้นต้นด้วยขีด)
ขั้นที่ 2: เขียนคำอธิบาย
คำอธิบายยาวได้ไม่เกิน 1,024 ตัวอักษร ต้องบอก 2 อย่าง: สกิลนี้ทำอะไร และ ใช้เมื่อไหร่ พร้อมคำที่คนน่าจะพิมพ์มาจริง
ไม่ดี:
description: ช่วยเขียนแคปชัน
ดี:
description: เขียนแคปชันขายสินค้าภาษาไทยสำหรับ Facebook, Instagram และ TikTok ตามน้ำเสียงแบรนด์ มี hook, จุดขาย 3 ข้อ และ CTA ใช้เมื่อผู้ใช้ขอแคปชัน โพสต์ขายของ ข้อความโปรโมท หรือพูดว่า "เขียนแคป"
ขั้นที่ 3: เขียนเนื้อหา SKILL.md
ส่วนบนสุดคือ front matter ที่อยู่ระหว่างเส้น --- ตามด้วยวิธีทำงานแบบ Markdown สเปกไม่บังคับรูปแบบ แต่แนะนำให้มีขั้นตอน ตัวอย่าง และกรณีพิเศษ
---
name: thai-caption
description: เขียนแคปชันขายสินค้าภาษาไทยสำหรับ Facebook, Instagram และ TikTok ...
---
# เขียนแคปชันขายของภาษาไทย
## ก่อนเริ่ม
ถามให้ครบ 4 อย่าง ถ้าผู้ใช้ยังไม่บอก: สินค้าคืออะไร ราคา
ขายใคร และโพสต์ลงแพลตฟอร์มไหน
## วิธีเขียน
1. บรรทัดแรกเป็น hook ไม่เกิน 12 คำ ดึงจากปัญหาของลูกค้า
2. จุดขาย 3 ข้อ แต่ละข้อขึ้นต้นด้วยประโยชน์ ไม่ใช่สเปก
3. ปิดด้วย CTA ข้อเดียว เช่น "ทักแชทเลย"
4. TikTok สั้นกว่า Facebook ครึ่งหนึ่ง
## ห้าม
- ห้ามแต่งราคา รีวิว หรือตัวเลขยอดขาย ถ้าผู้ใช้ไม่ได้ให้
- ห้ามใช้คำว่า "ที่สุด" ถ้าไม่มีหลักฐาน
## ตัวอย่าง
ข้อมูลเข้า: กระบอกน้ำเก็บความเย็น 24 ชม. ราคา 390 บาท ขายคนทำงานออฟฟิศ
ผลลัพธ์: (ใส่แคปชันตัวอย่างที่คุณชอบ 1 ชิ้น)
เคล็ดลับ: ตัวอย่างหนึ่งชิ้นที่ดีมีค่ากว่าคำอธิบายสิบบรรทัด ใส่ผลงานที่คุณพอใจจริงลงไป Claude จะจับน้ำเสียงได้เร็วมาก
ขั้นที่ 4: แยกของยาวออกไปไว้ข้างนอก
สเปกแนะนำให้ SKILL.md ยาวไม่เกิน 500 บรรทัด หรือประมาณ 5,000 tokens ถ้ามีข้อมูลเยอะ เช่น คู่มือแบรนด์ 20 หน้า ให้ย้ายไปไว้ใน references/brand.md แล้วอ้างถึงในไฟล์หลัก
น้ำเสียงแบรนด์ทั้งหมดอยู่ใน [คู่มือแบรนด์](references/brand.md)
อ่านก่อนเขียนทุกครั้ง
อ้างอิงลึกได้ชั้นเดียวจาก SKILL.md อย่าทำไฟล์อ้างอิงที่ชี้ต่อไปอีกหลายทอด
ขั้นที่ 5: ติดตั้งและทดสอบ
- วางโฟลเดอร์ไว้ที่
.claude/skills/thai-caption/ในโฟลเดอร์งานของคุณ - เปิด Claude Code ใหม่
- ทดสอบด้วยประโยคที่คนพิมพ์จริง 3 แบบ เช่น "เขียนแคปให้หน่อย", "ทำโพสต์ขายกระบอกน้ำ", "ข้อความโปรโมท TikTok"
- ถ้า Claude ไม่หยิบสกิลมาใช้ แก้ที่ คำอธิบาย ก่อนเสมอ
- ถ้าหยิบมาแล้วผลไม่ดี แก้ที่ วิธีทำ หรือเพิ่มตัวอย่าง
ถ้ามีเครื่องมือของสเปก สามารถตรวจรูปแบบด้วย skills-ref validate ./thai-caption ได้
ฟิลด์เสริมที่ควรรู้
| ฟิลด์ | ใช้ทำอะไร |
|---|---|
license |
ระบุสัญญาอนุญาต สำคัญถ้าจะแจกหรือขาย |
compatibility |
บอกว่าต้องใช้อะไรเพิ่ม เช่น ต้องต่ออินเทอร์เน็ต สกิลส่วนใหญ่ไม่ต้องใส่ |
metadata |
เก็บข้อมูลอื่น เช่น ผู้เขียน เวอร์ชัน |
allowed-tools |
ระบุเครื่องมือที่อนุญาตล่วงหน้า (ยังทดลอง แต่ละโปรแกรมรองรับต่างกัน) |
ความผิดพลาดที่เจอบ่อย
- คำอธิบายกว้างเกินไป สกิลไปโผล่ในงานที่ไม่เกี่ยว
- คำอธิบายแคบเกินไป สกิลไม่ถูกเรียกใช้เลย
- ยัดทุกอย่างไว้ในไฟล์เดียว เปลืองพื้นที่ความจำของ Claude ทุกครั้งที่ใช้
- ไม่มีตัวอย่าง Claude ต้องเดาน้ำเสียงเอง
แหล่งข้อมูล
- Agent Skills Specification (agentskills.io)
- Donating Agent Skills to the Agentic AI Foundation (Anthropic)
