> For the complete documentation index, see [llms.txt](https://getsquish.gitbook.io/squish/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://getsquish.gitbook.io/squish/th/recipes/agent-skill.md).

# ติดตั้งทักษะสำหรับเอเจนต์

ทักษะนี้ **`video-navigation`** ทักษะนี้คือเอกสารโปรโตคอลแบบเสียบใช้ได้ทันที ที่สอนเอเจนต์ทั้งกระบวนการ: เมื่อได้รับวิดีโอที่มันรับเข้าไม่ได้ ให้บีบอัดเป็นชีตภาพย่อที่มีเวลาอ้างอิง อ่านตาราง แล้วซูมเข้าไปดูช่วงเวลาต่างๆ ด้วย `เริ่ม`/`สิ้นสุด` แทนที่จะเดา ให้ยืนยันก่อนอ้างอิง และตอบด้วยไทม์โค้ดแบบแน่นอน เอเจนต์ที่ติดตั้งทักษะนี้ไว้จะเรียกใช้ Squish เองโดยอัตโนมัติ คุณไม่ต้องอธิบายขั้นตอนการทำงานในพรอมป์ตเลย มันทำตามรูปแบบเปิด [ทักษะของเอเจนต์](https://agentskills.io) รูปแบบ จึงใช้งานได้กับเอเจนต์ใดๆ ที่รับ `SKILL.md` ทักษะ

## ตำแหน่งที่เก็บไฟล์

[`skills/video-navigation/SKILL.md`](https://github.com/getsquish/squish/tree/main/skills/video-navigation/README.md) ใน [github.com/getsquish/squish](https://github.com/getsquish/squish) โดยระบุข้อกำหนดของตัวเองไว้ใน frontmatter: เครื่องมือทำชีตภาพย่อ — ใช้ Squish CLI/MCP บนเครื่อง (Node ≥ 20, `ffmpeg` อยู่ใน PATH) หรือคอนเน็กเตอร์แบบโฮสต์

## ติดตั้งด้วย skills CLI (แนะนำ)

คำสั่งเดียว ใช้ได้กับ Claude Code, Cursor, Codex และเอเจนต์อื่นๆ ทุกตัวที่ [`ชุดทักษะ` CLI](https://github.com/vercel-labs/skills) รองรับ:

```bash
npx skills add getsquish/squish
```

## ติดตั้งด้วยตนเอง (Claude Code)

Claude Code มองเห็น skills เป็น `SKILL.md` ไฟล์ภายในไดเรกทอรี skills ให้นำไฟล์ไปคัดลอกลงในโฟลเดอร์ที่ตั้งชื่อตามทักษะ:

```bash
mkdir -p ~/.claude/skills/video-navigation
curl -o ~/.claude/skills/video-navigation/SKILL.md \
  https://raw.githubusercontent.com/getsquish/squish/main/skills/video-navigation/SKILL.md
```

ใช้ `.claude/skills/` ไดเรกทอรีแทน `~/.claude/skills/` เพื่อจำกัดทักษะให้อยู่ในรีโปเดียว คำอธิบายของทักษะ `คำอธิบาย` ใน frontmatter จะบอกเอเจนต์ว่าเมื่อไรควรเรียกใช้ — ไม่ต้องตั้งค่าเชื่อมต่อเพิ่ม จับคู่กับ [เซิร์ฟเวอร์ MCP](/squish/th/getting-started/quickstart-mcp.md) เพื่อให้ใช้งานได้ลื่นที่สุด: ทักษะนี้จะเลือกใช้ `squish_video` เครื่องมือเมื่อมี และจะถอยไปใช้ CLI ผ่าน `npx`.

## ติดตั้งที่อื่น

ไฟล์นี้เป็นมาร์กดาวน์ธรรมดาที่มี YAML frontmatter เล็กๆ — ไม่มีส่วนไหนผูกกับเฟรมเวิร์กใดโดยเฉพาะ สำหรับเฟรมเวิร์กเอเจนต์อื่นๆ ให้วางไว้ตรงที่เฟรมเวิร์กนั้นโหลดไฟล์ทักษะ/คำสั่ง หรือจะคัดลอกเนื้อหาไปไว้ใน system prompt หรือคำสั่งกำหนดเองของเอเจนต์ก็ได้ ข้อกำหนดจริงๆ มีเพียงที่ทักษะระบุไว้: เอเจนต์ต้องมีความสามารถมองเห็นภาพ และมีเครื่องมือทำชีตภาพย่อ — การเข้าถึงเชลล์ (Node ≥ 20, `ffmpeg`) หรือ `squish_video` เครื่องมือ MCP

## ตัวอย่างการใช้งานจริง: Hermes

มีเวอร์ชันดัดแปลงของทักษะนี้มาพร้อมกับเฟรมเวิร์กเอเจนต์ Hermes (`squish-video`, อยู่ในเอกสารเชื่อมต่อของโปรเจกต์นี้) มีธรรมเนียมอยู่สองข้อที่ควรนำไปใช้กับทุกทักษะที่คุณดัดแปลงจากของเรา:

**รูปแบบคำตอบที่ตายตัว** ทักษะ Hermes ห้ามตอบแค่พาธไฟล์ และกำหนดโครงสร้างคำตอบไว้ดังนี้:

1. **สรุป** — คลิปแสดงอะไร สักหนึ่งหรือสองประโยค
2. **ช่วงสำคัญพร้อมเวลากำกับ** — เหตุการณ์ที่สำคัญ โดยอ้างอิงเวลาในแต่ละช่อง
3. **เฟรมที่น่าสนใจ / ความผิดปกติ** — สิ่งที่ผิดปกติและเวลาของมัน หรือบอกว่าไม่มี

และถ้าคำถามของผู้ใช้เจาะจงมาก ("หาช่วงเวลาที่…") ให้ตอบคำตอบนั้นก่อนพร้อมเวลา การทำแบบนี้จะเปลี่ยนจาก "เอเจนต์ทำชีตขึ้นมา" เป็น "เอเจนต์ตอบคำถามได้"

**ขอบเขตที่ชัดเจน** มันจำกัดตัวเองให้ใช้เฉพาะพาธไฟล์วิดีโอในเครื่อง — ถ้าวิดีโอเป็นไฟล์แนบในแชตหรือเป็น URL มันจะขอพาธในเครื่องก่อน — และจะข้ามวิธีใช้ทั้งหมดไปเลยเมื่อคำถามไม่ได้เกี่ยวกับเนื้อหาภาพของวิดีโอ

## เมื่อไรเอเจนต์ควรหยิบมาใช้ — และเมื่อไรไม่ควร

ให้ใช้ทักษะนี้เมื่อวิดีโอยาวหรือใหญ่เกินกว่าจะนำเข้าโดยตรงได้, เมื่อคำถามครอบคลุมช่วงเวลา (ก่อน/หลัง, การเปลี่ยนฉาก, ความคืบหน้า, "หาช่วงเวลาที่…"), หรือเมื่อคำตอบต้องมีการอ้างอิงที่แม่นยำ ("ที่ 0:07 แท่นกดลงมา").

ข้ามไปเมื่อผู้ใช้ต้องการเฟรมเฉพาะเพียงเฟรมเดียว (ให้แยกเฟรมนั้นออกมาตรงๆ แทน) หรือเมื่อคำถามตอบไม่ได้จากหลักฐานในเฟรมหรือเวลาเหตุการณ์ของกิจกรรม Squish เวอร์ชัน 0.3+ ในเครื่องเพิ่มกิจกรรมเสียงเป็นสัญญาณนำทาง — ไม่ใช่การตีความคำพูดหรือเสียง ดู [คำถามที่พบบ่อย](/squish/th/resources/faq.md) สำหรับขอบเขตแบบปากต่อปาก


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://getsquish.gitbook.io/squish/th/recipes/agent-skill.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.