#Skills — Kỹ Năng Mở Rộng

#Tổng Quan

Skills là một tiêu chuẩn mở (open standard) được thiết kế để mở rộng khả năng của Agent. Skills là các gói kiến thức có thể tái sử dụng, chứa hướng dẫn, best practices và các script tùy chọn giúp Agent làm việc hiệu quả hơn trên các loại tác vụ cụ thể.

#Cấu Trúc Skill

Mỗi Skill là một thư mục chứa các thành phần sau:

#File Bắt Buộc

File	Mô Tả
`SKILL.md`	File hướng dẫn chính với YAML frontmatter (tên, mô tả) và hướng dẫn chi tiết bằng Markdown

#Thư Mục Tùy Chọn

Thư Mục	Mô Tả
`scripts/`	Các script hỗ trợ và tiện ích mở rộng khả năng
`examples/`	Các ví dụ triển khai tham khảo và pattern sử dụng
`resources/`	Các file bổ sung, templates hoặc tài nguyên mà skill có thể reference

#Cách Skills Hoạt Động

Agent phát hiện skill có liên quan đến tác vụ hiện tại
Agent đọc file SKILL.md để hiểu hướng dẫn đầy đủ
Agent tuân theo các bước hướng dẫn trong skill khi thực thi tác vụ
Agent có thể sử dụng scripts, examples và resources nếu cần

#Ví Dụ Skill

#File `SKILL.md` Mẫu

MARKDOWN

---
name: next-app-router
description: Hướng dẫn phát triển ứng dụng Next.js với App Router
---

# Next.js App Router Development

## Quy Tắc
- Sử dụng App Router thay vì Pages Router
- Luôn dùng Server Components trừ khi cần client-side interactivity
- Sử dụng `loading.tsx` và `error.tsx` cho mỗi route segment

## Cấu Trúc Thư Mục

src/app/ ├── layout.tsx # Root layout ├── page.tsx # Home page ├── globals.css # Global styles ├── (auth)/ # Auth route group │ ├── login/page.tsx │ └── register/page.tsx └── dashboard/ ├── layout.tsx # Dashboard layout └── page.tsx # Dashboard page


## Tạo Skill Mới

1. Tạo thư mục skill trong `.agents/skills/` hoặc vị trí tương đương
2. Tạo file `SKILL.md` với frontmatter và hướng dẫn chi tiết
3. Thêm scripts, examples nếu cần thiết
4. Agent sẽ tự động phát hiện và sử dụng skill khi phù hợp

## Chia Sẻ Skills

Skills có thể được **chia sẻ** giữa các dự án và team bằng cách:
- Đưa vào repository dùng chung
- Publish lên registry (nếu có)
- Copy thư mục skill giữa các workspace

> **Mẹo**: Viết Skills chi tiết và cụ thể. Càng nhiều context và ví dụ bạn cung cấp, Agent sẽ làm việc hiệu quả hơn.