รีวิว addyosmani/agent-skills — วินัยแบบ senior engineer สำหรับ AI coding agent

คืออะไร

addyosmani/agent-skills เป็นชุด skills สำหรับ AI coding agents ที่นิยามตัวเองว่า "Production-grade engineering skills for AI coding agents" (ตามคำอธิบายของ repo เอง) จุดของมันคือแพ็ก workflow ของ senior engineer — ตั้งแต่นิยามงาน วางแผน ลงมือเขียน ทดสอบ รีวิว ไปจน deploy — มาเป็นชุดคำสั่งและกติกาที่ agent อ่านแล้วทำตามได้

หน้าเว็บของโปรเจกต์อยู่ที่ skills.addy.ie ขณะที่รีวิวนี้ repo มีดาว 104.1k และ fork 10.9k (ข้อมูล ณ 10 ต.ค. 2026) ภาษาหลักของ repo คือ JavaScript

โครงสร้างภายในแบ่งตามช่วงของ lifecycle เลย:

  DEFINE          PLAN           BUILD          VERIFY         REVIEW          SHIP
 ┌──────┐      ┌──────┐      ┌──────┐      ┌──────┐      ┌──────┐      ┌──────┐
 │ Idea │ ───▶ │ Spec │ ───▶ │ Code │ ───▶ │ Test │ ───▶ │  QA  │ ───▶ │  Go  │
 │Refine│      │  PRD │      │ Impl │      │Debug │      │ Gate │      │ Live │
 └──────┘      └──────┘      └──────┘      └──────┘      └──────┘      └──────┘
  /spec          /plan          /build        /test         /review       /ship

มีทั้งหมด 25 skills (24 lifecycle skills + meta-skill ชื่อ using-agent-skills) และ 9 slash commands เป็นจุดเข้าใช้งาน

จุดเด่น

• 9 slash commands ผูกกับช่วงงานชัดเจน: /spec, /plan, /build, /test, /constraints, /review, /webperf, /code-simplify, /ship — แต่ละคำสั่งจะเรียก skill ที่เกี่ยวข้องให้อัตโนมัติ
• /build auto สร้างแผนแล้วลงมือทำทุก task ในรอบเดียวที่อนุมัติแล้ว โดย README ระบุว่ายังคง test-driven และ commit แยกทีละ task และจะหยุดเมื่อเจอ failure หรือขั้นตอนเสี่ยง โดยคนยังเป็นคนกด approve
• constraint-driven-development เขียน quality bar ลงไฟล์ CONSTRAINTS.md พร้อมจัดตำแหน่ง check ตามต้นทุน และตั้งใจจับกรณี agent ปิด check หรือข้ามเทสต์เพื่อให้ผ่าน
• code-review-and-quality มีรีวิว 5 แกน แนะนำขนาด change ราว ๆ 100 บรรทัด และป้ายระดับความรุนแรง (Nit/Optional/FYI)
• source-driven-development บังคับให้อ้างเอกสารทางการของ framework พร้อม cite ที่มา และ doubt-driven-development ใช้ตรวจงานแบบ adversarial ตอนงานมีความเสี่ยงสูง
• เขียนเป็น Markdown ล้วน ใช้กับ agent ที่รับ system prompt หรือ instruction files ได้ทุกตัว
• ติดตั้งครั้งเดียวผ่าน skills CLI ของ vercel-labs เข้าได้กว่า 70 agents (Claude Code, Cursor, Codex, Copilot, Cline ฯลฯ)
• มี Adoption Guide แยกสองทาง: ใช้ lifecycle เต็มตั้งแต่แรกสำหรับโปรเจกต์ใหม่ หรือ rollout แบบ incremental ยืนยันก่อนสำหรับ codebase เดิม

เหมาะกับใคร

• คนที่ใช้ AI coding agent อยู่แล้ว แต่ผลงานไม่สม่ำเสมอ เพราะไม่มี spec, ไม่มี test gate, ไม่มีขั้นตอน pre-merge
• ทีมที่อยากให้ agent ทุกตัว (ไม่ว่าจะ Claude Code, Cursor, Codex หรือ Copilot) ทำตามกติกาเดียวกัน
• คนที่ทำงานคนเดียวหรือทีมเล็ก แล้วอยากมี process ที่ชัดโดยไม่ต้องเขียน prompt/rule เองทั้งหมด
• ไม่เหมาะกับคนที่อยากได้ผลลัพธ์แบบ "พิมพ์บรรทัดเดียวจบ" — ชุดนี้เน้นกระบวนการ

เริ่มต้นใช้งาน

ทางเร็วที่สุด คือใช้ skills CLI ของ vercel-labs เข้าได้กับ agent กว่า 70 ตัวในคำสั่งเดียว:

npx skills add addyosmani/agent-skills            # install all 25 skills
npx skills add addyosmani/agent-skills --list     # browse before installing

ถ้าอยากเอาเฉพาะบางตัว:

npx skills add addyosmani/agent-skills --skill code-review-and-quality   # five-axis review before merge
npx skills add addyosmani/agent-skills --skill interview-me              # requirements interrogation, one question at a time
npx skills add addyosmani/agent-skills --skill test-driven-development   # red-green-refactor, enforced

ถ้าชอบแบบ native integration ตามตัว tool:

Claude Code (recommended)

/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

Codex (ต้องเป็น Codex CLI v0.122+)

codex plugin marketplace add addyosmani/agent-skills
codex plugin add agent-skills@agent-skills

Antigravity CLI

agy plugin install https://github.com/addyosmani/agent-skills.git

Gemini CLI

gemini skills install https://github.com/addyosmani/agent-skills.git --path skills

Command Code

cmd skills add addyosmani/agent-skills            # pick skills to install (project)
cmd skills add addyosmani/agent-skills --global   # install for all projects (~/.commandcode/skills/)
cmd skills add addyosmani/agent-skills -s spec-driven-development  # install a specific skill

ส่วน Cursor, Windsurf, OpenCode, Copilot และ Kiro มีวิธีเฉพาะอยู่ในโฟลเดอร์ docs/ ของ repo ครับ

ข้อควรรู้

• License: MIT (MIT License) เป็น license แบบเปิดกว้าง ใช้งานเชิงพาณิชย์ได้ แต่ถ้าจะนำไปใช้จริง ๆ แนะนำให้เปิดอ่านไฟล์ LICENSE ในตัว repo อีกครั้งก่อน
• ความสด: push ล่าสุด 4 ต.ค. 2026 และยังไม่ถูก archive — ถือว่ายัง active อยู่ (ข้อมูล ณ 10 ต.ค. 2026)
• อายุโปรเจกต์: สร้างเมื่อ 15 ก.พ. 2026 ตอนรีวิวนี้อายุไม่ถึงปี ราว 8 เดือน — ตำแหน่ง skill, ชื่อคำสั่ง และวิธีติดตั้งอาจเปลี่ยนตามไป
• ข้อจำกัดเรื่องติดตั้ง skill เดี่ยว: การติดตั้งด้วย npx skills add --skill <ชื่อ> จะก๊อปแค่ skills/<name>/ ไม่ได้ก๊อป references/ ระดับ repo มาด้วย skill ยังใช้ได้ แต่ path ที่ชี้ไปยัง checklist ส่วนร่วมจะใช้ไม่ได้ README บอกว่าติดตามเรื่องนี้อยู่ที่ issue #361
• ข้อจำกัดกับ Antigravity CLI: README ระบุว่าในบางรุ่นของ Antigravity CLI legacy command TOMLs ถูกรายงานว่าแปลงสำเร็จ แต่ wrapper commands กลับค้นไม่เจอ ต้องเรียก underlying namespaced skills โดยตรงแทน
• เรื่องคุณภาพงาน: ตัว skill เองออกแบบมาให้จับกรณี agent ที่พยายามทำให้ test ผ่านโดยข้ามขั้นตอน แต่สุดท้ายผลงานก็ยังต้องมีคนอ่าน diff ก่อน merge เหมือนปกติ
• open issues: ค้างอยู่ 139 เรื่อง ณ 10 ต.ค. 2026 — repo ใหม่และยังมีอะไรปรับอยู่เรื่อย ๆ เวลาอ่าน docs ควรยืนยันกับโค้ดล่าสุดอีกครั้ง

🔗 https://github.com/addyosmani/agent-skills

ข้อมูลจาก GitHub ณ 10 ต.ค. 2026: ⭐ 104,106 | ภาษา JavaScript | license MIT