Google Antigravity Skill là gì? Cách xây dựng SKILL.md chuẩn
Google Antigravity Skill giúp chuẩn hóa quy trình cho AI Agent qua tệp SKILL.md, tiết kiệm token ngữ cảnh và đồng bộ năng lực thực thi cho toàn doanh nghiệp.
Điểm nổi bật
7 mục
Điểm nổi bật
7 mục
Chương trình dành cho doanh nghiệpKhông cần biết lập trìnhXây dựng đội ngũ AI Agent cho doanh nghiệpTừ lựa chọn use case đến thiết kế quy trình, quản trị rủi ro và đo hiệu quả vận hành.Khám phá chương trìnhHọc thực chiến cùng DATMarketingGoogle Antigravity Skill là gói tri thức và quy trình thực thi dạng mô-đun giúp mở rộng năng lực chuyên môn cho tác tử trí tuệ nhân tạo (AI Agent) trên nền tảng Google Antigravity. Thay vì nhồi nhét hàng nghìn dòng hướng dẫn vào mọi cuộc hội thoại, cơ chế này đóng gói quy trình lặp lại thành thư mục độc lập xoay quanh tệp SKILL.md.
Khi áp dụng chuẩn Google Antigravity Skill, đội ngũ phát triển chỉ nạp phần siêu dữ liệu mô tả vào ngữ cảnh ban đầu và chỉ đọc tài liệu chi tiết khi tác vụ thực sự cần đến. Cách tổ chức này giúp tiết kiệm đáng kể dung lượng token (đơn vị xử lý ngôn ngữ), giảm tình trạng mô hình quên quy tắc và đảm bảo đồng bộ tiêu chuẩn giữa các thành viên qua hệ thống quản lý mã nguồn.
Nội dung hướng dẫn dưới đây phân tích kiến trúc phân tầng, cấu trúc thư mục chuẩn, quy trình 4 bước khởi tạo kỹ năng và cách chia sẻ bằng tệp cấu hình skills.json cho doanh nghiệp.
Google Antigravity Skill là gì và cơ chế nạp ngữ cảnh

Cơ chế nạp ngữ cảnh 2 tầng Progressive Disclosure của Google Antigravity Skill
Google Antigravity Skill đóng vai trò như một cuốn sổ tay vận hành chuyên biệt (Runbook) được kích hoạt theo ngữ cảnh cho trợ lý AI trong giao diện dòng lệnh agy, trình soạn thảo Antigravity IDE và ứng dụng Antigravity 2.0. Theo tài liệu Google Antigravity Skills, mỗi kỹ năng tập trung giải quyết một quy trình nhiều bước như kiểm thử tích hợp, di trú cơ sở dữ liệu hay chuẩn hóa tài liệu.
Khác với câu lệnh nhắc (Prompt) rời rạc dễ thất lạc sau mỗi phiên làm việc, các tệp kỹ năng được lưu trữ cố định trong kho mã nguồn dự án hoặc cấu hình toàn máy. Nhờ kết hợp cùng chiến lược chọn mô hình Google Antigravity phù hợp, trợ lý AI chuyển đổi mượt mà từ vai trò hỏi đáp thông thường sang chuyên gia am hiểu quy chuẩn nội bộ.
Cơ chế Progressive Disclosure giảm tải cửa sổ Token
Điểm cốt lõi giúp kỹ năng trên Antigravity vận hành mượt mà là nguyên lý tiết lộ lũy tiến (Progressive Disclosure). Khi khởi động phiên trò chuyện mới, hệ thống không nạp toàn văn hướng dẫn của hàng chục kỹ năng vào cửa sổ ngữ cảnh của mô hình.
Thay vào đó, quy trình nạp diễn ra theo 2 tầng rõ ràng nhằm bảo vệ hạn mức xử lý:
- Tầng 1 - Chỉ mục gọn nhẹ: Hệ thống chỉ tiêm trường
namevàdescriptiontừ khối YAML Frontmatter của từng kỹ năng vào ngữ cảnh mặc định để tác tử nhận biết năng lực sẵn có. - Tầng 2 - Kích hoạt theo yêu cầu: Chỉ khi yêu cầu của người dùng khớp với phạm vi mô tả hoặc được gọi đích danh, tác tử mới đọc toàn bộ nội dung tệp
SKILL.mdvà các tài liệu phụ trợ liên quan.
Cách phân tầng này ngăn chặn hiện tượng quá tải ngữ cảnh, giúp mô hình tập trung tối đa độ chính xác vào mã nguồn đang xử lý và cộng hưởng trực tiếp với cơ chế Orchestrator tiết kiệm quota trên toàn hệ thống.
5 cấp độ ưu tiên nạp kỹ năng trong hệ thống
Khi triển khai trên nhiều dự án song song, Google Antigravity tự động quét từ thư mục làm việc hiện tại ngược lên thư mục gốc chứa .git và đối chiếu với cấu hình máy cá nhân. Nếu phát hiện hai kỹ năng trùng tên name, hệ thống áp dụng thứ tự ưu tiên 5 cấp độ từ cao xuống thấp để ghi đè an toàn:
- Cấp độ 1 - Workspace Project: Thư mục dự án quét phân cấp từ thư mục hiện hành (CWD) lên tới gốc kho lưu trữ như
.agents/skills/. - Cấp độ 2 - Declared Configurations: Các đường dẫn kỹ năng khai báo tường minh trong tệp
skills.jsonhoặcplugins.jsoncấp dự án. - Cấp độ 3 - Global Discovery: Kho kỹ năng dùng chung cho mọi dự án trên máy cá nhân đặt tại đường dẫn
~/.gemini/config/. - Cấp độ 4 - Built-in Customizations: Bộ kỹ năng mặc định đóng gói sẵn cùng ứng dụng, được gắn trực tiếp theo tên cấu hình hệ thống.
- Cấp độ 5 - Global Declared Configurations: Danh sách kỹ năng khai báo bổ sung trong các tệp cấu hình JSON ở phạm vi toàn máy.
| Thứ tự | Phạm vi nguồn nạp | Vị trí lưu trữ tiêu biểu | Mục đích sử dụng chính |
|---|---|---|---|
| 1 | Dự án hiện hành | .agents/skills/ tại gốc repo | Chia sẻ quy trình chuẩn của dự án qua Git |
| 2 | Khai báo JSON dự án | .agents/skills.json | Liên kết thư mục kỹ năng ngoài đường dẫn mặc định |
| 3 | Toàn máy cá nhân | ~/.gemini/config/skills/ | Lưu thói quen và công cụ riêng của lập trình viên |
| 4 | Mặc định hệ thống | Gắn sẵn trong cấu hình ứng dụng | Cung cấp năng lực nền tảng như trình duyệt, hướng dẫn |
| 5 | Khai báo JSON toàn máy | ~/.gemini/config/skills.json | Kế thừa bộ kỹ năng chung từ thư mục nhóm bên ngoài |
So sánh Skill với Rule, Plugin và MCP trên Antigravity

Phân biệt 5 công cụ tùy biến trên Google Antigravity gồm Rules, Skills, Plugins, Hooks và MCP Servers
Hệ thống tùy biến Antigravity (Antigravity Customization System) cung cấp 5 công cụ mở rộng gồm Rules, Skills, Plugins, Hooks và MCP Servers để giải quyết từng lớp bài toán khác nhau. Theo tài liệu Rules và Workflows trên Antigravity, việc chọn đúng loại tùy biến giúp hệ thống gọn nhẹ và tránh chồng chéo chỉ dẫn.
| Loại tùy biến | Tệp cấu hình chính | Cơ chế áp dụng | Phù hợp nhất cho tác vụ |
|---|---|---|---|
| Rules | GEMINI.md, AGENTS.md | Theo ngữ cảnh phân cấp thư mục | Ép buộc chuẩn code, hạn chế API, quy tắc dự án |
| Skills | skills/<name>/SKILL.md | Nạp theo yêu cầu (Progressive) | Đóng gói quy trình nhiều bước, runbook, kiểm thử |
| Plugins | plugins/<name>/plugin.json | Gói phân phối tổng hợp | Đóng gói đồng thời nhiều Skill, Rule và cấu hình MCP |
| Hooks | hooks.json | Theo sự kiện vòng đời tác tử | Tự chạy script kiểm tra trước hoặc sau khi gọi công cụ |
| MCP Servers | mcp_config.json | Tích hợp công cụ ngoài | Kết nối cơ sở dữ liệu, CMS, API nội bộ qua giao thức chuẩn |
Phân biệt quy tắc nền GEMINI.md và mô-đun SKILL.md
Phân định rõ ranh giới giữa tệp quy tắc và tệp kỹ năng là bước quan trọng để không làm phình bộ nhớ đệm của trợ lý. Tệp GEMINI.md hoặc AGENTS.md với chế độ always_on được nạp tự động mỗi khi mở hoặc sửa tệp trong thư mục tương ứng, nên chỉ nên chứa các ràng buộc áp dụng thường xuyên như lệnh chạy kiểm thử hoặc phong cách đặt tên.
| Tiêu chí đối chiếu | Rules (GEMINI.md / AGENTS.md) | Google Antigravity Skill (SKILL.md) |
|---|---|---|
| Trạng thái nạp mặc định | Nạp luôn nếu đặt always_on | Chỉ nạp name và description ban đầu |
| Tính chất nội dung | Quy chuẩn tĩnh, rào chắn an toàn | Quy trình động gồm các bước thực thi tuần tự |
| Tài nguyên đi kèm | Chủ yếu là văn bản Markdown thuần | Kèm mã nguồn scripts/, mẫu và tài liệu tham chiếu |
Một nguyên tắc phân loại hiệu quả là áp dụng tỷ lệ 80/20: những quy chuẩn xuất hiện trong hơn 80% tác vụ lập trình hằng ngày giữ tại GEMINI.md, còn quy trình chuyên biệt chỉ dùng theo đợt như phát hành ứng dụng hay kiểm toán SEO cần tách sang thư mục kỹ năng, tương đồng với tư duy trong hướng dẫn viết AGENTS.md và SKILL.md.
Khi nào nên đóng gói Skill cùng Plugin và Hooks
Một thư mục kỹ năng đơn lẻ đã đủ mạnh cho nhóm quy trình thao tác trên tệp tin và dòng lệnh cục bộ. Tuy nhiên, khi doanh nghiệp cần kết nối tác tử AI với dữ liệu thời gian thực như hệ thống quản trị nội dung (CMS), kho vé hỗ trợ khách hàng hoặc cơ sở dữ liệu sản xuất, kỹ năng cần phối hợp cùng đặc tả Model Context Protocol (MCP).
Trong mô hình phối hợp này, cấu hình mcp_config.json đóng vai trò cấp quyền và công cụ giao tiếp cho tác tử, còn tệp SKILL.md dạy tác tử trình tự gọi đúng công cụ MCP kèm bộ kiểm tra điều kiện an toàn. Khi bộ quy chuẩn gồm nhiều kỹ năng, quy tắc đi kèm và máy chủ MCP liên quan mật thiết với nhau, đội ngũ kỹ thuật nên đóng gói thành một đơn vị plugin.json thống nhất và gắn thêm sự kiện hooks.json để tự động kiểm tra định dạng trước lúc kết thúc phiên.
Cấu trúc chuẩn của thư mục .agents/skills và SKILL.md

Cấu trúc thư mục .agents/skills chuẩn hóa gồm tệp SKILL.md và 4 thư mục phụ trợ
Để nền tảng tự động nhận diện mà không cần cấu hình phức tạp, mỗi Google Antigravity Skill phải được đặt trong một thư mục riêng mang tên kỹ năng bên trong thư mục gốc tùy biến như .agents/skills/ (hệ thống cũng hỗ trợ các biến thể .agent/, _agents/ hoặc _agent/). Việc đồng nhất cấu trúc giúp lập trình viên dễ bảo trì và tránh phát sinh lỗi đường dẫn khi chuyển đổi giữa các máy trạm.
Tổ chức 5 thành phần cốt lõi trong thư mục kỹ năng
Theo chuẩn kiến trúc của Antigravity, một thư mục kỹ năng hoàn chỉnh hỗ trợ tối đa 5 thành phần sau, trong đó duy nhất tệp SKILL.md là bắt buộc phải có:
skills/<skill_name>/
├── SKILL.md # Bắt buộc: Tệp hướng dẫn chính có YAML frontmatter
├── scripts/ # Tùy chọn: Tập lệnh tiện ích (Bash, Python, TypeScript)
├── examples/ # Tùy chọn: Mã mẫu hoặc cấu hình tham chiếu chuẩn
├── resources/ # Tùy chọn: Tệp tài sản, biểu mẫu hoặc dữ liệu mẫu
└── references/ # Tùy chọn: Tài liệu tra cứu chuyên sâu chỉ đọc khi cần
Việc tách các tài liệu dài hàng trăm trang vào thư mục references/ và đóng gói các chuỗi lệnh phức tạp vào scripts/ giúp giữ cho tệp SKILL.md tinh gọn. Trợ lý AI chỉ mở tệp tham chiếu hoặc chạy trực tiếp tập lệnh qua liên kết tương đối khi bước thực thi thực sự yêu cầu.
Quy tắc khai báo YAML Frontmatter để tự kích hoạt
Phần đầu của tệp SKILL.md bắt buộc phải mở bằng khối YAML Frontmatter chứa hai trường siêu dữ liệu quan trọng là name và description. Trường name dùng chữ thường nối bằng dấu gạch ngang làm mã định danh duy nhất, còn trường description viết ở ngôi thứ ba để mô tả rõ kỹ năng làm gì và khi nào nên kích hoạt.
---
name: api-contract-verifier
description: >-
Kiểm tra tính đồng bộ giữa OpenAPI schema, route backend và client SDK trước khi tạo Pull Request.
Kích hoạt kỹ năng này khi người dùng yêu cầu rà soát API contract, sửa route hoặc kiểm tra breaking change.
---
# API Contract Verifier
Thực hiện kiểm tra contract theo 3 bước sau:
1. Chạy script kiểm tra sơ bộ: [check-schema.sh](./scripts/check-schema.sh)
2. Thực thi typecheck: `bun run typecheck`
3. Đối chiếu danh sách lỗi schema tại [errors-guide.md](./references/errors-guide.md).
Ngoài ra, các quy tắc xác minh đầu ra (Validation Steps) như chạy thử lệnh --dry-run hoặc đọc log kiểm tra nên được đặt rõ ràng ngay cuối quy trình trong SKILL.md để trợ lý AI tự kiểm chứng kết quả thay vì suy đoán.
Quy trình 4 bước xây dựng Google Antigravity Skill

Quy trình 4 bước xây dựng và đồng bộ Google Antigravity Skill qua Git
Thiết kế một Google Antigravity Skill đạt chuẩn vận hành doanh nghiệp đòi hỏi quy trình chuẩn hóa từ khâu đóng gói hướng dẫn đến cơ chế kiểm chứng và phân phối cho cả nhóm. Áp dụng tuần tự quy trình 4 bước dưới đây giúp loại bỏ thao tác sao chép thủ công và giữ kỷ luật chất lượng đồng đều trên mọi nhánh mã nguồn.
Bước 1 và 2: Khởi tạo SKILL.md kèm script kiểm tra
Ở hai bước đầu tiên, kỹ sư phụ trách cần xác định rõ một quy trình thực sự lặp lại trong dự án, tránh viết lại những kiến thức lập trình phổ thông mà mô hình đã nắm vững.
- Bước 1 - Tạo cấu trúc và viết
SKILL.md: Khởi tạo thư mục dưới.agents/skills/<ten-ky-nang>/, khai báo YAML Frontmatter chính xác và viết các bước thực thi ngắn gọn theo dạng mệnh lệnh hành động. - Bước 2 - Đóng gói lệnh vào
scripts/và bổ sung kiểm chứng: Chuyển các chuỗi lệnh phức tạp dễ gõ nhầm thành script trong./scripts/, đồng thời thêm bước xác minh bắt buộc (như chạygit diff --check, lệnh dry-run hoặc đọc log đầu ra) để đảm bảo kết quả đúng trước khi báo cáo.
Bố cục tách bạch giữa hướng dẫn ngắn gọn trong SKILL.md và tài liệu chi tiết trong references/ giúp trợ lý AI hoàn thành tác vụ nhanh hơn với chi phí token tối thiểu.
Bước 3 và 4: Cấu hình skills.json đồng bộ toàn nhóm
Với những dự án lưu kỹ năng ở thư mục dùng chung ngoài vị trí mặc định hoặc cần kế thừa chọn lọc từ kho quy chuẩn công ty, tệp .agents/skills.json cho phép đăng ký đường dẫn tường minh và kiểm soát phạm vi kích hoạt.
- Bước 3 - Khai báo cấu hình
skills.json: Tạo tệp.agents/skills.jsonvới mảngentriestrỏ tới thư mục kỹ năng và mảnginheritsnếu kế thừa từ tệp cấu hình chung khác. Hệ thống hỗ trợ đường dẫn tuyệt đối (/), đường dẫn từ thư mục cá nhân (~/) hoặc đường dẫn tương đối theo gốc kho mã nguồn. - Bước 4 - Đưa lên Git và thử nghiệm thực tế: Commit toàn bộ thư mục kỹ năng cùng
skills.jsonlên kho Git; các thành viên khác khi mở dự án sẽ được hệ thống tự động nạp kỹ năng và có thể lọc bỏ kỹ năng thử nghiệm qua trườngexcludehoặc chỉ định danh sách quainclude_only.
{
"inherits": [
{
"path": "/opt/company-standards/skills.json",
"include_only": ["security-audit"],
"exclude": ["legacy-deploy"]
}
],
"entries": [
{
"path": "tools/agents/skills",
"exclude": ["experimental-.*"]
}
]
}
4 sai lầm thường gặp làm giảm hiệu quả của Skill

Đối chiếu 4 sai lầm thường gặp và chuẩn thiết kế Google Antigravity Skill tinh gọn
Nhiều đội ngũ dù đã tạo hàng loạt thư mục kỹ năng nhưng vẫn gặp tình trạng tác tử AI gọi sai quy trình, phản hồi chậm hoặc tiêu hao hạn mức nhanh chóng. Nguyên nhân thường bắt nguồn từ 4 sai lầm phổ biến: viết tệp hướng dẫn quá dài dòng, đặt trường mô tả kích hoạt mơ hồ, lặp lại kiến thức cơ bản và thiếu bước xác minh kết quả.
Nhồi nhét toàn bộ tài liệu dài vào tệp SKILL.md chính
Sai lầm hay gặp nhất là dán toàn bộ đặc tả API hàng nghìn dòng, bảng mã lỗi chi tiết hoặc hướng dẫn sử dụng thư viện phổ biến thẳng vào tệp SKILL.md. Khi kỹ năng được kích hoạt, toàn bộ văn bản dư thừa này lập tức chiếm dụng cửa sổ ngữ cảnh, làm giảm khả năng tập trung của mô hình vào đoạn mã đang sửa.
Giải pháp triệt để là giữ SKILL.md dưới 150 dòng chỉ chứa luồng quyết định cốt lõi, đẩy toàn bộ bảng tra cứu chi tiết sang references/ và loại bỏ hoàn toàn các chỉ dẫn chung chung mà mô hình ngôn ngữ đã biết sẵn.
Viết trường description mơ hồ gây kích hoạt sai lúc
Vì hệ thống dựa hoàn toàn vào trường name và description để quyết định có mở kỹ năng hay không, một câu mô tả quá chung chung sẽ dẫn đến hai hệ quả: kích hoạt nhầm vào tác vụ không liên quan hoặc bị bỏ qua đúng lúc cần thiết. Bảng đối chiếu dưới đây minh họa sự khác biệt giữa cách khai báo mờ nhạt và cách viết sắc bén chuẩn xác:
| Kiểu viết | Ví dụ trường description trong YAML | Hệ quả thực tế |
|---|---|---|
| Mơ hồ (Cần tránh) | Hỗ trợ làm việc với cơ sở dữ liệu và tối ưu code. | Dễ kích hoạt sai khi lập trình viên chỉ hỏi khái niệm SQL cơ bản |
| Chuẩn xác (Khuyên dùng) | Thiết kế schema Drizzle PostgreSQL và chạy dry-run kiểm tra migration. Dùng khi sửa bảng trong modules/*/db/ hoặc chạy db:push. | Tác tử nhận diện chính xác ngữ cảnh tệp và lệnh để gọi đúng lúc |
Câu hỏi thường gặp (FAQ)
1. Google Antigravity Skill khác gì so với tệp quy tắc GEMINI.md và AGENTS.md?
Tệp quy tắc như GEMINI.md hoặc AGENTS.md áp dụng theo phân cấp thư mục và thường nạp sẵn để kiểm soát quy chuẩn viết mã chung. Trong khi đó, Google Antigravity Skill đóng gói quy trình thực thi nhiều bước kèm script phụ trợ và chỉ nạp toàn văn khi được kích hoạt theo cơ chế tiết lộ lũy tiến.
2. Làm thế nào để chia sẻ thư mục Google Antigravity Skill nằm ngoài .agents/ cho cả nhóm?
Bạn tạo tệp cấu hình skills.json ngay trong thư mục .agents/ tại gốc kho Git, sau đó khai báo đường dẫn tương đối tới thư mục chứa kỹ năng trong mảng entries. Khi các thành viên khác đồng bộ mã nguồn về máy, hệ thống sẽ tự động quét một cấp sâu và nạp danh sách kỹ năng dùng chung.
3. Có nên đặt toàn bộ tài liệu API dài hàng nghìn dòng vào thẳng tệp SKILL.md không?
Không nên đặt toàn bộ tài liệu dài vào SKILL.md vì thao tác này làm phình dung lượng ngữ cảnh và lãng phí token mỗi lần kỹ năng chạy. Hãy giữ tệp chính thật ngắn gọn, sau đó lưu các bảng đặc tả chi tiết vào thư mục con references/ và dẫn liên kết tương đối để tác tử chỉ đọc đúng phần cần thiết.
Tổng kết & Lời khuyên hành động
Chuẩn hóa quy trình nội bộ thông qua Google Antigravity Skill mang lại 3 lợi ích trực tiếp cho mọi đội ngũ kỹ thuật và vận hành công nghệ:
- Giảm thiểu lãng phí token nhờ cơ chế tiết lộ lũy tiến chỉ nạp siêu dữ liệu ban đầu và mở nội dung chi tiết đúng thời điểm.
- Biến kinh nghiệm vận hành rải rác thành tài sản tập thể có thể kiểm soát phiên bản qua Git và phân cấp ưu tiên rõ ràng.
- Kết hợp linh hoạt cùng quy tắc
GEMINI.md, cấu hìnhskills.jsonvà máy chủ MCP để tự động hóa quy trình có kiểm chứng an toàn.
Hãy bắt đầu bằng việc chọn một tác vụ lặp lại nhiều nhất trong tuần như kiểm tra Pull Request hoặc chạy quy trình kiểm thử, đóng gói thành thư mục kỹ năng đầu tiên dưới .agents/skills/ kèm bước xác minh cụ thể để đo lường ngay hiệu quả thực tế.
Bài viết liên quan
Xem tất cảCodex Skill là gì? Cách đóng gói kỹ năng chuẩn cho Codex CLI
Codex Skill là giải pháp đóng gói tài nguyên theo mô-đun cho Codex CLI, giúp nạp ngữ cảnh 3 tầng tinh gọn, tiết kiệm chi phí token và chuẩn hóa quy trình AI.
Xử lý khiếu nại khách hàng cho doanh nghiệp nhỏ
Khám phá khung hành động 5 bước xử lý khiếu nại khách hàng cho SME, kết hợp kỹ năng giao tiếp thấu cảm để dập tắt sự cố và gia tăng lòng trung thành.
Hệ thống phản hồi khách hàng cho doanh nghiệp nhỏ
Xây dựng hệ thống phản hồi khách hàng giúp doanh nghiệp nhỏ chuẩn hóa kênh thu thập ý kiến, xử lý điểm nghẽn dịch vụ và tối ưu chi phí giữ chân khách cũ.
