ข้ามไปที่เนื้อหา
วันจันทร์, พฤศจิกายน 16, 2026ข่าวเทคโนโลยี รีวิว และคู่มือใช้งานจริงโดยอิสระ
เกี่ยวกับ
ล่าสุด /

อธิบาย Agent Skills และเซิร์ฟเวอร์ MCP: วิธีติดตั้ง อัปเดต และแก้ไขใน OpenCode, Claude Code, Codex และเอเจนต์ AI อื่น ๆ

อ่านคู่มือ
เอเจนต์ AIGM / 997

อธิบาย Agent Skills และเซิร์ฟเวอร์ MCP: วิธีติดตั้ง อัปเดต และแก้ไขใน OpenCode, Claude Code, Codex และเอเจนต์ AI อื่น ๆ

อธิบาย Agent Skills และ MCP Servers แบบเข้าใจง่าย พร้อมติดตั้ง อัปเดต แก้ไขใน OpenCode, Claude Code, Codex และอื่น ๆ ด้วย npx skills CLI

Agent skills and MCP servers explained: a tech.grahammiranda.com title card with SKILL.md, npx skills, MCP servers and .agents/skills, and a terminal running npx skills check and opencode mcp add

เอเจนต์เขียนโค้ด AI ที่เพิ่งแกะกล่องใหม่ ๆ ก็เหมือนพนักงานใหม่ที่เก่งมากในเช้าวันแรกของเขา มันคิดวิเคราะห์ เขียนโค้ด และรันคำสั่งได้ แต่ก็’ไม่รู้ว่าทีมของคุณทำงานกันอย่างไร และไม่มีกุญแจเข้าสู่ระบบต่าง ๆ ของคุณ สกิลของเอเจนต์และเซิร์ฟเวอร์ MCP เติมเต็มช่องว่างสองข้อนั้นพอดี สกิลคือคู่มือที่เขียนไว้ ซึ่งเอเจนต์หยิบมาใช้เมื่อมีงานที่ต้องใช้ เซิร์ฟเวอร์ MCP คือชุดกุญแจ: โปรแกรมเล็ก ๆ ที่ทำให้เอเจนต์ใช้สิ่งที่มัน’เข้าถึงไม่ได้มาก่อน เช่น GitHub issues ของคุณ เบราว์เซอร์จริง หรือเอกสารที่อัปเดตล่าสุด

คู่มือนี้อธิบายทั้งสองอย่างด้วยภาษาง่าย ๆ แล้วแสดงวิธีติดตั้ง อัปเดต ลบ และแก้ปัญหาใน OpenCode, Claude Code, Codex, Gemini CLI, Cursor, GitHub Copilot และ Hermes Agent ส่วนใหญ่ทำงานเหมือนกันทุกที่ เพราะทั้งสองอย่างตอนนี้เป็นมาตรฐานเปิด ในฝั่งของสกิล มีเครื่องมือบรรทัดคำสั่งเล็ก ๆ ตัวเดียวที่เชื่อมทุกอย่างเข้าด้วยกัน npx skillsและผม’จะไล่ให้ดูทีละคำสั่ง

ผมไม่’ได้จบมาทางสายนักพัฒนา ผมบริหารบริษัทไอทีเล็ก ๆ ในเยอรมนีและสร้างซอฟต์แวร์ด้วยเอเจนต์ AI ดังนั้นส่วนใหญ่ผมจึงเรียนรู้สิ่งนี้ด้วยวิธีที่คุณคงจะเจอเหมือนกัน คือการทำมันพังก่อน ส่วนที่ 6 สร้างขึ้นจากเซสชันเทอร์มินัลของผมเองบน Mac และ Raspberry Pi รวมถึงครั้งที่เครื่องมือบอกว่าสกิลทั้งหมดของผมเป็นเวอร์ชันล่าสุด ทั้งที่มันก็’ตรวจไม่ได้สักตัว

ทุกอย่างด้านล่างนี้ตรวจสอบกับเอกสารทางการของเอเจนต์แต่ละตัว และสำหรับ สกิล CLI ก็ตรวจกับซอร์สโค้ดที่เผยแพร่ของเวอร์ชัน 1.5.18 ถึง 1.8.1 เมื่อ 15 พฤศจิกายน 2026เครื่องมือเหล่านี้เปลี่ยนทุกสัปดาห์: เฉพาะสัปดาห์นี้สัปดาห์เดียว CLI ออกถึงสองรีลีส และ OpenCode ไปถึง 2.3.0 เมื่อ 13 พฤศจิกายน หมายเลขเวอร์ชันและพฤติกรรมจะถูกระบุไว้ตรงจุดที่มัน’อาจเปลี่ยนแปลงได้ ตรวจสอบก่อนที่คุณจะพึ่งพามัน

การเปิดเผย: ไม่มีบริษัทใดที่ถูกกล่าวถึงในบทความนี้สนับสนุน ตรวจทาน หรืออนุมัติบทความนี้ และบทความนี้ไม่มีลิงก์ affiliate ชื่อผลิตภัณฑ์ปรากฏในเนื้อหาเท่านั้น ภาพต่าง ๆ ใช้โลโก้ของผมเอง


สรุปสั้น ๆ — Agent Skills และเซิร์ฟเวอร์ MCP ในสิบข้อ

  • สกิลคือโฟลเดอร์หนึ่งที่มีไฟล์ SKILL.md ไฟล์: มีชื่อและคำอธิบายอยู่ด้านบน มีคำแนะนำอยู่ด้านล่าง และมีสคริปต์หรือไฟล์อ้างอิงเพิ่มได้ตามต้องการ เอเจนต์จะอ่านแค่คำอธิบายจนกว่างานจะต้องใช้สกิลนั้น ดังนั้นสกิลที่ไม่ได้ใช้ก็’กินความสนใจของเอเจนต์ไปราว 100 โทเคน
  • เซิร์ฟเวอร์ MCP มอบเครื่องมือใหม่ให้เอเจนต์เช่น GitHub, เบราว์เซอร์ หรือเอกสารสด ๆ คำอธิบายเครื่องมืออาจติดไปกับทุกคำขอ ดังนั้นเชื่อมต่อเฉพาะเซิร์ฟเวอร์ที่คุณใช้ Claude Code ตอนนี้เลื่อนไปจนกว่าจะต้องใช้ และ OpenCode จัดกลุ่มตามเซิร์ฟเวอร์
  • หลักง่าย ๆ คือ: กฎประจำบ้านสำหรับทุกงานให้ใส่ไว้ใน AGENTS.mdความรู้ที่ต้องใช้กับบางงานกลายเป็นสกิล การเข้าถึงระบบแบบสด ๆ ต้องใช้เซิร์ฟเวอร์ MCP และถ้ามีเครื่องมือบรรทัดคำสั่งที่ดีอยู่แล้ว สกิลที่สอนเอเจนต์ให้ใช้เครื่องมือนั้นมักถูกกว่าการใช้เซิร์ฟเวอร์
  • ทั้งสองอย่างเป็นมาตรฐานเปิด ภายใต้ Agentic AI Foundation’ของ Linux Foundation: MCP ตั้งแต่ธันวาคม 2025, Agent Skills ตั้งแต่ 22 ตุลาคม 2026 สกิลที่เขียนสำหรับเอเจนต์ตัวหนึ่งมักใช้กับตัวอื่นได้
  • .agents/skills คือโฟลเดอร์ที่ใช้ร่วมกัน Codex, OpenCode, Cursor, Gemini CLI และ GitHub Copilot ต่างอ่าน .agents/skills ในโปรเจกต์ และ ~/.agents/skills ในโฟลเดอร์ home ของคุณ Claude Code อ่านเพียง .claude/skills, และ Hermes Agent จะอ่าน ~/.hermes/skills รวมถึงโฟลเดอร์ใดก็ตามที่คุณเพิ่มเข้าไป
  • npx skills คือ npm สำหรับสกิล Vercel’s CLI โอเพนซอร์ส (เวอร์ชัน 1.8.1) ติดตั้งสกิลลงในเอเจนต์ 79 ตัว: npx skills add owner/repo, -g สำหรับทุกโปรเจกต์ -a opencode -a claude-code เพื่อเลือกเอเจนต์ npx skills ls เพื่อแสดงรายการและ npx skills remove เพื่อถอนการติดตั้ง
  • หากต้องการดูว่าสกิลของคุณเป็นเวอร์ชันล่าสุดหรือไม่ ให้รัน npx skills@latest check. ตั้งแต่เวอร์ชัน 1.7.5 (2 พฤศจิกายน 2026) เป็นต้นมา คำสั่งนี้เพียงรายงานผลเท่านั้น; npx skills update จะทำการติดตั้งให้ ในเวอร์ชันก่อนหน้านี้ check รันการอัปเดตให้เงียบ ๆ
  • อย่าไว้ใจเครื่องหมายถูกสีเขียวเพียงอย่างเดียว เมื่อขีดจำกัด 60 คำขอแบบไม่ระบุตัวตนต่อชั่วโมงของ GitHub บล็อกการตรวจสอบทุกครั้งบน Mac ของผม CLI ก็ยังพิมพ์ข้อความ “All global skills are up to date” ออกมา ให้รัน gh auth login หรือตั้งค่า GITHUB_TOKEN, และอ่านบรรทัดที่มีเครื่องหมาย ✗
  • ห้ามใช้ sudo กับสกิลหรือเอเจนต์ และอย่ารัน CLI จากโฟลเดอร์บ้านของคุณ Root มีโฮมไดเรกทอรีแยกต่างหาก ดังนั้น sudo จึงสร้างที่เก็บสกิลชุดที่สองที่มองไม่เห็น; และเมื่อรันจาก ~ CLI จะเข้าใจผิดว่าโฟลเดอร์บ้านของคุณคือโปรเจกต์
  • ถือว่าสกิลและ MCP server เป็นเหมือนซอฟต์แวร์ที่คุณติดตั้ง การตรวจสอบสกิลสาธารณะ 3,984 รายการเมื่อเดือนกุมภาพันธ์ 2026 พบช่องโหว่ด้านความปลอดภัยใน 36.82% ของสกิลเหล่านั้น และยืนยันพบเพย์โหลดอันตรายใน 76 รายการ อ่านก่อนติดตั้ง เลือกใช้สกิลจากผู้สร้างเครื่องมือนั้นเอง ปักหมุดเวอร์ชัน และปล่อยให้เครื่องมือที่มีความเสี่ยงอยู่ในโหมด “ask”

ภาพรวมสี่องค์ประกอบหลัก

องค์ประกอบ คืออะไร ในหนึ่งบรรทัด เปรียบได้กับ เอเจนต์จะอ่านเมื่อใด ราคา ตัวอย่าง
AGENTS.md (CLAUDE.md ใน Claude Code) ไฟล์ Markdown ที่รวมกฎภายในสำหรับโปรเจกต์หนึ่ง คู่มือพนักงาน เมื่อเริ่มทุกเซสชัน แบบเต็มทั้งหมด ความยาวทั้งหมด ในทุกคำขอ “ใช้การสะกดแบบอังกฤษ รันเทสต์ให้ผ่านก่อนบอกว่าเสร็จแล้ว”
สกิล โฟลเดอร์ที่มี SKILL.md ไฟล์สูตร พร้อมสคริปต์และเอกสารอ้างอิงเพิ่มเติมตามต้องการ การ์ดสูตรในแฟ้ม ชื่อและคำอธิบายอยู่ตอนต้น ส่วนสูตรเต็มจะโหลดเมื่อมีงานที่ต้องใช้เท่านั้น ประมาณ 100 โทเคนต่อสกิลจนกว่าจะถูกใช้ “วิธีที่เราเขียนบันทึกประจำรุ่น”
เซิร์ฟเวอร์ MCP โปรแกรมเล็ก ๆ ที่มอบเครื่องมือใหม่ให้เอเจนต์ ชุดกุญแจและอะแดปเตอร์ รายการเครื่องมือตอนเริ่มต้น (เว้นแต่เอเจนต์ของคุณจะเลื่อนไปโหลดทีหลัง) และเครื่องมือแต่ละตัวเมื่อถูกเรียกใช้ คำอธิบายเครื่องมือ ซึ่งมักอยู่ในทุกคำขอ รายการ issue บน GitHub, เบราว์เซอร์จริง, เอกสารไลบรารีล่าสุด
ปลั๊กอินหรือส่วนขยาย ชุดรวมของสกิล เซิร์ฟเวอร์ MCP และบางครั้งก็มีฮุก ชุดต้อนรับ ขึ้นอยู่กับว่าข้างในมีอะไร ผลรวมของส่วนประกอบ Superpowers ชุดเริ่มต้นจากผู้ขาย
อธิบาย Agent skills และ MCP server: AGENTS.md เป็นคู่มือที่โหลดไว้ตลอดเวลา, skill เป็นการ์ดสูตรที่โหลดเมื่อต้องใช้, MCP server เป็นเครื่องมือสำหรับ GitHub, เบราว์เซอร์ และเอกสารสด และปลั๊กอินเป็นบันเดิล
สี่องค์ประกอบ เอเจนต์เดียว คู่มือเปิดอยู่เสมอ การ์ดสูตรถูกหยิบออกมาใช้เมื่อจำเป็น และเซิร์ฟเวอร์ MCP คือกุญแจสู่ทุกสิ่งนอกเทอร์มินัล

สารบัญ


ตอนที่ 1 — Agent Skills และเซิร์ฟเวอร์ MCP แบบภาษาคน

ภาพเปรียบเทียบพนักงานใหม่

ลองนึกภาพว่าคุณจ้างคนที่เก่งมากมาคนหนึ่ง ในวันแรกคุณจะให้สามสิ่งกับเขา ได้แก่ คู่มือสั้น ๆ ที่รวบรวมกฎที่ทุกคนปฏิบัติตาม แฟ้มสูตรสำหรับงานที่ทีมของคุณทำในแบบเฉพาะของตัวเอง และชุดกุญแจกับบัตรผ่านเพื่อให้เขาเข้าสู่ระบบที่จำเป็นได้ คุณยังจะยื่นชุดต้อนรับที่รวมสูตรและกุญแจบางส่วนไว้ด้วยกันให้กับบางคนอีกด้วย

เอเจนต์ AI ต้องการสิ่งเดียวกันเป๊ะ และแต่ละชิ้นตอนนี้มีชื่อมาตรฐานแล้ว:

  • คู่มือคือ AGENTS.md (Claude Code เรียกเวอร์ชันของตัวเองว่า CLAUDE.md).
  • สูตรเหล่านั้นคือสกิล
  • กุญแจเหล่านั้นคือเซิร์ฟเวอร์ MCP
  • ชุดต้อนรับคือปลั๊กอินซึ่งในเอเจนต์บางตัวเรียกว่าส่วนขยาย

ส่วนที่เหลือของคู่มือนี้ว่าด้วยสูตรและกุญแจ เพราะความสับสนส่วนใหญ่อยู่ตรงนั้น

สกิลคืออะไร

สกิลคือโฟลเดอร์ ข้างในมีไฟล์ที่จำเป็นหนึ่งไฟล์ คือ SKILL.mdและจะใส่อย่างอื่นที่งานนั้นต้องการเพิ่มก็ได้:

release-notes/
├── SKILL.md          ← required: name, description, instructions
├── references/       ← optional: longer documents, read only when needed
├── scripts/          ← optional: code the agent can run
└── assets/           ← optional: templates, images, data files

กรณี SKILL.md ไฟล์มีส่วนหัวสั้น ๆ อยู่ระหว่าง --- บรรทัด (ส่วนหัวนั้นเรียกว่า front matter) ตามด้วยคำแนะนำแบบธรรมดา:

---
name: release-notes
description: Writes App Store "What's New" notes from recent commits. Use when asked for release notes, a changelog or "what's new" text.
---

# Release notes

1. Read the commits since the last git tag.
2. Keep only changes a user would notice.
3. Write three to five short bullets in plain English, under 400 characters in total.

มาตรฐานเปิดกำหนดไว้สองฟิลด์ โดย ตั้งชื่อ ใช้ได้เฉพาะตัวอักษรพิมพ์เล็ก ตัวเลข และขีดกลาง ยาวได้ไม่เกิน 64 ตัวอักษร และต้องตรงกับชื่อโฟลเดอร์ ส่วน คำอธิบาย มีความยาวได้ถึง 1,024 ตัวอักษร และควรบอกว่าสกิลนี้ทำอะไรและใช้เมื่อไร เพราะคำอธิบายคือสิ่งที่เอเจนต์ใช้ตัดสินใจว่าจะเปิดสกิลขึ้นมาหรือไม่เลย

ทำไมคุณจึงติดตั้งสกิลได้หลายสิบตัว: กลเม็ดสามชั้น

สกิลโหลดเป็นชั้น ๆ ซึ่งมาตรฐานเรียกว่า progressive disclosureลองนึกถึงชั้นหนังสือ:

  1. ปกหลัง เมื่อเริ่มเซสชัน เอเจนต์อ่านเพียงชื่อและคำอธิบายของแต่ละสกิล สเปกจัดสรรไว้ประมาณ 100 โทเคนต่อสกิลสำหรับส่วนนี้ (โทเคนคือประมาณหนึ่งคำสั้น ๆ หรือบางส่วนของคำ เป็นหน่วยที่โมเดลใช้นับหน่วยความจำในการทำงาน)
  2. บท เมื่องานตรงกับคำอธิบาย เอเจนต์จะอ่าน SKILL.mdฉบับเต็มของสกิลนั้น มาตรฐานแนะนำให้เก็บไว้ต่ำกว่า 5,000 โทเคนและ 500 บรรทัด
  3. ภาคผนวก ไฟล์อ้างอิงและสคริปต์จะโหลดก็ต่อเมื่อคำแนะนำชี้ไปที่ไฟล์เหล่านั้น

นั่นคือเหตุผลที่สกิลที่ไม่ได้ใช้ร้อยตัวมีต้นทุนน้อยกว่าคู่มือกฎยาว ๆ เล่มเดียวมาก แต่มันไม่ได้ฟรี: คำอธิบายรวมกันมากขึ้น และเอเจนต์ก็จำกัดขนาดไว้ Codex จำกัดรายการสกิลเริ่มต้นไว้ที่ 2% ของหน่วยความจำทำงานของโมเดล (8,000 ตัวอักษรหากบอกขนาดไม่ได้) และ Claude Code ตัดข้อความรายการของแต่ละสกิลที่ 1,536 ตัวอักษร ติดตั้งเฉพาะสิ่งที่คุณจะใช้

MCP server คืออะไร

MCP หรือ Model Context Protocol เป็นมาตรฐานเปิดสำหรับเชื่อมต่อเอเจนต์ AI เข้ากับเครื่องมือและข้อมูล Anthropic เปิดตัวในเดือนพฤศจิกายน 2024 และมอบให้ Agentic AI Foundation แห่งใหม่ของ Linux Foundation ในเดือนธันวาคม 2025 พร้อมกับ AGENTS.md ของ OpenAI และ goose ของ Block

An เซิร์ฟเวอร์ MCP เป็นโปรแกรมเล็ก ๆ ที่บอกเอเจนต์ของคุณว่า “นี่คือเครื่องมือที่ฉันมีให้” เซิร์ฟเวอร์ GitHub อาจมี create_issue และ search_codeส่วนเซิร์ฟเวอร์เบราว์เซอร์มี navigate และ take_screenshotส่วนเซิร์ฟเวอร์เอกสารมี query_docsเอเจนต์ของคุณคือ MCP client: มันแสดงรายการให้โมเดลเห็น และเมื่อโมเดลต้องการใช้เครื่องมือ เอเจนต์จะตรวจสอบสิทธิ์ของคุณ ขอให้เซิร์ฟเวอร์รันเครื่องมือนั้น แล้วส่งผลลัพธ์กลับไป

เซิร์ฟเวอร์มีสองแบบ:

  • เซิร์ฟเวอร์ภายในเครื่อง ทำงานบนคอมพิวเตอร์ของคุณเอง เอเจนต์เริ่มต้นมันด้วยคำสั่งอย่าง npx @playwright/mcp@latest และสื่อสารกับมันผ่านอินพุตและเอาต์พุตของโปรแกรม (ชื่อทางเทคนิคคือ stdio).
  • เซิร์ฟเวอร์ระยะไกล ทำงานบนคอมพิวเตอร์ของผู้ให้บริการ คุณเชื่อมต่อด้วยที่อยู่เว็บ เช่น https://mcp.context7.com/mcp, และโดยปกติคุณลงชื่อเข้าใช้ผ่านเบราว์เซอร์หรือวาง API key ชื่อทางเทคนิคของการเชื่อมต่อนี้คือ Streamable HTTP.

นี่คือจุดที่ต้องระวัง เครื่องมือทุกตัวมีชื่อ คำอธิบาย และรายการพารามิเตอร์ที่เขียนไว้ให้โมเดลอ่าน หากเอเจนต์ของคุณไม่เลื่อนการโหลดออกไป คำอธิบายเหล่านี้จะเดินทางไปกับทุกคำขอ และเซิร์ฟเวอร์ยี่สิบตัวที่มีเครื่องมือตัวละสิบชิ้นจะทำให้ทุกคำตอบช้าลง แพงขึ้น และโฟกัสน้อยลง ตอนที่ 7 จะแสดงว่าเอเจนต์แต่ละตัวจัดการเรื่องนี้อย่างไร

AGENTS.md และปลั๊กอิน โดยสังเขป

AGENTS.md เป็นไฟล์ Markdown ธรรมดาในโฟลเดอร์รากของโปรเจกต์ที่เอเจนต์อ่านตอนเริ่มทุกเซสชัน: วัตถุประสงค์ของโปรเจกต์ คำสั่งต่าง ๆ และสิ่งที่ต่อรองไม่ได้ OpenCode, Codex, Cursor และ GitHub Copilot อ่านไฟล์นี้โดยตรง ส่วน Claude Code อ่าน CLAUDE.md แทน และเอกสารของมันแนะนำ CLAUDE.md ที่เพียงนำเข้าไฟล์อีกไฟล์ด้วยบรรทัดที่เขียนว่า @AGENTS.md. เพราะมันถูกโหลดทุกครั้ง จงทำให้สั้นเข้าไว้ และย้ายสิ่งที่เฉพาะกับงานไปไว้ในสกิล

ปลั๊กอิน รวมชิ้นส่วนอื่น ๆ เข้าไว้ด้วยกัน ปลั๊กอินของ Claude Code บรรจุสกิล ซับเอเจนต์ ฮุก (สคริปต์ที่ทำงานเมื่อเกิดเหตุการณ์) และเซิร์ฟเวอร์ MCP กับ LSP ได้ Codex, Cursor, GitHub Copilot CLI และ Hermes Agent ก็มีปลั๊กอินเช่นกัน ส่วน Gemini CLI เรียกมันว่าส่วนขยาย ตอนที่ 9 ครอบคลุมเรื่องนี้

อภิธานศัพท์ฉบับพกพา

คำ หมายถึงอะไรในที่นี้
เอเจนต์ (หรือ harness) โปรแกรมที่คุณพูดคุยด้วย: OpenCode, Claude Code, Codex และอื่น ๆ มันรันโมเดล อ่านไฟล์ และเรียกใช้เครื่องมือ
รุ่น AI ที่ทำหน้าที่คิด เช่น GLM, Claude หรือ GPT
หน้าต่างบริบท หน่วยความจำใช้งานของโมเดลสำหรับหนึ่งคำขอ ทุกสิ่งที่คุณโหลดเข้ามาจะแย่งพื้นที่นี้
โทเค็น หน่วยวัดข้อความของโมเดล คือประมาณหนึ่งคำสั้นหรือบางส่วนของคำ
สกิล โฟลเดอร์ที่มี SKILL.md ไฟล์ที่สอนงานหนึ่งอย่างให้เอเจนต์
ฟรอนต์แมตเตอร์ ส่วนหัวที่ด้านบนของ SKILL.md, โดยอยู่ระหว่างสอง --- บรรทัด
เซิร์ฟเวอร์ MCP โปรแกรมที่เสนอเครื่องมือให้เอเจนต์ผ่าน Model Context Protocol
เครื่องมือ หนึ่งการกระทำที่เซิร์ฟเวอร์ MCP เสนอ เช่น create_issue
stdio / Streamable HTTP วิธีที่เอเจนต์สื่อสารกับเซิร์ฟเวอร์ภายในเครื่องและเซิร์ฟเวอร์ระยะไกล
OAuth ขั้นตอน “ลงชื่อเข้าใช้ด้วย…” ในเบราว์เซอร์ของคุณที่มอบโทเคนให้เอเจนต์โดยไม่ต้องวางรหัสผ่าน
ขอบเขตโปรเจกต์ / ขอบเขตทั้งเครื่อง ติดตั้งสำหรับโปรเจกต์เดียว หรือสำหรับทุกโปรเจกต์บนคอมพิวเตอร์ของคุณ
ไฟล์ล็อก ใบรับที่ระบุว่าคุณติดตั้งอะไร จากที่ไหน และลายนิ้วมือของแต่ละสกิล
ซิมลิงก์ ทางลัดไปยังโฟลเดอร์ skills CLI เก็บสำเนาจริงไว้ชุดเดียวและลิงก์เอเจนต์มาที่นั่น

ตอนที่ 2 — สกิล เซิร์ฟเวอร์ MCP หรือ AGENTS.md? แบบทดสอบห้าคำถาม

เมื่อคุณอยากให้เอเจนต์ทำงานบางอย่างได้ดีขึ้น ให้ถามคำถามเหล่านี้ตามลำดับและหยุดที่คำตอบ “ใช่” แรก คำถามข้อ 4 เป็นข้อเดียวที่มีคำถามต่อ:

  1. ต้องใช้กับทุกงานในโปรเจกต์นี้จริงหรือไม่ ใส่ไว้ใน AGENTS.md. “ใช้การสะกดแบบอังกฤษ” และ “รันเทสต์ก่อนบอกว่าเสร็จ” อยู่ในส่วนนี้
  2. ต้อง บังคับใช้, ไม่ใช่แค่แนะนำ? ใช้กฎสิทธิ์หรือฮุก สกิลและ AGENTS.md เป็นเพียงคำสั่ง และโมเดลอาจเพิกเฉยต่อคำสั่งได้ “ห้ามพุชไปที่ main” ต้องมี deny กฎ.
  3. เป็นความรู้ที่สำคัญเฉพาะบางงานหรือไม่ เขียนหรือติดตั้งสกิล ขั้นตอนการออกรีลีส เช็กลิสต์การรีวิว น้ำเสียงของแบรนด์คุณ และเวิร์กโฟลว์แบบเขียนเทสต์ก่อน ล้วนเป็นสกิล
  4. เอเจนต์ต้องการเข้าถึงระบบภายนอกไฟล์แบบเรียลไทม์หรือไม่ รายงานการแครชที่อยู่หลังการล็อกอิน เบราว์เซอร์ที่มันสั่งงานได้ หรือแอปจัดการโปรเจกต์ ถ้าใช่ ให้ถามคำถามข้อ 5 ก่อนจะไปหยิบเซิร์ฟเวอร์มาใช้
  5. มีเครื่องมือบรรทัดคำสั่งที่ดีสำหรับระบบนั้นอยู่แล้วหรือไม่ ถ้าใช่ สกิลที่สอนเอเจนต์ให้ใช้เครื่องมือนั้นมักดีกว่าเซิร์ฟเวอร์: เอเจนต์รู้วิธีรันคำสั่งอยู่แล้ว CLI ไม่มีค่าใช้จ่ายจนกว่าจะถูกใช้ และเอาต์พุตของมันกรองได้ก่อนถึงโมเดล ถ้าไม่มี CLI ที่ดี ถ้าเอเจนต์ของคุณรันคำสั่งไม่ได้ หรือถ้างานนั้นต้องโต้ตอบ (เช่นการสั่งเบราว์เซอร์) ให้เพิ่ม MCP server

นี่คือการทดสอบกับความต้องการในชีวิตประจำวันสิบบรรการ:

คุณอยากให้เอเจนต์… การใช้งาน ทำไม
ใช้การสะกดแบบอังกฤษเสมอ AGENTS.md ใช้กับทุกงาน
ห้ามพุชไปยังสาขา main กฎสิทธิ์ ต้องบังคับใช้ ไม่ใช่แค่แนะนำ
เขียนรีลีสโน้ตในแบบที่คุณชอบ สกิล ความรู้ที่ต้องใช้เป็นครั้งคราว
ทำตามเวิร์กโฟลว์แบบเขียนเทสต์ก่อนอย่างเคร่งครัด สกิล (Superpowers มีอยู่แล้ว) ขั้นตอนสำหรับบางงาน
อ่านและบันทึก GitHub issues สกิลที่สอน ghหรือ MCP server ของ GitHub gh ถูกกว่า ส่วนเซิร์ฟเวอร์เหมาะกับเอเจนต์ที่รันคำสั่งไม่ได้
ค้นหาเอกสารล่าสุดของไลบรารี MCP server (Context7) หรือ CLI ของมันพร้อมสกิล (ctx7) ได้ข้อมูลสดทั้งสองทาง
คลิกไปทั่วเว็บแอปของคุณและจับภาพหน้าจอ MCP เซิร์ฟเวอร์ (Playwright) ต้องมีเบราว์เซอร์ที่ทำงานอยู่ซึ่งเอเจนต์สั่งการได้
ตรวจสอบเหตุขัดข้อง’เมื่อคืน MCP เซิร์ฟเวอร์ (Sentry) ข้อมูลสดที่อยู่เบื้องหลังการเข้าสู่ระบบ
สร้างรายงาน PDF จากเทมเพลตของคุณ สกิลที่มีสคริปต์และเทมเพลตอยู่ข้างใน assets/ ขั้นตอนการทำงานพร้อมเครื่องมือที่มาด้วยกัน
เก็บให้ห่างจาก .env ไฟล์ กฎสิทธิ์ ต้องบังคับใช้

สกิลกับ MCP เซิร์ฟเวอร์ไม่ใช่คู่แข่งกัน การตั้งค่าที่ดีที่สุดบางชุดใช้ทั้งสองอย่างคู่กัน: สกิลอธิบาย เวลา และ อย่างไร วิธีใช้เครื่องมือของเซิร์ฟเวอร์’ และเซิร์ฟเวอร์เป็นผู้ลงมือทำงาน Codex ยังให้สกิลประกาศ MCP เซิร์ฟเวอร์ที่มันพึ่งพาได้ ในช่องตัวเลือก agents/openai.yaml ที่ดาวน์โหลดมา

Skill, MCP server หรือ AGENTS.md: ผังคำถามห้าข้อที่ส่งกฎสำหรับทุกงานไปยัง AGENTS.md, กฎที่ต้องบังคับใช้ไปยังสิทธิ์, องค์ความรู้ไปยัง skill และการเข้าถึงระบบแบบสดไปยัง CLI skill หรือ MCP server
ห้าคำถาม เรียงตามลำดับ คำขอส่วนใหญ่กลายเป็นสกิล เซิร์ฟเวอร์จะคุ้มค่าก็ต่อเมื่อเอเจนต์ต้องการเข้าถึงข้อมูลสดและไม่มีเครื่องมือบรรทัดคำสั่งที่ดีพอ

ตอนที่ 3 — เอเจนต์แต่ละตัวมองหาสกิลที่ไหน

เอเจนต์ทุกตัวค้นหาในพื้นที่สองประเภท โฟลเดอร์โปรเจกต์ อยู่ในรีโพซิทอรีของคุณ สกิลจึงเดินทางไปกับโค้ดและเพื่อนร่วมทีมของคุณก็ได้ไปด้วย โฟลเดอร์ส่วนตัว อยู่ในโฟลเดอร์โฮมของคุณและใช้กับทุกโปรเจกต์บนคอมพิวเตอร์ของคุณ เครื่องมือส่วนใหญ่เรียกการติดตั้งแบบส่วนตัวว่า โกลบอล.

ในปี 2026 เอเจนต์ทั้งหลายมาบรรจบที่ตำแหน่งร่วมกันแห่งเดียว: .agents/skills ในโปรเจกต์ และ ~/.agents/skills ในโฟลเดอร์โฮมของคุณ วางสกิลไว้ที่นั่นแล้วเอเจนต์ส่วนใหญ่จะหาเจอโดยไม่ต้องทำอะไรเพิ่ม

เอเจนต์ โฟลเดอร์โปรเจกต์ โฟลเดอร์ส่วนตัว เรียกใช้สกิลด้วยตัวเอง สิ่งที่ควรรู้
OpenCode .opencode/skills, .agents/skills, .claude/skills ~/.config/opencode/skills, ~/.agents/skills, ~/.claude/skills ระบุ @skill-id ในพรอมต์ของคุณ ID คือชื่อของโฟลเดอร์’ จำกัดการใช้สกิลด้วย skill สิทธิ์
Claude Code .claude/skills ~/.claude/skills /skill-name ไม่อ่าน’ .agents/skills. สกิลของปลั๊กอินแสดงเป็น /plugin-name:skill-name
Codex .agents/skills, ในทุกโฟลเดอร์ตั้งแต่จุดที่คุณเริ่มไปจนถึงรากของรีโพซิทอรี ~/.agents/skills, บวกกับ /etc/codex/skills สำหรับผู้ดูแลระบบ $skill-name, หรือ /skills มีให้ใช้ในตัวพร้อมกับ $skill-installer
Gemini CLI .agents/skills, .gemini/skills ~/.agents/skills, ~/.gemini/skills /skills list; โมเดลจะขออนุญาตคุณก่อนเปิดใช้งาน .agents/skills มีผลเมื่อสกิลสองรายการใช้ชื่อเดียวกัน
Cursor .agents/skills, .cursor/skills (และอ่าน .claude/skills และ .codex/skills) ~/.agents/skills, ~/.cursor/skills /skill-name A พาธ ฟิลด์นี้จำกัดสกิลให้ใช้กับไฟล์ที่ตรงกันเท่านั้น
GitHub Copilot .github/skills, .agents/skills, .claude/skills ~/.copilot/skills, ~/.agents/skills โหลดสกิลเมื่อเกี่ยวข้อง ใช้ได้ใน Copilot CLI, cloud agent และโหมด agent ใน VS Code และ JetBrains
Hermes Agent .hermes/skills, .agents/skills, หลังจากที่คุณรัน hermes skills trust ~/.hermes/skills, บวกกับโฟลเดอร์ใด ๆ ที่ระบุไว้ใน skills.external_dirs /skill-name, และได้สูงสุดห้ารายการติดกัน สแกนทุกการติดตั้งจากฮับเพื่อหาเนื้อหาอันตราย

พาธจากเอกสารของแต่ละเอเจนต์ ณ วันที่ 15 พฤศจิกายน 2026 เอเจนต์เพิ่มตำแหน่งอยู่บ่อย ๆ ถ้าบางอย่างไม่ปรากฏขึ้น ให้ตรวจหน้าสกิลของเอเจนต์คุณ

สามรายละเอียดที่ช่วยลดความสับสน

  • Claude Code เป็นข้อยกเว้น มันอ่านเพียง .claude/skills และ ~/.claude/skills. skills CLI จัดการเรื่องนี้ให้คุณโดยสร้างลิงก์จากโฟลเดอร์ของ Claude Code ไปยังสำเนาที่ใช้ร่วมกัน ถ้าคุณคัดลอกสกิลด้วยมือเอง คุณต้องวางสกิล (หรือ symlink) ไว้ในโฟลเดอร์ของ Claude Code เอง
  • Hermes Agent มีคลังของตัวเอง โฟลเดอร์หลักของมันคือ ~/.hermes/skills. หากต้องการให้มันอ่านโฟลเดอร์ที่ใช้ร่วมกันด้วย ให้เพิ่มไว้ใน ~/.hermes/config.yaml:

yaml skills: external_dirs: - ~/.agents/skills

หรือติดตั้งด้วย skills CLI แล้วใส่ -a hermes-agent. เลือกวิธีเดียว ไม่ใช่ทั้งสองวิธี ไม่อย่างนั้นคุณจะมีทุกสกิลซ้ำสองครั้ง – ชื่อซ้ำกันก่อให้เกิดความประหลาดใจแบบเงียบ ๆ แต่ละเอเจนต์มีกฎของตัวเองว่าสำเนาไหนชนะ OpenCode ลงทะเบียนโฟลเดอร์ตามลำดับตายตัวและตัวสุดท้ายชนะ โดยโฟลเดอร์โปรเจกต์ของคุณ .opencode/skills มาอยู่ท้ายสุด Claude Code ทำตรงกันข้าม: สกิลส่วนตัวชนะสกิลโปรเจกต์ที่ชื่อเดียวกัน Gemini CLI ให้ความสำคัญกับ workspace มากกว่า user และ .agents มากกว่า .gemini, ส่วน Codex แค่แสดงทั้งสองอย่าง วิธีแก้มันน่าเบื่อแต่เชื่อถือได้: อย่าเก็บสกิลสองตัวที่ชื่อเดียวกัน

OpenCode มีของแถมสองอย่างที่น่ารู้ ไฟล์ Markdown เดี่ยว ๆ ที่อยู่บนสุดของโฟลเดอร์สกิล (เช่น skills/review.md) ก็นับเป็นสกิลด้วย และ สกิล อาร์เรย์ใน opencode.jsonc สามารถเพิ่มโฟลเดอร์เพิ่มเติมหรือแม้แต่แคตตาล็อกสกิลบนเว็บได้ คู่มือ OpenCode ของผม อธิบายสิทธิ์การใช้งานสกิลไว้ละเอียดยิ่งขึ้น

ที่ที่ AI agent มองหา skill: โฟลเดอร์ .agents/skills ที่ใช้ร่วมกันซึ่ง Codex, OpenCode, Cursor, Gemini CLI และ GitHub Copilot อ่าน พร้อมลิงก์สำหรับ .claude/skills ของ Claude Code และ ~/.hermes/skills ของ Hermes Agent
โฟลเดอร์ที่แชร์ร่วมกันโฟลเดอร์เดียวครอบคลุมเอเจนต์ส่วนใหญ่ Claude Code ต้องมีลิงก์เสมอ และ Hermes Agent ต้องมีลิงก์สำหรับสกิลส่วนกลาง CLI ของสกิลจะสร้างทั้งสองอย่างให้

ตอนที่ 4 — CLI ของ สกิล สกิล: npm สำหรับ Agent Skills ทีละขั้นตอน

คุณติดตั้งสกิลได้ด้วยการคัดลอกโฟลเดอร์ไปมา และถ้ามีสักหนึ่งหรือสองอันก็ไม่เป็นไร แต่ถ้าเกินกว่านั้น คุณควรใช้ตัวจัดการแพ็กเกจ สิ่งที่รู้ว่าแต่ละเอเจนต์มองหาที่ไหน เก็บสำเนาไว้ชุดเดียวแทนที่จะเป็นห้าชุด จำได้ว่าทุกสกิลมาจากไหน และบอกคุณได้เมื่อมีเวอร์ชันใหม่กว่า นั่นคือสิ่งที่ สกิล ทำหน้าที่นี้ มันคือเครื่องมือบรรทัดคำสั่งโอเพนซอร์ส (MIT) จาก Vercel Labs คุณรันมันด้วย npx skillsและไดเรกทอรีสกิลสาธารณะของมันอยู่ที่ skills.sh.

ข้อเท็จจริงที่สำคัญ ณ วันที่ 15 พฤศจิกายน 2026:

  • เวอร์ชัน 1.8.1เปิดตัวเมื่อวันที่ 11 พฤศจิกายน มันเคลื่อนเร็วมาก: จาก 1.7.5 ถึง 1.8.1 ใช้เวลาเก้าวัน
  • ต้องใช้ Node.js 22.20 หรือใหม่กว่า
  • รองรับเอเจนต์ 79 ตัวรวมถึง OpenCode, Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot และ Hermes Agent
  • ติดตั้งได้จาก GitHub (owner/repo), GitLab, Azure Repos, ที่อยู่ Git ใด ๆ, โฟลเดอร์ในเครื่อง หรือลิงก์ดาวน์โหลดตรงไปยัง SKILL.md หรือไฟล์อาร์ไคฟ์

ขั้นที่ 0 — ตรวจสอบ Node.js และขอเวอร์ชันล่าสุดเสมอ

node --version      # ต้องใช้ v22.20.0 หรือใหม่กว่า

ถ้าคำสั่งนั้นแสดงเวอร์ชันเก่าหรือ “command not found” ให้ติดตั้งรุ่น LTS ปัจจุบันจาก nodejs.org. บน Mac ที่ใช้ Homebrew, brew install node ก็ใช้ได้เช่นกัน บน Raspberry Pi เวอร์ชันในรายการแพ็กเกจของระบบปฏิบัติการเองมักเก่าเกินไป ให้ใช้ตัวติดตั้งที่ลิงก์จากหน้าเดียวกันนั้น

จากนั้นทำให้เป็นนิสัยอัตโนมัติสักอย่าง: พิมพ์ npx skills@latest แทนที่จะพิมพ์แค่ npx skills สำหรับทุกอย่างที่ตรวจสอบหรืออัปเดต การพิมพ์แค่ npx อาจใช้สำเนาที่ดาวน์โหลดไว้เมื่อหลายสัปดาห์ก่อนซ้ำ และกับเครื่องมือนี้ เวอร์ชันที่คุณรันเปลี่ยนสิ่งที่คำสั่งทำ (ตอนที่ 5 อธิบายตัวอย่างที่ใหญ่ที่สุด)

ขั้นที่ 1 — ดูให้ดีก่อนติดตั้ง

npx skills@latest add vercel-labs/agent-skills --list

--list แสดงทุกสกิลในรีโพซิทอรีพร้อมคำอธิบาย และไม่ติดตั้งอะไรเลย จากนั้นเปิดรีโพซิทอรีในเบราว์เซอร์ของคุณและอ่าน SKILL.md ของทุกอย่างที่คุณกำลังจะติดตั้ง รวมถึงสคริปต์ใด ๆ ที่อยู่ข้าง ๆ บน skills.sh หน้าของแต่ละสกิลยังแสดงผลการตรวจสอบความปลอดภัยด้วย (ตอนที่ 11)

ขั้นที่ 2 — ติดตั้งสกิลสำหรับเอเจนต์ที่คุณใช้

# หนึ่งสกิล สำหรับ OpenCode และ Claude Code ในโปรเจกต์ปัจจุบัน
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a opencode -a claude-code

# สกิลเดียวกันสำหรับทุกโปรเจกต์บนคอมพิวเตอร์เครื่องนี้
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -g -a opencode -a claude-code

# ปักหมุดแท็ก release หรือ commit เต็ม ๆ เพื่อให้การอัปเดตเป็นไปอย่างตั้งใจ
npx skills add owner/[email protected] --skill my-skill

ถ้าไม่ใส่ --skill และ -a และ CLI ของสกิลจะถามคุณแบบโต้ตอบ: สกิลไหน เอเจนต์ตัวไหน และจะลิงก์หรือคัดลอก นี่คือที่ที่ทุกอย่างจะไปลงเอย:

ขอบเขต สำเนาจริงชุดเดียว ลิงก์สำหรับเอเจนต์ที่มีโฟลเดอร์ของตัวเอง บันทึกสิ่งที่คุณติดตั้งไว้
โปรเจกต์ (ค่าเริ่มต้น) ./.agents/skills/<name> เช่น ./.claude/skills/<name> สำหรับ Claude Code ./skills-lock.json
โกลบอล (-g) ~/.agents/skills/<name> เช่น ~/.claude/skills/<name>, ~/.hermes/skills/<name> ~/.agents/.skill-lock.json

CLI เก็บ สำเนาจริงไว้ชุดเดียว ใน .agents/skillsซึ่งเอเจนต์ส่วนใหญ่อ่านโดยตรง และสร้าง ลิงก์ (symlink ซึ่งก็คือทางลัด) สำหรับเอเจนต์ที่ไปมองหาที่อื่น สำเนาเดียวหมายถึงอัปเดตครั้งเดียว หากระบบของคุณจัดการ symlink ได้ไม่ดี ซึ่งเกิดขึ้นได้บน Windows ให้เพิ่ม --copy เพื่อให้ได้สำเนาแยกอิสระแทน

ขั้นที่ 3 — ดูว่ามีอะไรติดตั้งอยู่

npx skills ls              # this project's skills
npx skills ls -g           # your global skills
npx skills ls -a opencode  # only what OpenCode gets
npx skills ls --json       # machine-readable, for scripts

สำหรับสกิลระดับโปรเจกต์ เวอร์ชันปัจจุบันยังแสดงสถานะด้วย: ติดตามแล้ว (ตรงกับไฟล์ล็อก) ถูกแก้ไข (คุณหรือเอเจนต์แก้ไขเอง) ไม่ถูกติดตาม (ไม่มีรายการในไฟล์ล็อก เช่น สกิลที่คุณเขียนเอง) หรือ หายไป (อยู่ในไฟล์ล็อกแต่ไม่มีอยู่ในดิสก์)

ขั้นที่ 4 — ค้นหาสกิล

npx skills find                    # interactive search
npx skills find seo                # search by keyword
npx skills find react --owner vercel   # only one organisation's repositories

หรือเรียกดู skills.shซึ่งจัดอันดับสกิลตามจำนวนการติดตั้งและจัดกลุ่มตามหัวข้อ สกิลที่ถูกติดตั้งมากที่สุดในขณะนี้คือ find-skills จากรีโพของ Vercel เอง ซึ่งสอนเอเจนต์ของคุณให้ค้นหาสกิลได้ด้วยตัวเอง จำนวนการติดตั้งเปลี่ยนทุกวัน จึงควรถือว่าอันดับเป็นเพียงคำใบ้ ไม่ใช่บทวิจารณ์

ขั้นที่ 5 — ลองใช้สกิลโดยไม่ต้องติดตั้ง

npx skills use vercel-labs/agent-skills@web-design-guidelines

คำสั่งนี้พิมพ์พรอมต์สำเร็จรูปสำหรับสกิลนั้นออกมา ซึ่งคุณสามารถต่อท่อหรือวางลงในเอเจนต์บนคอมพิวเตอร์เครื่องเดียวกันได้ เพิ่ม --agent claude-code แล้ว CLI จะเปิด Claude Code พร้อมโหลดสกิลนั้นไว้ เป็นวิธีที่ดีในการทดสอบสกิลก่อนที่มันจะกลายเป็นส่วนหนึ่งของการตั้งค่าของคุณ

ขั้นที่ 6 — ลบสกิล

npx skills remove web-design-guidelines            # from this project
npx skills rm --global web-design-guidelines       # from your global skills
npx skills remove --agent claude-code my-skill     # from one agent only
npx skills remove vercel-labs/agent-skills         # everything from that source
npx skills remove                                  # pick from a list

npx skills remove --all ลบทุกสกิล ที่บันทึกไว้ในไฟล์ล็อก และข้ามโฟลเดอร์ที่มันไม่ได้ติดตั้ง เช่น สกิลที่คุณเขียนเอง จึงไม่ลบผลงานของคุณ

ขั้นที่ 7 — สร้างของคุณเอง

npx skills init my-skill สร้าง my-skill/SKILL.md จากเทมเพลต ส่วนที่ 10 พาดูตัวอย่างที่สมบูรณ์

เครื่องมือทั้งหมดในใบเดียว

ฉันต้องการ… คำสั่ง
ดูว่ารีโพมีอะไรให้บ้าง npx skills@latest add owner/repo --list
ติดตั้งสกิลหนึ่งรายการลงในโปรเจกต์นี้ npx skills add owner/repo --skill name
ติดตั้งสำหรับทุกโปรเจกต์ add -g
เลือกเอเจนต์ add -a opencode -a claude-code (หรือ --agent '*' สำหรับทั้งหมด)
ติดตั้งโดยไม่ถามอะไรเลย add -y
ปักหมุดเวอร์ชัน npx skills add owner/[email protected] --skill name
แสดงรายการสกิลที่ติดตั้งแล้ว npx skills ls · npx skills ls -g
ค้นหา npx skills find keyword
ตรวจสอบอัปเดต (อ่านเท่านั้น) npx skills@latest check · add -g หรือ -p
ติดตั้งอัปเดต npx skills update · -g · -p · -y · หรือระบุชื่อสกิล
ถอดออก npx skills remove name · add -g สำหรับโกลบอล
กู้คืนสกิลของโปรเจกต์จากไฟล์ล็อกของมัน npx skills install
เริ่มสกิลใหม่ npx skills init name

คำสั่งสำหรับ skills 1.8.1 npx skills install (นามแฝงของ experimental_install) และ experimental_sync คำสั่งสำหรับสกิลที่จัดส่งอยู่ในแพ็กเกจ npm ถูกทำเครื่องหมายว่าเป็นการทดลองและอาจเปลี่ยนแปลงได้

ชีตสรุป npx skills CLI: คำสั่ง add, list, find, use, check, update, remove และ init พร้อมแฟล็กที่มีประโยชน์ที่สุด ตำแหน่งติดตั้งระดับโปรเจกต์และระดับ global และไฟล์ล็อกสองไฟล์
skills CLI ในใบเดียว สองนิสัยทำงานส่วนใหญ่ให้เสร็จ: --list ก่อนที่คุณจะติดตั้ง และ @latest ทุกครั้งที่คุณตรวจสอบหรืออัปเดต

ไฟล์ล็อกคืออะไร และฉันควรคอมมิตมันหรือไม่

ไฟล์ล็อกคือใบเสร็จ สำหรับทุกสกิล มันบันทึกว่ามาจากไหนและมี ลายนิ้วมือ ของโฟลเดอร์ (ในทางเทคนิคคือแฮช: รหัสสั้น ๆ ที่เปลี่ยนทุกครั้งเมื่อไฟล์ใด ๆ ในโฟลเดอร์เปลี่ยน) CLI เก็บไว้สองแบบ:

  • skills-lock.json ในโปรเจกต์ คอมมิตมันเข้า Git บนคอมพิวเตอร์เครื่องอื่น หรือสำหรับเพื่อนร่วมทีม npx skills install จะกู้คืนสกิลชุดเดียวกันเป๊ะ และ --frozen-lockfile (ค่าเริ่มต้นใน CI) จะไม่ยอมทำต่อหากมีอะไรแตกต่าง สิ่งนี้ทำให้สกิลของโปรเจกต์ทำซ้ำได้เหมือนกับที่ package-lock.json ทำกับโค้ด
  • ~/.agents/.skill-lock.json สำหรับสกิลโกลบอลของคุณ มันเป็นของบัญชีผู้ใช้ของคุณ (หรืออยู่ที่ $XDG_STATE_HOME/skills/.skill-lock.json หากคุณได้ตั้งค่าตัวแปรนั้นไว้) อย่าแก้ไขไฟล์นี้ด้วยมือ และโปรดทราบว่าผู้ใช้แต่ละคนบนคอมพิวเตอร์ต่างมีไฟล์ของตนเอง ซึ่งสำคัญในส่วนที่ 6

เทเลเมทรี โดยย่อ

CLI ส่งข้อมูลการใช้งานแบบไม่ระบุตัวตน ตามเอกสารประกอบของมัน ชื่อรีโพซิทอรีบน GitHub และชื่อสกิลจะถูกระบุก็ต่อเมื่อ GitHub ยืนยันว่ารีโพซิทอรีนั้นเป็นสาธารณะ แหล่งข้อมูลชนิดอื่นก็อาจถูกระบุชื่อได้เช่นกัน หากต้องการปิด ให้เพิ่ม export DISABLE_TELEMETRY=1 (หรือ DO_NOT_TRACK=1) ลงในโปรไฟล์เชลล์ของคุณ การทำเช่นนี้ยังปิดการค้นหาการตรวจสอบความปลอดภัยที่ CLI ทำกับสกิลสาธารณะด้วย ดังนั้นคุณต้องตัดสินใจว่าอะไรสำคัญกับคุณมากกว่า

ตัวติดตั้งอื่น ๆ ที่คุณจะได้พบ

CLI สำหรับสกิลไม่ใช่วิธีเดียวในการติดตั้ง เอเจนต์และเครื่องมือหลายตัวมีตัวติดตั้งของตนเอง และทั้งหมดทำตามมาตรฐานเปิดเดียวกัน:

เครื่องมือ ตัวอย่าง น่ารู้ไว้
GitHub CLI (gh skill, เวอร์ชัน 2.90 ขึ้นไป, อยู่ในสถานะพรีวิว) gh skill install owner/repo skill-name --agent claude-code gh skill preview แสดงสกิลให้ดูก่อนที่คุณจะติดตั้ง; --pin ล็อกเวอร์ชันไว้
Hermes Agent hermes skills install <identifier> ฮับของมันมี skills.sh อยู่ด้วย และทุกการติดตั้งจะผ่านการสแกนความปลอดภัย
Gemini CLI gemini skills install <git-url> --scope workspace สำหรับโปรเจกต์เดียว; จะขอความยินยอม เว้นแต่คุณจะส่ง --consent
Codex $skill-installer <name> สกิลระบบที่มีมาให้ในตัว
Claude Code /plugin install name@marketplace ปลั๊กอินรวมสกิลไว้พร้อมเซิร์ฟเวอร์ MCP และฮุก (ส่วนที่ 9)

มีกฎข้อเดียวที่ช่วยลดปัญหาปวดหัวได้เกือบทั้งหมด: อัปเดตสกิลด้วยเครื่องมือตัวเดียวกับที่คุณใช้ติดตั้งสกิลนั้น ตัวติดตั้งแต่ละตัวเก็บบันทึกของตัวเอง และไม่มีตัวใดรู้ว่าตัวอื่นทำอะไรไปบ้าง


ตอนที่ 5 — “ชุดสกิลของฉันอัปเดตเมื่อสองวันก่อน แล้วฉันจะรู้ได้อย่างไรว่ามีแล้ว?”

นั่นคือคำถามของผมเป๊ะ ๆ ตอนที่ Superpowers, ไลบรารีสกิลยอดนิยมของ Jesse Vincent ประกาศอัปเดต npx skills ls แสดงเฉพาะชื่อ ไม่ระบุเวอร์ชัน จึงบอกคุณไม่ได้ นี่คือวิธีที่ CLI รู้ได้จริง ๆ

การตรวจสอบทำงานอย่างไร

เมื่อคุณติดตั้งสกิล CLI จะเก็บลายนิ้วมือของโฟลเดอร์นั้นไว้ในไฟล์ล็อก เมื่อคุณตรวจสอบ มันจะถามแหล่งที่มา (โดยปกติคือ GitHub) ถึงลายนิ้วมือของโฟลเดอร์เดียวกันในวันนี้ ลายนิ้วมือเหมือนกัน: เป็นเวอร์ชันล่าสุด ต่างกัน: มีอัปเดต มันไม่เปรียบเทียบหมายเลขเวอร์ชันหรือวันที่ ซึ่งเป็นเหตุผลที่มันใช้ได้แม้กับสกิลที่ไม่มีทั้งสองอย่าง

cd /tmp                        # or a project folder, but never your home folder
npx skills@latest check -g     # your global skills

cd ~/code/my-app
npx skills@latest check -p     # this project's skills

ผลลัพธ์ทั่วไปใน 1.8.1 จะมีลักษณะดังนี้:

↑ brainstorming has an update
↑ writing-plans has an update
2 skill(s) can be updated; run npx skills update to install

check ยังรายงานสกิลของโปรเจกต์ที่ไฟล์ไม่ตรงกับไฟล์ล็อกอีกด้วย (มีการเปลี่ยนแปลงในเครื่อง), และจะออกด้วยรหัสข้อผิดพลาดเมื่อมีสิ่งใดล้าสมัยหรือถูกแก้ไข คุณจึงใช้มันหยุดบิลด์ CI ที่เพี้ยนไปได้

check มีการเปลี่ยนแปลงในเดือนพฤศจิกายน ดังนั้นให้ใช้เวอร์ชันล่าสุด

ตั้งแต่เวอร์ชัน 1.7.5 (2 พฤศจิกายน 2026) เป็นต้นมา check จะรายงานเท่านั้น ในเวอร์ชันก่อนหน้า ตั้งแต่ 1.5.18 เป็นอย่างน้อยจนถึง 1.7.4 check เป็นเพียงอีกชื่อหนึ่งของ update: มันถามว่า “Update scope?” แล้วติดตั้งอัปเดตไปพร้อมกัน ถ้าคุณเคยใช้ npx skills check ก่อนเดือนพฤศจิกายนแล้วสงสัยว่าทำไมมันถึง “อัปเดต” อะไรบางอย่าง นั่นคือเหตุผล ใช้ npx skills@latest check แล้วคุณจะได้พฤติกรรมแบบอ่านอย่างเดียว

อีกสองรายละเอียดที่มักทำให้คนพลาด:

  • check จะเลือกขอบเขตใดขอบเขตหนึ่งเองโดยอัตโนมัติ ถ้าโฟลเดอร์ที่คุณอยู่มี skills-lock.json ไฟล์ หรือมี .agents/skills โฟลเดอร์ที่มีสกิลอยู่ข้างใน มันจะตรวจ โปรเจกต์ สกิล มิฉะนั้นจะตรวจ โกลบอล แทน เพิ่ม -g หรือ -p เพื่อระบุว่าคุณหมายถึงอันไหน
  • ไม่มีตัวเลือก “อัปเดตทุกอย่างจากรีโปเดียว” อัปเดตทุกอย่างในขอบเขตหนึ่ง หรือระบุชื่อสกิล

จากนั้นอัปเดต

npx skills update                      # asks: project, global or both
npx skills update -g                   # all global skills
npx skills update -p                   # all project skills
npx skills update brainstorming writing-plans -g   # just these
npx skills update -y                   # no questions: project if you're in one, else global

อ่านการเปลี่ยนแปลงก่อนอัปเดตอะไรที่สำคัญ เปิดประวัติคอมมิตของรีโปบน GitHub แล้วดูว่าเปลี่ยนอะไรในโฟลเดอร์สกิลบ้าง: การอัปเดตคือคำสั่งใหม่ที่เอเจนต์ของคุณจะทำตามด้วยสิทธิ์ของคุณ

ถ้าคุณติดตั้งเป็นปลั๊กอิน ให้อัปเดตผ่านปลั๊กอิน

ชุดสกิลจำนวนมากตอนนี้แจกจ่ายเป็นปลั๊กอิน และ Superpowers คือตัวอย่างที่ดี README ของมันระบุวิธีติดตั้งที่ต่างกันสำหรับเอเจนต์แทบทุกตัว:

เอเจนต์ วิธีติดตั้ง Superpowers ตาม README ของมัน วิธีอัปเดต
Claude Code /plugin install superpowers@claude-plugins-official โดยอัตโนมัติ จากมาร์เก็ตเพลสอย่างเป็นทางการของ Anthropic
Codex CLI /plugins, ค้นหา “superpowers”, ติดตั้งปลั๊กอิน ผ่านตัวจัดการปลั๊กอิน
Cursor /add-plugin superpowers ในแชต Agent ผ่านตัวจัดการปลั๊กอิน
Gemini CLI gemini extensions install https://github.com/obra/superpowers gemini extensions update superpowers
GitHub Copilot CLI copilot plugin marketplace add obra/superpowers-marketplaceแล้ว copilot plugin install superpowers@superpowers-marketplace ผ่านตัวจัดการปลั๊กอิน
Hermes Agent hermes plugins install obra/superpowers --enable ผ่านตัวจัดการปลั๊กอิน
OpenCode เพิ่ม "superpowers@git+https://github.com/obra/superpowers.git" ไปยัง ปลั๊กอิน รายการใน opencode.json, ตามที่คู่มือติดตั้ง OpenCode ของมันอธิบายไว้ เมื่อรีสตาร์ท ให้ล้างแคชแพ็กเกจของ OpenCode ถ้าเวอร์ชันใหม่ไม่ปรากฏ หรือเพิ่ม #v5.0.3แท็กในแบบ -style เพื่อปักหมุดเวอร์ชัน

จาก README ของ Superpowers และคู่มือติดตั้ง OpenCode ของมัน ตรวจสอบเมื่อ 15 พฤศจิกายน 2026

ผมติดตั้ง Superpowers บน Mac ของผมด้วย npx skills -g, ดังนั้นของผมจึงอัปเดตผ่าน skills CLI นั่นโอเค สิ่งที่ไม่โอเคคือการติดตั้งแพ็กเดียวกันผ่านสองช่องทาง คุณจะได้สำเนาสองชุดของทุกสกิลภายใต้ชื่อเดียวกัน และไม่มีทางรู้ว่าเอเจนต์จะเลือกอันไหน

การทำงานของ npx skills check: ไฟล์ล็อกเก็บลายนิ้วมือของแต่ละโฟลเดอร์ skill, check จะนำไปเทียบกับโฟลเดอร์เดียวกันที่ upstream แล้วรายงานการอัปเดต ส่วน update จะติดตั้งให้
check เปรียบเทียบลายนิ้วมือ ไม่ใช่หมายเลขเวอร์ชัน ตั้งแต่ 1.7.5 เป็นต้นมา มันเพียงรายงาน; update คือคำสั่งที่ทำให้เกิดการเปลี่ยนแปลง

ตอนที่ 6 — ห้าปัญหาจริงจาก Mac และ Raspberry Pi ของฉัน พร้อมวิธีแก้

ทุกเรื่องในส่วนนี้เกิดขึ้นกับผมในช่วงฤดูร้อนปี 2026 บน CLI เวอร์ชัน 1.5 ปัญหาแต่ละข้อได้รับการตรวจสอบกับซอร์สโค้ดของรีลีสปัจจุบัน 1.8.1 แล้ว คุณจึงรู้ได้ว่าข้อไหนแก้แล้วและข้อไหนยังกัดอยู่ เอาต์พุตในเทอร์มินัลเป็นของจริง ผมย่อให้สั้นลงและลบชื่อเครื่องออก

ปัญหา 1: “สกิลโกลบอลทั้งหมดเป็นเวอร์ชันล่าสุด” ทั้งที่ไม่ได้ตรวจอะไรเลย

บน Mac ของผม, npx skills check ให้ผลลัพธ์แบบนี้:

graham@mac my-app % npx skills check
◇  Update scope
│  Both
Checking for skill updates…
Global Skills
Checking skills from source: anthropics/skills
│  GitHub API request limit reached; checking existing gh authentication…
  ✗ Failed to fetch tree for anthropics/skills
Checking skills from source: vercel-labs/skills
  ✗ Failed to fetch tree for vercel-labs/skills
…                                  (six more sources, every one ✗)
Checking skills from source: obra/superpowers
  ✗ Failed to fetch tree for obra/superpowers
✓ All global skills are up to date

เกิดอะไรขึ้น ในการตรวจรีโพซิทอรี CLI จะถาม API ของ GitHub ขอรายการไฟล์ของรีโพซิทอรีนั้น GitHub อนุญาต คำขอแบบไม่ระบุตัวตน 60 ครั้งต่อชั่วโมง ต่อที่อยู่ไอพี และโควตาของผมในชั่วโมงนั้นหมดไปแล้ว (เครื่องมือบอกไว้ในบรรทัดแรก) การค้นหาจึงล้มเหลวทั้งหมด บรรทัดสุดท้ายนับเฉพาะการอัปเดตที่เครื่องมือ พบ, และมันไม่พบเลย จึงพิมพ์เครื่องหมายถูกสีเขียว เวอร์ชันเก่ายังพยายามยืมล็อกอินของ GitHub CLI อยู่เบื้องหลังด้วย (นั่นคือบรรทัด “checking existing gh authentication”) เนื่องจากทุกคำขอยังล้มเหลว แสดงว่าไม่มีล็อกอินให้ยืม

แก้แล้วหรือยัง บางส่วน เวอร์ชัน 1.8.1 พยายามมากขึ้นก่อนจะยอมแพ้: แบบไม่ระบุตัวตนก่อน จากนั้นใช้โทเคนจากสภาพแวดล้อมของคุณ แล้วจึงใช้ล็อกอินของ GitHub CLI เองผ่าน gh api, และสำหรับการตรวจอัปเดตก็ใช้การดาวน์โหลด Git ธรรมดาเป็นทางเลือกสุดท้าย แต่ซอร์สโค้ด 1.8.1 แสดงว่าเมื่อยังตรวจแหล่งหนึ่งไม่ได้ บรรทัดสรุปยังนับเฉพาะการอัปเดตที่พบ เครื่องหมายถูกสีเขียวใต้กากบาทสีแดงยังเกิดขึ้นได้ ดังนั้นอ่านบรรทัดที่มี ✗ ด้วย

วิธีแก้ ให้ CLI มีล็อกอิน ซึ่งจะเพิ่มขีดจำกัดเป็น 5,000 คำขอต่อชั่วโมง:

  1. ง่ายที่สุด: ติดตั้ง GitHub CLI แล้วรัน gh auth loginเวอร์ชันปัจจุบันของ skills CLI จะเรียก gh ให้ทำการเรียก API และไม่เห็นข้อมูลรับรองของคุณเลย
  2. หรือใช้โทเคน: สร้าง personal access token แบบละเอียด (fine-grained) ที่เข้าถึงรีโพสาธารณะได้แบบอ่านอย่างเดียว จากนั้นเพิ่มลงใน shell profile ของคุณ (~/.zshrc บน Mac, ~/.bashrc บน Raspberry Pi):

bash export GITHUB_TOKEN="github_pat_…" # read-only, public repositories

จากนั้นเปิดเทอร์มินัลใหม่ ปฏิบัติกับโทเคนนี้เหมือนรหัสผ่าน: อย่าวางลงในแชต สกิล หรือไฟล์ที่คุณคอมมิต 3. อัปเกรดแล้วตรวจสอบอีกครั้ง: npx skills@latest check -g.

ปัญหา 2: sudo ทำให้ผมมีที่เก็บสกิลสองแห่งและเจอ error ของ npm

บน Raspberry Pi ของผม ผมติดนิสัยพิมพ์ sudo su ก่อน นี่คือสิ่งที่มันให้ออกมา:

graham@pi:~ $ sudo su
root@pi:/home/graham# npx skills update
npm error config prefix cannot be changed from project config: /home/graham/.npmrc.
◇  Update scope
│  Both
Checking for skill updates…
Global Skills
…
Found 6 global update(s)
…
Project Skills
Updating for: Universal, Claude Code, Hermes Agent
Refreshing 7 skill(s)…

และอีกสักครู่ กลับมาเป็นผู้ใช้ปกติของผม:

graham@pi:~ $ ls ~/.agents/skills | wc -l
7
graham@pi:~ $ sudo ls /root/.agents/skills | wc -l
37

เกิดอะไรขึ้น sudo su เปลี่ยนคุณเป็น root และ root มีโฮมโฟลเดอร์ของตัวเอง /root. สกิลถูกเก็บแยกตามผู้ใช้ สกิลโกลบอลของ root จึงอยู่ใน /root/.agents/skills และของผมอยู่ใน /home/graham/.agents/skills. ทุกการติดตั้งแบบโกลบอลที่ผมเคยทำในฐานะ root ได้เข้าไปอยู่ในที่เก็บของ root: ที่นั่นมี 37 สกิล ของผมมี 7 สกิล หากเอเจนต์ของคุณรันในฐานะผู้ใช้ปกติของคุณ ซึ่งเป็นรูปแบบปกติ ทุกอย่างในที่เก็บของ root จะมองไม่เห็นสำหรับเอเจนต์เหล่านั้น

error ของ npm มีสาเหตุเดียวกัน ในฐานะ root ไฟล์การตั้งค่าส่วนตัวของ npm คือ /root/.npmrcดังนั้น /home/graham/.npmrc ที่อยู่ในโฟลเดอร์ที่ผมยืนอยู่ถูกอ่านเป็น โปรเจกต์ ไฟล์การตั้งค่าแทน โค้ดของ npm เองไม่ยอมให้ไฟล์ของโปรเจกต์เปลี่ยน การตั้งค่า prefix และบันทึก error นั้นไว้ตรง ๆ ยังมีความเสี่ยงที่สามที่คุณจะไม่เห็นในทันที: อะไรก็ตามที่ root เขียนลงในโฮมโฟลเดอร์ของคุณจะกลายเป็นกรรมสิทธิ์ของ root และผู้ใช้ปกติของคุณจะอัปเดตมันไม่ได้ในภายหลัง

วิธีแก้

  1. ออกจาก root: type exit. จากนี้ไป ให้รัน CLI และเอเจนต์ของคุณในฐานะตัวคุณเอง
  2. หาว่าเอเจนต์ของคุณใช้ผู้ใช้คนไหน โฮมโฟลเดอร์ใดก็ตามที่มีการตั้งค่าของเอเจนต์เหล่านั้นคือโฟลเดอร์ที่สำคัญ:

bash ls -d ~/.claude ~/.config/opencode ~/.hermes 2>/dev/null sudo ls -d /root/.claude /root/.config/opencode /root/.hermes 2>/dev/null

  1. ติดตั้งสกิลของ root ใหม่ในฐานะตัวคุณเอง จากแหล่งต้นทางเดิม การคัดลอกไฟล์ข้ามมาจะพากรรมสิทธิ์ของ root และบันทึกที่ค้างอยู่มาด้วย การติดตั้งใหม่จะเขียน lock file ที่สะอาด ก่อนอื่นให้แสดงรายการแหล่งที่ root ใช้:

bash sudo grep '"source"' /root/.agents/.skill-lock.json | sort -u

จากนั้น จากโฟลเดอร์โปรเจกต์หรือ /tmpให้รัน npx skills add <owner/repo> -g -a <your agents> สำหรับแต่ละรายการที่คุณยังต้องการ 4. คืนโฟลเดอร์ของคุณให้ตัวเองเผื่อว่า root เขียนอะไรลงไป:

bash sudo chown -R "$(id -un)":"$(id -gn)" ~/.agents ~/.claude ~/.hermes ~/.config/opencode 2>/dev/null

  1. เฉพาะเมื่อทุกอย่างทำงานได้ในฐานะผู้ใช้ของคุณ ลบสำเนาของ root ด้วย sudo rm -rf /root/.agents.

ถ้าคุณใช้ sudo เพราะการติดตั้ง npm แบบโกลบอลจะล้มเหลวถ้าไม่มีมัน ให้แก้ที่ต้นเหตุแทน: ชี้คำนำหน้า (prefix) ของ npm ไปยังโฟลเดอร์ที่คุณเป็นเจ้าของ (npm config set prefix ~/.npm-globalแล้วเพิ่ม ~/.npm-global/bin ลงใน PATH). นั่นเกือบแน่นอนคือสิ่งที่ การตั้งค่า prefix บรรทัดในไฟล์ .npmrc ของฉันกำลังทำอยู่

ปัญหา 3: รันจากโฟลเดอร์โฮมของคุณ แล้วมันจะกลายเป็น “โปรเจกต์”

กลับมาในฐานะตัวฉันเอง ในโฟลเดอร์โฮม:

graham@pi:~ $ npx skills check
Need to install the following packages:
[email protected]
Ok to proceed? (y) y
…
Global Skills
No global skills tracked in lock file.
Install skills with npx skills add <package> -g
Project Skills
Updating for: Universal, Claude Code, Hermes Agent
Refreshing 7 skill(s)…

เกิดอะไรขึ้น CLI ตัดสินว่าโฟลเดอร์หนึ่งเป็นโปรเจกต์ถ้ามันมี skills-lock.json ไฟล์ หรือ .agents/skills โฟลเดอร์ที่มีสกิลอยู่ข้างใน โฟลเดอร์โฮมของคุณมี ~/.agents/skillsเพราะนั่นคือที่ที่สกิลโกลบอลอาศัยอยู่ ดังนั้นจาก ~ CLI จึงมองเห็นเป็นโปรเจกต์ และถ้าคุณเคยรัน npx skills add ในโฟลเดอร์โฮมของคุณ โดยไม่ต้อง -gคุณก็สร้างการติดตั้งแบบโปรเจกต์จริง ๆ ไว้ที่นั่น พร้อมกับ ~/skills-lock.json, ซึ่งโฟลเดอร์สกิลของมันคือโฟลเดอร์เดียวกับที่การติดตั้งแบบโกลบอลใช้ นั่นคือสิ่งที่เกิดขึ้นบน Pi ของฉัน: สกิลเจ็ดตัวถูกติดตามในฐานะ “โปรเจกต์” ในโฟลเดอร์โฮมของฉัน และไม่มีอะไรเลยในไฟล์ล็อกโกลบอลของฉันเอง

“No global skills tracked in lock file” มีสาเหตุพบบ่อยสามประการ: คุณไม่เคยติดตั้งด้วย -gคุณติดตั้งด้วย -g ในฐานะผู้ใช้อื่น (root ผ่าน sudo) หรือไฟล์ล็อกถูกลบไปแล้ว ถ้าคุณเคยอ่านที่อื่นมาว่า generate-lock คำสั่งที่ใช้สร้างมันขึ้นมาใหม่ มันไม่มีอยู่จริง: ไม่มีคำสั่งแบบนั้นในเวอร์ชัน 1.5 หรือ 1.8

วิธีแก้

  • รัน CLI จากโฟลเดอร์โปรเจกต์ หรือ /tmp, อย่ารันจาก ~และส่ง -g หรือ -p เพื่อให้มันเดาไม่ได้
  • หากต้องการแกะปม “โปรเจกต์” ในโฟลเดอร์โฮม, ให้ติดตั้งสกิลที่คุณต้องการใหม่ด้วย -g จากโฟลเดอร์อื่น (มันจะไปลงที่เดิม แต่ตอนนี้ถูกบันทึกไว้ในไฟล์ล็อกโกลบอลของคุณแล้ว) จากนั้นลบ ~/skills-lock.jsonอย่ารัน npx skills remove จาก ~ สำหรับเรื่องนี้: ในโฟลเดอร์โฮมของคุณ โฟลเดอร์โปรเจกต์กับโฟลเดอร์โกลบอลคือโฟลเดอร์เดียวกัน

ปัญหา 4: “ไม่พบสกิลที่ตรงกัน” เพราะเครื่องหมายทวิภาค

graham@pi:~ $ npx skills remove ckm:banner-design ckm:brand ckm:design \
  ckm:design-system ckm:slides ckm:ui-styling
◇  Found 7 unique installed skill(s)
■  No matching skills found for: ckm:banner-design, ckm:brand, ckm:design, ckm:design-system, ckm:slides, ckm:ui-styling

เกิดอะไรขึ้น สกิลเหล่านี้ แสดง เป็น ckm:banner-design, แต่เครื่องหมายทวิภาคเป็นอักขระที่เสี่ยงในชื่อโฟลเดอร์ CLI จึงบันทึกเป็น ckm-banner-design: มันแปลงชื่อเป็นตัวพิมพ์เล็ก และเปลี่ยนอักขระใด ๆ ที่ไม่ใช่ตัวอักษร ตัวเลข จุด และขีดล่างให้เป็นขีดกลาง เวอร์ชัน 1.5.18 เปรียบเทียบสิ่งที่ฉันพิมพ์กับชื่อโฟลเดอร์แบบตรงตัว จึงไม่มีอะไรตรงกัน

แก้แล้วหรือยัง ใช่ เวอร์ชันปัจจุบันแปลงข้อมูลที่คุณพิมพ์ด้วยวิธีเดียวกันก่อนเปรียบเทียบ ดังนั้น ckm:brand และ ckm-brand ใช้ได้ทั้งคู่ และเมื่อไม่มีอะไรตรงกัน 1.8.1 จะพิมพ์ชื่อที่ ถูก ติดตั้งไว้

วิธีแก้ เรียกใช้ npx skills ls (หรือ ls ~/.agents/skills) เพื่อดูชื่อจริง หรือรัน npx skills remove โดยไม่ใส่อาร์กิวเมนต์ แล้วเลือกจากรายการ ตรวจสอบขอบเขตด้วย: เมื่ออยู่ในโฟลเดอร์โปรเจกต์ การลบสกิลที่บันทึกไว้ใน lock ส่วนกลางตอนนี้จะบอกให้คุณเพิ่ม -g.

ปัญหา 5: สกิลหกตัวล้มเหลว แต่ตัวหนึ่งจากรีโปเดียวกันกลับทำงานได้

Refreshing 7 skill(s)…
✗ Failed to check for deleted skills from nextlevelbuilder/ui-ux-pro-max-skill
Updating ckm:banner-design…
  ✗ Failed to update ckm:banner-design
…                                  (five more ✗)
Updating ui-ux-pro-max…
  ✓ Updated ui-ux-pro-max

เกิดอะไรขึ้น ในการอัปเดตสกิล CLI จะค้นหาสกิลนั้นในรีโปต้นทางอีกครั้ง สกิลหกจากเจ็ดตัวของฉันจากรีโปนั้นหาไม่พบ ขณะที่ตัวที่เจ็ดอัปเดตได้ปกติ เมื่อสกิลส่วนใหญ่จากแหล่งเดียวล้มเหลวแต่มีตัวหนึ่งสำเร็จ ตัวที่หายไปมักถูกเปลี่ยนชื่อ ย้าย หรือลบออกจากต้นทาง README ของรีโปนั้นวันนี้อธิบายสกิลเดียวคือ ui-ux-pro-maxและกล่าวถึงแบนเนอร์ อัตลักษณ์แบรนด์ และสไลด์เพียงในฐานะฟีเจอร์ของแพ็กเกจเสียเงิน ซึ่งสอดคล้องกับที่ทั้งหกตัวออกจากรีโปฟรีไปแล้ว

วิธีแก้ ดูว่าตอนนี้ต้นทางมีอะไรให้บ้าง แล้วลบสิ่งที่หายไป:

npx skills add nextlevelbuilder/ui-ux-pro-max-skill --list
npx skills remove ckm-banner-design ckm-brand ckm-design ckm-design-system ckm-slides ckm-ui-styling

CLI เวอร์ชันปัจจุบันสังเกตเห็นสกิลที่ถูกลบไปจากต้นทางและเสนอทำความสะอาดระหว่างการอัปเดต และจะลบสกิลที่หายไปออกจากไฟล์ lock เมื่อคุณถอนการติดตั้ง ระหว่างนั้นลองหาตัวซ้ำด้วย: ถ้าคุณมี brand สกิลอยู่ข้าง ckm-brandให้เก็บไว้เพียงตัวเดียว สกิลสองตัวที่มีคำอธิบายใกล้เคียงกันจะทำให้เอเจนต์เลือกผิดและเปลืองพื้นที่รายการของมัน

โบนัส: Claude Code มองไม่เห็นสกิลที่ CLI ติดตั้งให้

  • ตรวจสอบลิงก์ Claude Code อ่านเฉพาะโฟลเดอร์ของตัวเอง ดังนั้น ls -la ~/.claude/skills (หรือ .claude/skills ในโปรเจกต์) ควรแสดงสกิลนั้น โดยปกติเป็นลิงก์ไปยัง .agents/skillsมีรีลีส 1.5 หลายตัวที่แก้บั๊กเกี่ยวกับลิงก์ของ Claude Code (1.5.16 และ 1.5.20) ดังนั้นถ้าไม่พบ ให้ติดตั้งใหม่ด้วย npx skills@latest add … -a claude-code.
  • ตรวจสอบว่าไฟล์ขึ้นต้นถูกต้อง เครื่องหมายเปิด --- ของ front matter ต้องเป็นบรรทัดแรกสุดของ SKILL.mdหรือ Claude Code จะถือว่าไฟล์ทั้งหมดเป็นข้อความธรรมดา
  • โหลดใหม่ Claude Code รับสกิลที่แก้ไขทันที แต่โฟลเดอร์สกิลที่สร้างหลังเซสชันเริ่มแล้วต้อง /reload-skillsจากนั้น /skills แสดงรายการสิ่งที่โหลดอยู่
แก้ปัญหา npx skills: ข้อผิดพลาดจริงห้าข้อพร้อมวิธีแก้ ตั้งแต่การรายงานว่าอัปเดตครบแล้วทั้งที่ไม่จริงหลังเจอ rate limit ของ GitHub ไปจนถึง sudo สร้างที่เก็บ skill แห่งที่สอง, โฟลเดอร์ home ที่ถูกมองเป็นโปรเจกต์ และ skill ที่ถูกลบไปแล้วที่ upstream
ห้าข้อผิดพลาด ห้าทางแก้ ส่วนใหญ่แล้ววกกลับไปที่กฎสองข้อเดียวกัน: อ่านบรรทัดที่มี ✗ และอย่ารัน CLI ในฐานะ root หรือจากโฟลเดอร์บ้านของคุณ

ตอนที่ 7 — เซิร์ฟเวอร์ MCP แบบไม่ต้องมีศัพท์แสง

เกิดอะไรขึ้นเมื่อคุณเชื่อมต่อเซิร์ฟเวอร์

  1. คุณเพิ่มเซิร์ฟเวอร์ ลงในการตั้งค่าของ agent: คำสั่งสำหรับเซิร์ฟเวอร์โลคอล และที่อยู่เว็บสำหรับเซิร์ฟเวอร์ระยะไกล
  2. เมื่อเซสชันเริ่มทำงาน agent จะเปิดเซิร์ฟเวอร์โลคอลหรือเชื่อมต่อกับเซิร์ฟเวอร์ระยะไกล และลงชื่อเข้าใช้หากเซิร์ฟเวอร์ต้องการ
  3. เซิร์ฟเวอร์แสดงรายการเครื่องมือของมัน แล้ว agent ก็ส่งคำอธิบายของเครื่องมือเหล่านั้นไปยังโมเดล
  4. เมื่องานต้องใช้เครื่องมือ โมเดลจะขอเครื่องมือนั้น agent ของคุณตรวจกฎการอนุญาตของคุณ (และอาจถามคุณ) เซิร์ฟเวอร์ลงมือทำงาน แล้วผลลัพธ์ก็กลับเข้าสู่บทสนทนา

โลคอลหรือระยะไกล?

เซิร์ฟเวอร์โลคอล (stdio) เซิร์ฟเวอร์ระยะไกล (Streamable HTTP)
รันบน บนคอมพิวเตอร์ของคุณ โดยมี agent เป็นตัวเริ่ม บนคอมพิวเตอร์ของผู้ให้บริการ
คุณเพิ่ม คำสั่ง เช่น npx @playwright/mcp@latest ที่อยู่ เช่น https://mcp.context7.com/mcp
การลงชื่อเข้าใช้ โดยปกติเป็น API key ในตัวแปรสภาพแวดล้อม โดยปกติเป็น OAuth ในเบราว์เซอร์ของคุณ หรือ key ใน header
ต้องมี Node.js, Python หรือ Docker ขึ้นอยู่กับเซิร์ฟเวอร์ การเชื่อมต่ออินเทอร์เน็ต
เหมาะสำหรับ สิ่งต่าง ๆ บนเครื่องของคุณ: เบราว์เซอร์ ไฟล์ ฐานข้อมูลโลคอล บริการคลาวด์: GitHub, Sentry, เอกสารประกอบ, เครื่องมือโปรเจกต์
ข้อควรระวัง มันทำงานด้วยสิทธิ์เต็มของผู้ใช้ของคุณ ข้อมูลของคุณจะถูกส่งไปยังผู้ให้บริการรายนั้น

คุณอาจยังเห็นประเภทที่สามคือ SSE ในคู่มือเก่า ๆ เอกสารของ Claude Code ระบุว่าเลิกใช้แล้ว ให้ใช้ที่อยู่ HTTP เมื่อเซิร์ฟเวอร์มีให้ทั้งสองแบบ

หมายเหตุเรื่องเวอร์ชัน

ข้อกำหนด MCP ฉบับปัจจุบันซึ่งเผยแพร่เมื่อ 28 กรกฎาคม 2026 เป็นการแก้ไขครั้งใหญ่ที่สุดนับตั้งแต่โปรโตคอลเปิดตัว: แกนกลางของมันตอนนี้ไม่เก็บสถานะ (stateless) ซึ่งทำให้เซิร์ฟเวอร์ระยะไกลทำงานอยู่หลังโหลดบาลานเซอร์ทั่วไปได้ คุณแทบไม่ต้องกังวล เพราะไคลเอนต์และเซิร์ฟเวอร์ตกลงกันได้ว่าจะใช้เวอร์ชันไหน และเซิร์ฟเวอร์รุ่นเก่าก็ยังทำงานได้ OpenCode เป็นที่เดียวที่คุณอาจเห็นเรื่องนี้: เซิร์ฟเวอร์แต่ละตัวมี protocol การตั้งค่า (legacy เป็นค่าเริ่มต้น, auto, หรือ 2026-07-28), และการรวมพูลการเชื่อมต่อทำงานได้เฉพาะกับรีวิชันล่าสุดเท่านั้น

ค่าใช้จ่ายด้านบริบท และวิธีทำให้มันเล็กลง

ทุกเครื่องมือที่เซิร์ฟเวอร์เสนอมาพร้อมคำอธิบายที่เขียนไว้สำหรับโมเดล ตามคำพูดของ OpenCode เอง “เครื่องมือ MCP กินบริบทของโมเดล ดังนั้นเพิ่มเฉพาะเซิร์ฟเวอร์ที่คุณต้องการ” ตอนนี้มีเอเจนต์สองตัวที่ลดค่าใช้จ่ายนี้ให้เองโดยค่าเริ่มต้น:

  • Claude Code ใช้การค้นหาเครื่องมือ เมื่อเริ่มเซสชัน มันโหลดเฉพาะชื่อเครื่องมือและคำสั่งของแต่ละเซิร์ฟเวอร์ และดึงคำนิยามเต็มของเครื่องมือเมื่อ Claude ค้นหามันจริง ๆ
  • OpenCode ใช้ Code Mode, ซึ่งจัดกลุ่มเครื่องมือของแต่ละเซิร์ฟเวอร์ไว้หลังรายการเดียวแทนที่จะแสดงทุกเครื่องมือแยกกัน มันเปิดอยู่เว้นแต่คุณตั้งค่า "codemode": false สำหรับเซิร์ฟเวอร์หนึ่ง

ที่อื่นทั้งหมด และเพิ่มเติมจากค่าเริ่มต้นเหล่านั้น นี่คือตัวควบคุมของคุณ:

เอเจนต์ ปิดเซิร์ฟเวอร์ ซ่อนเครื่องมือที่คุณไม่ต้องการ
OpenCode "disabled": true, หรือ /mcps สำหรับหนึ่งเซสชัน A deny ใช้กฎกับ <server>_<tool> ในการตั้งค่าสิทธิ์
Claude Code claude mcp remove <name> (/mcp แสดงสถานะ) A deny กฎสิทธิ์การเข้าถึงกับ mcp__<server>__<tool>; ENABLE_TOOL_SEARCH กำหนดว่าจะโหลดล่วงหน้ามากแค่ไหน
Codex enabled = false enabled_tools และ disabled_tools
Gemini CLI gemini mcp disable <name> (เพิ่ม --session สำหรับหนึ่งเซสชัน) includeTools และ excludeTools
Cursor สวิตช์ของเซิร์ฟเวอร์ใต้ Customize (ผู้ดูแลระบบสามารถตั้งรายการอนุญาตเครื่องมือได้)
Hermes Agent enabled: false tools.include และ tools.exclude

กฎของผม: เซิร์ฟเวอร์สองถึงห้าตัวที่คุณใช้ทุกสัปดาห์ดีกว่าเซิร์ฟเวอร์ยี่สิบตัวที่คุณอาจใช้สักวันหนึ่ง ลบตัวที่เหลือออก คุณเพิ่มกลับได้ภายในหนึ่งนาที

สี่เซิร์ฟเวอร์ที่ควรลองก่อน

เซิร์ฟเวอร์ สิ่งที่มันมอบให้เอเจนต์ของคุณ ประเภท ที่อยู่หรือคำสั่ง การลงชื่อเข้าใช้
Context7 เอกสารประกอบที่ตรงกับเวอร์ชันปัจจุบันสำหรับไลบรารีและเฟรมเวิร์กยอดนิยม รีโมต https://mcp.context7.com/mcp ไม่จำเป็นต้องมี; คีย์ API ฟรีช่วยเพิ่มขีดจำกัด
GitHub (ทางการ) Issues, pull requests, การค้นหาโค้ด, Actions รีโมต https://api.githubcopilot.com/mcp/ OAuth หากเอเจนต์ของคุณรองรับ หรือใช้โทเค็นการเข้าถึงส่วนบุคคล
Playwright เบราว์เซอร์จริงที่เอเจนต์เปิดได้ คลิกไปมา และจับภาพหน้าจอได้ โลคอล npx @playwright/mcp@latest ไม่มี
Sentry ข้อผิดพลาดและการแครชจริงของคุณ รีโมต https://mcp.sentry.dev/mcp OAuth

แหล่งหาข้อมูลเพิ่มเติม:

  • อย่างเป็นทางการ MCP Registryซึ่งดูแลโดยผู้มีส่วนร่วมของโปรโตคอล’ และรวบรวมรายชื่อเซิร์ฟเวอร์ที่เผยแพร่แล้ว
  • เอกสารประกอบของเครื่องมือ’คุณเอง ปัจจุบันบริการส่วนใหญ่เผยแพร่เซิร์ฟเวอร์อย่างเป็นทางการแล้ว ลองค้นหา “MCP” ในเอกสารของบริการนั้น
  • แคตตาล็อกของเอเจนต์’คุณ Hermes Agent มี hermes mcp catalog, และปลั๊กอิน Claude Code หลายตัวก็นำเซิร์ฟเวอร์ของตัวเองมาด้วย

ควรเลือกเซิร์ฟเวอร์ที่เผยแพร่โดยบริษัทที่ให้บริการนั้น เซิร์ฟเวอร์แปลก ๆ ชื่อ “github-mcp-pro” ควรได้รับความระแวงไม่ต่างจากส่วนขยายเบราว์เซอร์แปลก ๆ

ทางเลือกที่เบากว่า: เครื่องมือบรรทัดคำสั่งบวกกับสกิลหนึ่งตัว

ก่อนเพิ่มเซิร์ฟเวอร์ ให้ตรวจก่อนว่าเครื่องมือบรรทัดคำสั่งทำงานนั้นได้หรือไม่ ตัว Context7 เองมีให้เลือกทั้งสองทาง คือ MCP เซิร์ฟเวอร์ด้านบน หรือ CLI เล็ก ๆ พร้อมสกิล (npx ctx7 setup --opencodeซึ่งต้องใช้ Node.js 22.13 ขึ้นไป) ของ GitHub’เอง gh เครื่องมือบวกสกิลสั้น ๆ ครอบคลุมสิ่งที่เซิร์ฟเวอร์ของมันทำได้เป็นส่วนใหญ่

เซิร์ฟเวอร์เหมาะสมเมื่อ เอเจนต์ของคุณรันคำสั่งไม่ได้ (เช่น แอปแชตบนเดสก์ท็อป) บริการนั้นไม่มี CLI ที่ดี หรือเป็นงานที่ต้องโต้ตอบ เช่น การขับเบราว์เซอร์ CLI บวกสกิลเหมาะสมเมื่อ เครื่องมือนั้นมีอยู่แล้ว ไม่มีค่าใช้จ่ายจนกว่าจะถูกใช้ และสามารถตัดทอนผลลัพธ์ก่อนถึงโมเดลได้ บทความของผม OpenCode ของผม ให้เหตุผลแบบเดียวกันกับการพัฒนาแอป


ตอนที่ 8 — เพิ่มเซิร์ฟเวอร์ MCP ในหกเอเจนต์: สูตรพร้อมคัดลอกวาง

แต่ละสูตรเพิ่มเซิร์ฟเวอร์สองตัวเดียวกัน: Context7 (รีโมต) และ Playwright (โลคอล) สลับเป็นเซิร์ฟเวอร์อื่นด้วยวิธีเดียวกันได้เลย หากเอเจนต์มีทั้งคำสั่งและไฟล์การตั้งค่า คำสั่งนั้นจะเขียนไฟล์ให้คุณเอง

OpenCode

opencode mcp add context7 --url https://mcp.context7.com/mcp
opencode mcp add playwright -- npx @playwright/mcp@latest
opencode mcp list

เพิ่ม --global เพื่อให้เซิร์ฟเวอร์ใช้ได้ในทุกโปรเจกต์ ใน opencode.jsonc การตั้งค่าเดียวกันมีหน้าตาแบบนี้:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "context7": {
        "type": "remote",
        "url": "https://mcp.context7.com/mcp",
        "oauth": false
        // With a free API key, add:
        // "headers": { "Authorization": "Bearer {env:CONTEXT7_API_KEY}" }
      },
      "playwright": {
        "type": "local",
        "command": ["npx", "@playwright/mcp@latest"]
      }
    }
  }
}
  • ข้อมูลลับใส่เป็น {env:NAME}; OpenCode ไม่ขยายค่า’ $NAME.
  • เซิร์ฟเวอร์รีโมตจะลองใช้ OAuth ให้อัตโนมัติ; oauth: false ใช้สำหรับเซิร์ฟเวอร์ที่ใช้คีย์หรือไม่ใช้เลย ลงชื่อเข้าใช้ด้วย opencode mcp auth <name>, และหากใช้ SSH ให้วาง URL ของ callback จากหน้าบราวเซอร์ที่ล้มเหลวลงในพรอมต์
  • ภายในเซสชัน, /mcps เชื่อมต่อ ตัดการเชื่อมต่อ หรือลงชื่อเข้าใช้เซิร์ฟเวอร์
  • แต่ละเครื่องมือจะกลายเป็นสิทธิ์ที่ชื่อ <server>_<tool>ดังนั้น { "action": "playwright_*", "resource": "*", "effect": "ask" } ทำให้ทุกการกระทำของบราวเซอร์ถามก่อน

Claude Code

claude mcp add --transport http context7 https://mcp.context7.com/mcp
claude mcp add playwright -- npx @playwright/mcp@latest
claude mcp list

กรณี -- แยกออปชันของ Claude Code’ ออกจากคำสั่งของเซิร์ฟเวอร์เอง เซิร์ฟเวอร์มีค่าเริ่มต้นเป็น local scope (คุณ ในโปรเจกต์นี้) เพิ่ม --scope user สำหรับทุกโปรเจกต์ของคุณ หรือ --scope project เพื่อเขียนไฟล์ .mcp.json ที่คุณคอมมิตให้ทีมได้:

{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    },
    "playwright": {
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}
  • .mcp.json ขยาย ${VAR} และ ${VAR:-default}, เพื่อให้คีย์อยู่ใน environment ของคุณ ไม่ใช่ใน Git
  • /mcp ภายในเซสชันจะแสดงสถานะของเซิร์ฟเวอร์แต่ละตัว’ และจัดการลงชื่อเข้าใช้ OAuth
  • Claude Code จะถามก่อนใช้เซิร์ฟเวอร์จากโปรเจกต์’ .mcp.json, ดังนั้นรีโปที่โคลนมาจึงเพิ่มเซิร์ฟเวอร์ของตัวเองอย่างเงียบ ๆ ไม่ได้

Codex

Codex เก็บเซิร์ฟเวอร์ไว้ใน ~/.codex/config.toml, หรือใน .codex/config.toml ภายในโปรเจกต์ที่คุณทำเครื่องหมายว่าเชื่อถือได้:

[mcp_servers.context7]
url = "https://mcp.context7.com/mcp"

[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]
  • เซิร์ฟเวอร์ระยะไกลเพิ่มได้ด้วย codex mcp add context7 --url https://mcp.context7.com/mcp, และ codex mcp login <name> จะเริ่มการลงชื่อเข้าใช้ OAuth
  • สำหรับคีย์ ให้ใช้ bearer_token_env_var = "CONTEXT7_API_KEY" อ่านค่านี้จาก environment ของคุณ
  • ปรับแต่งเซิร์ฟเวอร์ด้วย enabled_tools และ disabled_tools; startup_timeout_sec (ค่าเริ่มต้น 10 วินาที) ช่วยให้เซิร์ฟเวอร์ที่เริ่มช้าเริ่มทำงานได้

Gemini CLI

gemini mcp add -t http context7 https://mcp.context7.com/mcp
gemini mcp add playwright npx @playwright/mcp@latest
gemini mcp list

gemini mcp add จะเขียนไปยัง การตั้งค่าของโปรเจกต์ เป็นค่าเริ่มต้น; เพิ่ม -s user สำหรับทุกโปรเจกต์ ใน settings.json:

{
  "mcpServers": {
    "context7": { "httpUrl": "https://mcp.context7.com/mcp" },
    "playwright": { "command": "npx", "args": ["@playwright/mcp@latest"] }
  }
}
  • httpUrl ใช้สำหรับ Streamable HTTP; url หมายถึงประเภท SSE แบบเก่า
  • ปล่อย trust ให้ปิดไว้ หากตั้งค่าเป็น true, ระบบจะข้ามการยืนยันทั้งหมดสำหรับเซิร์ฟเวอร์นั้น
  • Gemini CLI จะตัดตัวแปรที่ดูเหมือนข้อมูลลับ (ชื่อที่มี TOKEN, SECRET, PASSWORD หรือ KEY) ออกจากสภาพแวดล้อมของเซิร์ฟเวอร์ เว้นแต่คุณจะระบุไว้ใน env บล็อกของมัน
  • OAuth ต้องใช้เบราว์เซอร์บนเครื่องเดียวกัน ในโฟลเดอร์ที่ยังไม่น่าเชื่อถือ เซิร์ฟเวอร์ภายในจะยังไม่เชื่อมต่อจนกว่าคุณจะรัน gemini trust.

Cursor

Cursor อ่าน .cursor/mcp.json ในโปรเจกต์ และ ~/.cursor/mcp.json สำหรับทุกอย่าง:

{
  "mcpServers": {
    "context7": { "url": "https://mcp.context7.com/mcp" },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": ["@playwright/mcp@latest"]
    }
  }
}
  • เซิร์ฟเวอร์ภายในต้องมี "type": "stdio".
  • ข้อมูลลับใส่เป็น ${env:NAME}.
  • เปิดและปิดเซิร์ฟเวอร์แต่ละตัวด้วยสวิตช์ได้ที่ ปรับแต่ง.

Hermes Agent

Hermes อ่าน mcp_servers ใน ~/.hermes/config.yaml:

mcp_servers:
  context7:
    url: "https://mcp.context7.com/mcp"
  playwright:
    command: "npx"
    args: ["@playwright/mcp@latest"]
  • เรียกใช้ /reload-mcp หลังแก้ไข และใช้ hermes mcp test context7 เพื่อดูว่าเซิร์ฟเวอร์ตอบอะไรกลับมาอย่างแน่ชัด
  • สำหรับบริการที่ใช้ OAuth ให้เพิ่ม auth: oauth ในรายการแบบ HTTP บนเครื่องที่ไม่มีหน้าจอ Hermes มีทางเลือกให้วางข้อความกลับมา ส่งต่อพอร์ตผ่าน SSH หรือลงชื่อเข้าใช้ผ่านอุปกรณ์
  • Hermes ส่งตัวแปรให้เซิร์ฟเวอร์ภายในเฉพาะตัวแปรที่คุณระบุไว้ใน env บวกชุดค่าพื้นฐานที่ปลอดภัย ไม่ใช่สภาพแวดล้อมเชลล์ทั้งหมดของคุณ
  • เครื่องมือจะแสดงเป็น mcp_<server>_<tool>; กรองด้วย tools.include หรือ tools.exclude.

ตรวจสอบว่าใช้งานได้ ในเอเจนต์ใดก็ได้

ถามคำถามที่เซิร์ฟเวอร์เท่านั้นที่ตอบได้: “ใช้ Context7 ค้นหาวิธีกำหนดเส้นทางในเวอร์ชันปัจจุบันของ Next.js แล้วบอกฉันว่าคุณเรียกเครื่องมือใด” จากนั้นขอสิ่งที่มองเห็นได้: “เปิด example.com ด้วย Playwright แล้วอธิบายหน้านั้น” ถ้าเอเจนต์บอกว่าไม่มีเครื่องมือเหล่านี้ ให้แสดงรายการเซิร์ฟเวอร์ (opencode mcp list, claude mcp list, gemini mcp list, hermes mcp test) แล้วดูว่ามีการเชื่อมต่อที่ล้มเหลวหรือการลงชื่อเข้าใช้ที่ค้างไม่เสร็จหรือไม่

วิธีเพิ่ม MCP server ใน OpenCode, Claude Code, Codex, Gemini CLI, Cursor และ Hermes Agent: เซิร์ฟเวอร์ Context7 ตัวเดียวกันในรูปแบบคำสั่งหรือคอนฟิกของแต่ละ agent พร้อมคำสั่งสำหรับเซิร์ฟเวอร์ภายในเครื่อง
เซิร์ฟเวอร์เดียว หกสำเนียง แนวคิดเหมือนกันทุกประการ เปลี่ยนเพียงชื่อไฟล์และวงเล็บเท่านั้น

ตอนที่ 9 — ปลั๊กอิน: สกิลและเซิร์ฟเวอร์ MCP ในกล่องเดียว

การติดตั้งสกิลสิบตัวและเซิร์ฟเวอร์สามตัวทีละตัวนั้นน่าเบื่อ ปลั๊กอินรวมสิ่งเหล่านี้ไว้ด้วยกัน และตอนนี้เอเจนต์ส่วนใหญ่มีระบบปลั๊กอินในรูปแบบใดรูปแบบหนึ่ง

ปลั๊กอินของ Claude Code

ปลั๊กอินของ Claude Code หนึ่งตัวอาจมีสกิล ซับเอเจนต์ ฮุก เซิร์ฟเวอร์ MCP และ language server ปลั๊กอินมาจาก มาร์เก็ตเพลสซึ่งเป็นเพียงแคตตาล็อกที่โฮสต์อยู่ในรีโพซิทอรี Git:

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

ในเซสชัน, /plugin install จะเปิดรายละเอียดของปลั๊กอินก่อน เพื่อให้คุณเห็นว่ามันเพิ่มอะไรบ้างก่อนเลือกขอบเขต: คุณ (ทุกโปรเจกต์) รีโพซิทอรีนี้สำหรับทุกคน หรือรีโพซิทอรีนี้สำหรับคุณคนเดียว จากเชลล์ของคุณ, claude plugin install <name>@<marketplace> ทำแบบเดียวกันได้โดยไม่ต้องมีเซสชัน

คุณสมบัติสามข้อที่ควรรู้:

  • มองเห็นต้นทุนของบริบทได้ สำหรับปลั๊กอินในมาร์เก็ตเพลสอย่างเป็นทางการของ Anthropic แผงรายละเอียดจะประเมินว่าปลั๊กอินเพิ่มอะไรลงในทุกข้อความ และเพิ่มอะไรเมื่อถูกใช้งาน claude plugin details <name> จะแสดงตัวเลขต่อเซสชันสำหรับทุกสิ่งที่ติดตั้งไว้
  • การอัปเดต มาร์เก็ตเพลสอย่างเป็นทางการของ Anthropic อัปเดตปลั๊กอินโดยอัตโนมัติ ส่วนมาร์เก็ตเพลสของบุคคลที่สามไม่อัปเดตให้ เว้นแต่คุณจะเปิดใช้งาน claude plugin update <name>@<marketplace> อัปเดตปลั๊กอินทีละตัวด้วยมือ
  • ปลั๊กอินที่ไม่ได้ใช้งานจะถูกทำเครื่องหมายไว้ แท็บ Installed จะจัดกลุ่มปลั๊กอินที่คุณไม่ได้ใช้ล่าสุด ซึ่งช่วยให้การเก็บกวาดทำได้ง่าย

ปลั๊กอินในที่อื่น

  • Codex เผยแพร่สกิลที่นำกลับมาใช้ใหม่ได้ผ่านปลั๊กอิน (/plugins ใน CLI) และปลั๊กอินยังพาการเชื่อมต่อเซิร์ฟเวอร์ MCP ไปด้วยได้
  • Gemini CLI เรียกสิ่งเหล่านี้ว่าส่วนขยาย: gemini extensions install <git-url> และ gemini extensions update <name>.
  • GitHub Copilot CLI (copilot plugin install) และ Hermes Agent (hermes plugins install) มีคำสั่งสำหรับปลั๊กอิน และ Cursor มี /add-plugin ใน Agent chat
  • OpenCode ปลั๊กอินคือแพ็กเกจ JavaScript หรือ TypeScript ที่ระบุไว้ใน ปลั๊กอิน การตั้งค่าของคอนฟิก ซึ่งสามารถลงทะเบียนสกิลและเครื่องมือได้ Superpowers ติดตั้งด้วยวิธีนี้

สองกฎที่ทำให้การติดตั้งปลั๊กอินไม่วุ่นวาย

  1. หนึ่งช่องทางต่อหนึ่งแพ็ก ถ้าแพ็กสกิลมีทั้งแบบปลั๊กอินและแบบสกิลธรรมดา ให้เลือกอย่างใดอย่างหนึ่ง การมีสองชุดหมายถึงชื่อซ้ำกัน และเอเจนต์จะเลือกอันที่เห็นก่อน
  2. อัปเดตจากช่องทางที่คุณติดตั้งไว้ skills CLI ไม่รู้จักปลั๊กอิน และตัวจัดการปลั๊กอินก็ไม่รู้จัก ~/.agents/skills.

ตอนที่ 10 — เขียนสกิลแรกของคุณในสิบนาที

สกิลแรกที่ดีที่สุดคือสกิลที่แก้งานที่คุณทำซ้ำ ๆ นี่คือสกิลที่สร้างจากส่วนที่ 6: สกิลที่ให้เอเจนต์ตัวไหนก็ได้ตรวจสอบว่าสกิลของคุณมีอัปเดตหรือไม่ อย่างปลอดภัยโดยไม่ต้องใช้ sudo หรือเชื่อเครื่องหมายถูกสีเขียวแบบไม่ตรวจสอบ

ขั้นตอนที่ 1 — สร้างโฟลเดอร์

mkdir -p ~/skills-drafts && cd ~/skills-drafts
npx skills init skills-housekeeping

คำสั่งนี้จะสร้าง skills-housekeeping/SKILL.md จากเทมเพลต จากนั้นแทนที่เนื้อหาด้วยสิ่งนี้:

---
name: skills-housekeeping
description: ตรวจสอบสกิลของเอเจนต์ที่ติดตั้งไว้ว่ามีอัปเดตหรือปัญหาด้วย npx skills CLI และอธิบายผลลัพธ์เป็นภาษาไทยแบบเข้าใจง่าย ใช้เมื่อมีคนถามว่าสกิลเป็นเวอร์ชันล่าสุดหรือยัง เมื่อต้องการอัปเดตสกิล หรือเมื่อสกิลที่ติดตั้งดูเหมือนจะหายไป
metadata:
  author: graham-miranda
  version: "1.0"
---

# งานดูแลสกิล

## กฎ
- ห้ามรันคำสั่งใด ๆ ด้วย sudo
- ห้ามรัน `npx skills update` หรือ `npx skills remove` โดยไม่ถามก่อน
- รันคำสั่งจาก /tmp หรือโฟลเดอร์โปรเจกต์ ห้ามรันจากโฟลเดอร์ home

## ตรวจสอบ
1. รัน `cd /tmp && npx skills@latest check -g` สำหรับสกิลแบบโกลบอล
2. ถ้าโปรเจกต์ปัจจุบันมีไฟล์ skills-lock.json ให้รัน `npx skills@latest check -p` ในโฟลเดอร์โปรเจกต์ด้วย
3. ถือว่าทุกบรรทัดที่ขึ้นต้นด้วย ✗ คือ "ยังไม่ได้ตรวจสอบ" แม้บรรทัดถัดมาจะบอกว่าทุกอย่างเป็นเวอร์ชันล่าสุดแล้ว

## รายงาน
- ระบุสกิลที่มีอัปเดต สกิลที่มีการแก้ไขในเครื่อง และรายการที่ตรวจสอบไม่ได้
- ถ้าการตรวจสอบใดล้มเหลว ให้แนะนำ `gh auth login` หรือ GITHUB_TOKEN ที่มีสิทธิ์อ่านอย่างเดียวสำหรับรีโปสาธารณะ
- ถามก่อนอัปเดต จากนั้นรัน `npx skills update -g` (หรือ `-p`) และรายงานสิ่งที่เปลี่ยนแปลง

ขั้นตอนที่ 2 — ตรวจสอบกับมาตรฐาน

  • ชื่อ: skills-housekeeping ใช้เฉพาะตัวพิมพ์เล็กและขีดกลาง มีความยาวไม่ถึง 64 ตัวอักษร และตรงกับชื่อโฟลเดอร์ ทั้งสามข้อจำเป็นทั้งหมด
  • คำอธิบาย: มันบอกว่า สิ่งที่ สกิลทำอะไร และ เวลา ใช้เมื่อใด และมีคำที่ผู้คนพิมพ์จริง (“อัปเดตแล้ว”, “อัปเดตสกิล”, “หายไป”) คำอธิบายเป็นส่วนเดียวที่เอเจนต์เห็นก่อนตัดสินใจ จึงทำงานหนักที่สุด มาตรฐานอนุญาตไม่เกิน 1,024 ตัวอักษร ตั้งเป้าไว้ที่หนึ่งหรือสองประโยค
  • ความยาว: ต่ำกว่าที่แนะนำไว้ที่ 500 บรรทัดมาก เมื่อสกิลเติบโตขึ้น ให้ย้ายรายละเอียดไปไว้ใน references/ และอ้างอิงถึงมันจากคำสั่ง

โปรเจกต์ Agent Skills เผยแพร่ตัวตรวจสอบอ้างอิงชื่อ skills-refซึ่งตรวจสอบ front matter และกฎการตั้งชื่อ: skills-ref validate ./skills-housekeeping.

ขั้นตอนที่ 3 — ติดตั้งให้เอเจนต์ทุกตัวพร้อมกัน

skills CLI ติดตั้งจากโฟลเดอร์ในเครื่องได้เช่นกัน:

npx skills add ./skills-housekeeping -g -a opencode -a claude-code -a codex

ซึ่งวางสำเนาตัวจริงไว้ที่ ~/.agents/skills/skills-housekeeping (อ่านโดยตรงโดย OpenCode และ Codex) และเพิ่มลิงก์ใน ~/.claude/skills สำหรับ Claude Code

ขั้นตอนที่ 4 — ทดสอบการใช้งาน

ถามด้วยคำธรรมดา: “สกิลของฉันเป็นเวอร์ชันล่าสุดหรือยัง?” สกิลที่อธิบายไว้ดีจะถูกหยิบมาใช้โดยอัตโนมัติ ถ้าไม่เป็นเช่นนั้น ให้เรียกตามชื่อเพื่อตัดปัญหาการโหลดออกไป: @skills-housekeeping ใน OpenCode, /skills-housekeeping ใน Claude Code, $skills-housekeeping ใน Codex ถ้าโหลดได้เมื่อเรียกตามชื่อแต่ไม่เคยถูกเรียกเอง ปัญหาอยู่ที่คำอธิบาย: ให้เพิ่มวลีที่คุณใช้จริงเข้าไป

ขั้นตอนที่ 5 — แชร์ให้ผู้อื่น

พุชโฟลเดอร์ไปยังรีโพซิทอรี GitHub โดยควรอยู่ใน skills/ โฟลเดอร์ (skills/skills-housekeeping/SKILL.md) จากนั้นใครก็ติดตั้งได้ด้วย npx skills add your-name/your-repo. CLI จะค้นหาสกิลใน skills/ และในโฟลเดอร์ของเอเจนต์ทั่วไป ลึกได้ถึงสามระดับ

ส่วนเสริมเฉพาะเอเจนต์ และเมื่อใดควรหลีกเลี่ยง

เอเจนต์หลายตัวเข้าใจฟิลด์ front matter เพิ่มเติม Claude Code มี disable-model-invocation (คุณเท่านั้นที่เรียกใช้สกิลได้) และ context: fork (รันในซับเอเจนต์); Cursor มี พาธ (ใช้เฉพาะกับไฟล์ที่ตรงเงื่อนไข); OpenCode ซ่อนสกิลจากโมเดลได้ด้วย metadata ตั้งค่าเป็น opencode/autoinvoke: false. ฟิลด์เหล่านี้มีประโยชน์ แต่สิ่งที่พาไปใช้ที่อื่นได้คือฟิลด์มาตรฐาน เอกสารของ Claude Code เองระบุว่า นอก Claude Code เช่นในการอัปโหลดผ่าน claude.ai หรือ Skills API จะรับเฉพาะฟิลด์มาตรฐานเท่านั้น ฟิลด์อื่นถือเป็นข้อผิดพลาด สำหรับสกิลที่คุณแชร์ ให้ใช้เพียง ตั้งชื่อ, คำอธิบาย, license, compatibility, metadata และฟิลด์ทดลอง allowed-tools.

โครงสร้างของ agent skill: front matter ใน SKILL.md ที่อ่านตอนเริ่มทำงานราว 100 โทเคน, คำแนะนำที่อ่านเมื่อมีงานตรงกัน และ reference, สคริปต์ และแอสเซ็ตที่อ่านเฉพาะเมื่อจำเป็น
สามชั้น: ป้ายชื่อ สูตร และภาคผนวก มีเพียงชั้นแรกที่ถูกโหลดเสมอ นี่คือเหตุผลที่คำอธิบายที่ดีสำคัญกว่าคำสั่งยาว ๆ

ตอนที่ 11 — ปลอดภัยไว้ก่อน: สกิลและเซิร์ฟเวอร์ก็คือซอฟต์แวร์

เป็นเรื่องง่ายที่จะคิดว่าสกิลเป็นแค่ “ไฟล์ Markdown” แต่จริง ๆ ไม่ใช่ มันคือคำสั่งที่เอเจนต์ของคุณจะทำตาม ด้วยสิทธิ์ของคุณ, บ่อยครั้งพร้อมสคริปต์ที่มันจะรันบนเครื่องของคุณ และ MCP เซิร์ฟเวอร์แบบโลคัลคือโปรแกรมที่ทำงานในสิทธิ์ของคุณ

ตัวเลขจากปีนี้น่าตกใจ การศึกษา ToxicSkills ของ Snyk ที่เผยแพร่ในเดือนกุมภาพันธ์ 2026 สแกนสกิลเอเจนต์สาธารณะ 3,984 รายการ: 36.82% มีช่องโหว่ด้านความปลอดภัยอย่างน้อยหนึ่งจุด 13.4% มีช่องโหว่ระดับวิกฤต และ 76 รายการมีเพย์โหลดอันตรายที่ยืนยันแล้ว ปัญหากระจุกตัวอยู่ที่ ClawHub มาร์เก็ตเพลสชุมชนของ OpenClaw ที่การตรวจสอบก่อนหน้านี้ 2,857 สกิล ซึ่งรายงานโดย Snyk เช่นกัน พบว่า 341 รายการเป็นอันตราย คิดเป็นราว 12% ของรีจิสทรีในตอนนั้น ตรงกันข้าม สกิลยอดนิยม 100 อันดับแรกบน skills.sh ไม่ติดการตรวจการฉีดพรอมต์หรือโค้ดอันตรายของ Snyk เลย ความนิยมไม่ใช่หลักประกัน แต่มันช่วยได้

MCP ก็มีความเสี่ยงในรูปแบบของตัวเอง เอกสารของ Claude Code เตือนว่าเซิร์ฟเวอร์ที่ดึงเนื้อหาจากภายนอกอาจทำให้คุณเจอกับ พรอมต์อินเจกชัน: หน้าเว็บ ความคิดเห็นใน issue หรือรายงานการแครชที่มีข้อความมุ่งเป้าไปที่เอเจนต์ของคุณแทนที่จะเป็นคุณ

สิบนิสัยที่ช่วยให้คุณปลอดภัย

  1. อ่านก่อนติดตั้ง การใช้งาน npx skills add owner/repo --list, gh skill preview, หรือเพียงเปิด SKILL.md และสคริปต์ของมันบน GitHub
  2. เลือกใช้ของผู้สร้างและผู้เขียนที่รู้จักก่อน สกิลของ Expo สำหรับ Expo ของ Vercel สำหรับ Next.js และเซิร์ฟเวอร์ MCP อย่างเป็นทางการของผู้ให้บริการสำหรับบริการของตัวเอง
  3. ตรวจผลการตรวจสอบ สกิลแต่ละตัวบน skills.sh แสดงผลจากตัวสแกนสามตัว ได้แก่ Gen Agent Trust Hub, Socket และ Snyk “รอดำเนินการ” หมายความว่ายังไม่มีใครตรวจ
  4. ล็อกเวอร์ชันของสิ่งที่สำคัญไว้ npx skills add owner/[email protected], หรือ gh skill install … --pin v1.2.3, ดังนั้นการอัปเดตจะเกิดขึ้นเมื่อคุณเลือกเอง
  5. ตรวจทานการอัปเดตเหมือนตรวจโค้ด npx skills check, จากนั้นอ่านการเปลี่ยนแปลงบน GitHub แล้วจึง npx skills update.
  6. ตั้งด่านตรวจสกิลของบุคคลที่สาม ใน OpenCode กฎจะใช้ skill แอ็กชัน และกฎที่ตรงกันตัวสุดท้ายจะเป็นผู้ชนะ:

jsonc "permissions": [ { "action": "skill", "resource": "*", "effect": "ask" }, { "action": "skill", "resource": "skills-housekeeping", "effect": "allow" }, { "action": "playwright_*", "resource": "*", "effect": "ask" } ]

Hermes Agent สแกนทุกการติดตั้งจากฮับ และ --force ไม่สามารถข้ามคำตัดสิน “อันตราย” ได้ Gemini CLI จะขอความยินยอมจากคุณก่อนเปิดใช้งานสกิล 7. ให้สิทธิ์เซิร์ฟเวอร์น้อยที่สุดเท่าที่ใช้งานได้ โทเคนแบบอ่านอย่างเดียวและแบบละเอียด; แยกโทเคนต่อเซิร์ฟเวอร์; เครื่องมือเขียนและลบตั้งเป็น “ถาม” หรือกรองออก 8. อย่าเก็บความลับไว้ในสกิลหรือไฟล์คอนฟิกที่คอมมิต ใช้ตัวแปรสภาพแวดล้อม ({env:NAME} ใน OpenCode, ${VAR} ในไฟล์ของ Claude Code .mcp.json, ${env:NAME} ใน Cursor) ห้ามวางคีย์โดยตรง 9. ระวังการตั้งค่าโปรเจกต์ของคนอื่น รีโปที่โคลนมาอาจมี .mcp.json หรือสกิลติดมาด้วย Claude Code จะถามก่อนใช้เซิร์ฟเวอร์ของโปรเจกต์ Gemini CLI จะตัดการเชื่อมต่อเซิร์ฟเวอร์โลคอลในโฟลเดอร์ที่ไม่น่าไว้วางใจ และ Hermes Agent จะโหลดสกิลของโปรเจกต์เฉพาะหลังจาก hermes skills trust. อย่ากดผ่านพรอมต์เหล่านั้นแบบไม่คิด 10. ถอนการติดตั้งสิ่งที่ไม่ใช้ ทุกสกิลและเซิร์ฟเวอร์ที่ไม่ได้ใช้ล้วนเป็นพื้นผิวการโจมตีที่คุณต้องแลกด้วยบริบท

เช็กลิสต์ความปลอดภัยของ Agent skills และ MCP: ตัวเลข ToxicSkills ของ Snyk สำหรับ skill สาธารณะ 3,984 รายการ และนิสัยปลอดภัยสิบข้อ ตั้งแต่การอ่านก่อนติดตั้งและปักหมุดเวอร์ชันไปจนถึงโทเคนแบบสิทธิ์น้อยที่สุด
สกิลคือชุดคำสั่งที่เอเจนต์ของคุณทำตามด้วยสิทธิ์ของคุณ ติดตั้งมันด้วยความระมัดระวังเหมือนกับซอฟต์แวร์อื่น ๆ

ตอนที่ 12 — กิจวัตรสองนาทีทุกสัปดาห์

สกิลและเซิร์ฟเวอร์ค่อย ๆ คลาดเคลื่อนได้ กิจวัตรเล็ก ๆ ช่วยให้ทุกอย่างตรงตามจริง:

# สกิลโกลบอล จากโฟลเดอร์ที่เป็นกลาง
cd /tmp && npx skills@latest check -g

# แต่ละโปรเจกต์ที่คุณกำลังทำอยู่
cd ~/code/my-app && npx skills@latest check -p

# หลังจากอ่านสิ่งที่เปลี่ยนต้นทางแล้ว:
npx skills update -g

เดือนละครั้ง ใช้เวลาอีกห้านาที:

  • ตัดทิ้ง npx skills ls -g และลบสิ่งที่คุณยังไม่ได้ใช้ ใน Claude Code แผงปลั๊กอินจะแสดงปลั๊กอินที่คุณไม่ได้ใช้เมื่อเร็ว ๆ นี้
  • ดูรายการเซิร์ฟเวอร์ของคุณ opencode mcp list, claude mcp list, gemini mcp list หรือ hermes mcp test สำหรับแต่ละรายการ ลบรายการที่คุณ’ลืมว่าได้เพิ่มเข้าไปออก
  • หมุนเวียนโทเคน ที่คุณให้แก่เซิร์ฟเวอร์ โดยเฉพาะตัวที่เขียนข้อมูลได้

สองเครื่อง หนึ่งชุดการตั้งค่า

ผมรันเอเจนต์บน Mac และบน Raspberry Pi และมีสามนิสัยที่ทำให้ทั้งสองเครื่องไปด้วยกัน:

  1. ใช้วิธีเดียวกันทั้งสองเครื่อง: บัญชีผู้ใช้ปกติของคุณ ไม่ใช่ sudoและรัน CLI จากโฟลเดอร์โปรเจกต์ หรือ /tmp.
  2. สกิลระดับโปรเจกต์เดินทางไปกับ Git คอมมิต .agents/skills และ skills-lock.jsonส่วนอีกเครื่องหนึ่ง npx skills install จะกู้คืนเวอร์ชันเดิมได้ตรงกันทุกประการ
  3. สกิลระดับโกลบอลมาจากสคริปต์ เก็บ npx skills add … -g คำสั่งไว้ในไฟล์ shell เล็ก ๆ แล้วรันบนแต่ละเครื่อง มันยังทำหน้าที่เป็นเอกสารว่าคุณพึ่งพาอะไรอยู่

บนเครื่องแบบ headless อย่าง Pi ให้ตั้งค่า GITHUB_TOKEN ใน ~/.bashrc เพื่อให้การตรวจอัปเดตไม่ชนเพดานแบบไม่ระบุตัวตน การลงชื่อเข้าใช้ผ่านเบราว์เซอร์ต้องระวัง: OpenCode ให้คุณวาง callback URL ลงในพรอมต์ได้ Hermes Agent มีทั้งการวางกลับ (paste-back), SSH port forwarding หรือ device flow ขณะที่ OAuth ของ Gemini CLI’ต้องใช้เบราว์เซอร์บนเครื่องเดียวกัน


ตอนที่ 13 — คุณควรเลือกการตั้งค่าแบบไหน? ห้าสถานการณ์

1. “ผมเพิ่งเริ่มใช้ OpenCode”

ติดตั้ง สกิลไม่เกินสามตัว และ MCP server หนึ่งตัว. Context7 เป็นเซิร์ฟเวอร์ตัวแรกที่ดี และสกิลด้านการปล่อยเวอร์ชันหรือรีวิวที่ตรงกับวิธีทำงานของคุณก็เป็นสกิลแรกที่ดี ตั้งสกิลของบุคคลที่สามไว้ที่ ถาม ในการตั้งค่าสิทธิ์ของ OpenCode จนกว่าคุณจะไว้วางใจมัน คู่มือ OpenCode ของผม ของผมครอบคลุมการตั้งค่าส่วนที่เหลือ

2. “ผมใช้ OpenCode กับ Claude Code คู่กัน บางทีก็ Hermes Agent ด้วย”

ติดตั้งสกิล แบบโกลบอลด้วย CLI แล้วระบุชื่อเอเจนต์ทุกตัว: npx skills add owner/repo -g -a opencode -a claude-code -a hermes-agent. สำเนาเดียว สามเอเจนต์ MCP server ไม่ได้ใช้ไฟล์คอนฟิกร่วมกัน ดังนั้นต้องเพิ่มแต่ละตัวให้แต่ละเอเจนต์ และเก็บรายการไว้ในที่ที่คุณจะหาเจอ บทความ การเปรียบเทียบ OpenCode, Hermes Agent และ OpenClaw อธิบายว่าแต่ละเอเจนต์เด่นเรื่องใด และ การเปรียบเทียบ AI coding harness ของผม ของผมเปรียบเทียบ 28 ตัวแบบเคียงข้างกัน

3. “ทีมของผมใช้รีโปเดียวกัน”

การใช้งาน ขอบเขตโปรเจกต์: คอมมิต .agents/skills, skills-lock.jsonและการตั้งค่า MCP (opencode.jsonc, .mcp.json หรือ .cursor/mcp.json) โดยไม่มีข้อมูลลับอยู่ในนั้น. แต่ละคนเก็บคีย์ไว้ใน environment ของตัวเอง ใน CI npx skills install --frozen-lockfile จะล้มเหลวถ้าสกิลของใครคนใดคลาดเคลื่อน และ npx skills check -p จะล้มเหลวเมื่อมีอัปเดตรออยู่

4. “เอเจนต์ของผมรันบน Raspberry Pi หรือเซิร์ฟเวอร์”

ผู้ใช้ปกติหนึ่งคน ไม่มี sudoเด็ดขาด ตั้ง GITHUB_TOKENให้เลือกเซิร์ฟเวอร์ระยะไกลที่รับโทเค็นในเฮดเดอร์ (หรือมีการลงชื่อเข้าใช้จากอุปกรณ์) และรันการตรวจสอบรายสัปดาห์จาก /tmp. ส่วนที่ 6 คือเช็กลิสต์ของคุณ

5. “โค้ดของฉันต้องไม่ออกจากเครื่องของฉัน”

การใช้งาน ใช้เฉพาะเซิร์ฟเวอร์ MCP ภายในเครื่อง, และข้ามเซิร์ฟเวอร์เอกสารและค้นหาโค้ดระยะไกล ปิดการส่งข้อมูลเทเลเมทรีของ CLI (DISABLE_TELEMETRY=1), อ่านทุกสกิลที่คุณติดตั้ง และจำไว้ว่าตัวโมเดลเองอาจยังเป็นโมเดลบนคลาวด์: ความเป็นส่วนตัวขึ้นอยู่กับว่า โมเดล รันอยู่ที่ไหนด้วย คู่มือของฉันเรื่อง การรัน LLM บน MacBook อธิบายว่าการใช้เส้นทางภายในเครื่องล้วน ๆ มีต้นทุนจริงเท่าไร


คำถามที่พบบ่อย

สกิลของเอเจนต์คืออะไร

สกิลของเอเจนต์คือโฟลเดอร์ที่สอนเอเจนต์ AI ว่าต้องทำงานเฉพาะอย่างหนึ่งอย่างไร แต่ละสกิลมีไฟล์ SKILL.md ที่มีชื่อ คำอธิบาย และคำแนะนำทีละขั้นตอน พร้อมสคริปต์และไฟล์อ้างอิงเสริม เอเจนต์อ่านเฉพาะคำอธิบายตอนเริ่มต้นเซสชัน และจะโหลดคำแนะนำฉบับเต็มของสกิลเมื่อมีงานที่ตรงกัน สกิลเป็นไปตามมาตรฐานเปิด สกิลส่วนใหญ่จึงใช้ได้ทั้งใน OpenCode, Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot และ Hermes Agent

เซิร์ฟเวอร์ MCP คืออะไร

เซิร์ฟเวอร์ MCP คือโปรแกรมเล็ก ๆ ที่มอบเครื่องมือใหม่ให้เอเจนต์ AI ผ่าน Model Context Protocol ซึ่งเป็นมาตรฐานเปิดที่ปัจจุบันอยู่ภายใต้ Agentic AI Foundation ของ Linux Foundation เซิร์ฟเวอร์ภายในเครื่องรันบนคอมพิวเตอร์ของคุณและเอเจนต์เป็นตัวเริ่มมัน ส่วนเซิร์ฟเวอร์ระยะไกลรันบนคอมพิวเตอร์ของผู้ให้บริการและเข้าถึงผ่านที่อยู่เว็บ มักใช้การลงชื่อเข้าใช้ผ่านเบราว์เซอร์ ตัวอย่างได้แก่เซิร์ฟเวอร์อย่างเป็นทางการของ GitHub, Context7 สำหรับเอกสารล่าสุด และ Playwright สำหรับควบคุมเบราว์เซอร์

สกิลของเอเจนต์กับเซิร์ฟเวอร์ MCP ต่างกันอย่างไร

สกิลให้ความรู้เชิงวิธีทำแก่เอเจนต์ คือคำแนะนำเป็นลายลักษณ์อักษรว่าต้องทำงานหนึ่งอย่างไร และโหลดเฉพาะเมื่อจำเป็น เซิร์ฟเวอร์ MCP ให้ความสามารถแก่เอเจนต์ คือเครื่องมือที่เข้าถึงระบบนอกเทอร์มินัล เช่น GitHub, เบราว์เซอร์ หรือตัวติดตามแครช ใช้สกิลกับขั้นตอนและข้อตกลง ใช้เซิร์ฟเวอร์ MCP สำหรับการเข้าถึงระบบแบบสด ๆ และ AGENTS.md สำหรับกฎที่ใช้กับทุกงาน ถ้ามีเครื่องมือบรรทัดคำสั่งที่ดีอยู่แล้ว สกิลที่สอนให้เอเจนต์ใช้เครื่องมือนั้นมักถูกกว่าการใช้เซิร์ฟเวอร์

สกิลทำงานเหมือนกันใน OpenCode, Claude Code และ Codex หรือไม่

ส่วนใหญ่ใช้ได้ เพราะทั้งสามตัวเป็นไปตามมาตรฐาน Agent Skills ความต่างอยู่ที่ตำแหน่งที่มันค้นหา Codex และ OpenCode อ่านโฟลเดอร์ที่ใช้ร่วมกัน .agents/skills และ ~/.agents/skills ส่วน OpenCode ยังอ่าน .opencode/skills และโฟลเดอร์ของ Claude Code Claude Code อ่านเฉพาะ .claude/skills และ ~/.claude/skills. ฟิลด์ front matter เพิ่มเติมบางตัว เช่น context: forkใช้ได้กับเอเจนต์เดียวเท่านั้น สกิลที่ใช้ร่วมกันจึงควรยึดฟิลด์มาตรฐาน

จะติดตั้งสกิลด้วย npx skills ได้อย่างไร

เรียกใช้ npx skills add owner/repo --list เพื่อดูสกิลที่รีโพซิทอรีมีให้ จากนั้น npx skills add owner/repo --skill skill-name -a opencode -a claude-code เพื่อติดตั้งสกิลหนึ่งสำหรับเอเจนต์ที่คุณใช้ เพิ่ม -g เพื่อให้ใช้ได้ในทุกโปรเจกต์ คุณต้องมี Node.js 22.20 ขึ้นไป หากไม่ใส่แฟล็ก CLI จะถามว่าต้องการสกิลและเอเจนต์ใด และจะลิงก์หรือคัดลอกไฟล์

npx skills ติดตั้งสกิลไว้ที่ไหน

การติดตั้งระดับโปรเจกต์วางสำเนาจริงไว้ใน .agents/skills/<name> ภายในโปรเจกต์ของคุณและบันทึกไว้ใน skills-lock.json. การติดตั้งแบบโกลบอล (-g) วางไว้ใน ~/.agents/skills/<name> และบันทึกไว้ใน ~/.agents/.skill-lock.json. เอเจนต์ที่อ่าน .agents/skills จะใช้สำเนานั้นโดยตรง สำหรับเอเจนต์ที่มีโฟลเดอร์ของตัวเอง เช่น Claude Code (.claude/skills) หรือ Hermes Agent (~/.hermes/skills) CLI จะสร้างลิงก์ไปยังสำเนานั้น

จะรู้ได้อย่างไรว่าสกิลของคุณเป็นเวอร์ชันล่าสุด

เรียกใช้ npx skills@latest check -g สำหรับสกิลโกลบอล หรือ npx skills@latest check -p ภายในโปรเจกต์ CLI จะเทียบลายนิ้วมือของแต่ละโฟลเดอร์สกิลในไฟล์ล็อกของคุณกับโฟลเดอร์เดียวกันบนต้นทาง และแสดงรายการสกิลที่มีอัปเดต โดยไม่ติดตั้งอะไรเลย ตั้งแต่เวอร์ชัน 1.7.5 (2 พฤศจิกายน 2026) check จะรายงานเท่านั้น; npx skills update ติดตั้ง รันจากโฟลเดอร์โปรเจกต์ หรือ /tmpไม่ใช่โฟลเดอร์โฮมของคุณ

ทำไม npx skills ถึงบอกว่าสกิลทั้งหมดอัปเดตแล้วทั้งที่การตรวจสอบล้มเหลว

เพราะสรุปนับเฉพาะอัปเดตที่มันเจอ หากขีดจำกัด 60 คำขอ API แบบไม่ระบุตัวตนต่อชั่วโมงของ GitHub บล็อกการค้นหาทุกครั้ง CLI จะพิมพ์บรรทัด ✗ สำหรับแต่ละซอร์ส และยังจบด้วยข้อความ “สกิลโกลบอลทั้งหมดเป็นเวอร์ชันล่าสุด” ได้ ลงชื่อเข้าใช้ด้วย gh auth login หรือตั้งค่าโทเค็นแบบอ่านอย่างเดียว GITHUB_TOKEN เพื่อเพิ่มขีดจำกัดเป็น 5,000 คำขอต่อชั่วโมง ให้อัปเกรดด้วย npx skills@latestและอ่านบรรทัดที่มี ✗ เสมอ

ควรใช้ sudo กับ npx skills หรือไม่

ไม่ใช่ สกิลถูกเก็บแยกตามผู้ใช้ และ root มีโฟลเดอร์ home ของตัวเอง ดังนั้น sudo จะติดตั้งสกิลไว้ใน /root/.agents/skillsซึ่งเอเจนต์ที่รันด้วยผู้ใช้ปกติของคุณจะมองไม่เห็น มันยังอาจทิ้งไฟล์ที่เป็นของ root ไว้ในโฟลเดอร์ของคุณ และทำให้เกิดข้อผิดพลาดของ npm เช่น “ไม่สามารถเปลี่ยน prefix จากคอนฟิกของโปรเจกต์ได้” ให้รัน CLI และเอเจนต์ของคุณด้วยผู้ใช้ปกติ

จะเพิ่มเซิร์ฟเวอร์ MCP ใน OpenCode ได้อย่างไร

เรียกใช้ opencode mcp add <name> --url <address> สำหรับเซิร์ฟเวอร์ระยะไกล หรือ opencode mcp add <name> -- <command> สำหรับเซิร์ฟเวอร์ในเครื่อง แล้วตรวจสอบด้วย opencode mcp listจากนั้นเพิ่ม --global เพื่อใช้ในทุกโปรเจกต์ การตั้งค่าเดียวกันอยู่ใน mcp.servers ใน opencode.jsoncโดยเขียนความลับเป็น {env:NAME}ใช้ opencode mcp auth <name> เพื่อลงชื่อเข้าใช้ และ /mcps ภายในเซสชันเพื่อเชื่อมต่อหรือตัดการเชื่อมต่อเซิร์ฟเวอร์

ควรติดตั้งเซิร์ฟเวอร์ MCP กี่ตัว

ให้น้อยที่สุดเท่าที่คุณใช้จริง ปกติสองถึงห้าเครื่อง เครื่องมือของแต่ละเซิร์ฟเวอร์มาพร้อมคำอธิบายที่โมเดลต้องอ่าน ซึ่งกินบริบทและทำให้คำตอบช้าลงและโฟกัสน้อยลง Claude Code เลื่อนการนิยามเครื่องมือออกไปจนกว่าจะจำเป็น และ OpenCode จัดกลุ่มเครื่องมือตามเซิร์ฟเวอร์ ซึ่งช่วยได้ แต่เซิร์ฟเวอร์ที่ไม่ได้ใช้ก็ยังเพิ่มความเสี่ยงและความรก ให้ลบสิ่งที่คุณไม่ได้ใช้มากกว่าหนึ่งเดือน

สกิลของเอเจนต์ปลอดภัยพอที่จะติดตั้งหรือไม่

ปลอดภัยได้เพียงเท่ากับแหล่งที่มาของมัน สกิลคือคำสั่งที่เอเจนต์ของคุณทำตามด้วยสิทธิ์ของคุณ และมักมีสคริปต์ที่มันรันด้วย การศึกษาเมื่อเดือนกุมภาพันธ์ 2026 ของ Snyk ที่ตรวจสกิลสาธารณะ 3,984 รายการ พบช่องโหว่ด้านความปลอดภัยใน 36.82% และยืนยันเพย์โหลดอันตรายใน 76 รายการ อ่านสกิลและสคริปต์ของมันก่อนติดตั้ง เลือกสกิลจากผู้สร้างเครื่องมือนั้น ตรวจผลการตรวจสอบบน skills.sh ล็อกเวอร์ชันไว้ และตั้งสกิลของบุคคลที่สามเป็น “ask” ในการอนุญาตของเอเจนต์

skills-lock.json คืออะไร

มันคือไฟล์ล็อกของโปรเจกต์ที่ skills CLI เขียนเมื่อคุณติดตั้งสกิลลงในโปรเจกต์ โดยบันทึกว่าสกิลแต่ละตัวมาจากไหนและลายนิ้วมือของไฟล์ในสกิล คอมมิตไฟล์นี้เข้า Git: บนคอมพิวเตอร์อีกเครื่อง npx skills install จะกู้คืนสกิลชุดเดียวกันเป๊ะ และ --frozen-lockfile จะล้มเหลวหากมีอะไรแตกต่าง สกิลระดับโกลบอลมีไฟล์ล็อกแยกที่ ~/.agents/.skill-lock.jsonหนึ่งไฟล์ต่อบัญชีผู้ใช้

skills.sh คืออะไร

skills.sh คือไดเรกทอรีสาธารณะของสกิลเอเจนต์จาก Vercel จัดอันดับสกิลตามจำนวนการติดตั้ง จัดกลุ่มตามหัวข้อ และแสดงผลการตรวจสอบความปลอดภัยจาก Gen Agent Trust Hub, Socket และ Snyk ของแต่ละสกิล คุณติดตั้งสกิลจากที่นี่ด้วย npx skills add owner/repo คำสั่งที่มันแสดงให้ดู ส่วนคำสั่งของ CLI ตัวเดียวกัน npx skills find จะค้นหาไดเรกทอรีจากเทอร์มินัลของคุณ

บทสรุป

สกิลของเอเจนต์และเซิร์ฟเวอร์ MCP ตอบคำถามที่ต่างกันสองข้อ สกิลตอบคำถาม “เราทำสิ่งนี้ที่นี่อย่างไร”: มันคือการ์ดสูตรที่ราคาถูกและพกพาได้ ซึ่งโหลดเฉพาะเมื่อจำเป็น เซิร์ฟเวอร์ MCP ตอบคำถาม “คุณเข้าถึงระบบนั้นได้หรือไม่”: มันคือกุญแจทรงพลังที่กินบริบท และสมควรได้รับการดูแลเหมือนซอฟต์แวร์ใด ๆ ที่คุณติดตั้ง AGENTS.md เก็บกฎไม่กี่ข้อที่ใช้กับทุกอย่าง และสิทธิ์การอนุญาตบังคับสิ่งที่ต้องไม่เกิดขึ้นเด็ดขาด

หากคุณจะจดจำห้าสิ่งจากคู่มือนี้ จดสิ่งเหล่านี้:

  1. วางสกิลที่ใช้ร่วมกันไว้ใน .agents/skills และให้ npx skills ลิงก์สกิลเหล่านั้นเข้าไปในเอเจนต์ที่ค้นหาที่อื่น
  2. เรียกใช้ npx skills@latest check จากโฟลเดอร์โปรเจกต์ หรือ /tmp, อ่านบรรทัดที่มี ✗ และอัปเดตอย่างตั้งใจ
  3. ลงชื่อเข้าใช้ GitHub (gh auth login) บนทุกเครื่องที่ตรวจหาการอัปเดต
  4. ห้ามใช้ sudo กับสกิลหรือเอเจนต์
  5. เริ่มด้วยสกิลสามตัวและเซิร์ฟเวอร์หนึ่งเครื่อง และเพิ่มเติมเฉพาะเมื่อมีงานจริงที่ต้องใช้เท่านั้น

สกิลและเซิร์ฟเวอร์เปลี่ยนผู้เชี่ยวชาญอเนกประสงค์ที่เก่งกาจให้กลายเป็นเพื่อนร่วมงานที่รู้วิธีทำงานของคุณและเข้าถึงเครื่องมือของคุณได้ เคล็ดลับคือให้สิ่งที่จำเป็นพอดี และไม่ให้สิ่งที่มันไม่ต้องการ


คุณใช้สกิลหรือ MCP เซิร์ฟเวอร์ที่ผมยังไม่ได้กล่าวถึงอยู่หรือเปล่า ผมอยากรู้ว่าตัวไหนได้ที่ทางถาวรในการตั้งค่าของคุณ และข้อความข้อผิดพลาดใดทำให้คุณต้องไปค้นหา ข้อแก้ไขยินดีรับเสมอ บทความนี้จะได้รับการอัปเดตเมื่อเครื่องมือเปลี่ยน ซึ่งดูจากปีนี้แล้วคงจะบ่อย

การเปิดเผย: ไม่มีบริษัทใดที่ถูกกล่าวถึงในบทความนี้สนับสนุน ตรวจทาน หรืออนุมัติบทความนี้ และบทความนี้ไม่มีลิงก์ affiliate ชื่อผลิตภัณฑ์ปรากฏในเนื้อหาเท่านั้น ภาพต่าง ๆ ใช้โลโก้ของผมเอง

อัปเดตล่าสุด: 15 พฤศจิกายน 2026

เพิ่มสัญญาณของคุณ

อีเมลของคุณจะไม่ถูกเผยแพร่ ช่องข้อมูลจำเป็นถูกทำเครื่องหมาย *

thไทย