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
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 DATMarketing

Google 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

Sơ đồ 3D isometric cơ chế nạp ngữ cảnh 2 tầng Progressive Disclosure của Google Antigravity Skill giúp tiết kiệm token.
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 name và description từ 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.md và 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:

  1. 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/.
  2. Cấp độ 2 - Declared Configurations: Các đường dẫn kỹ năng khai báo tường minh trong tệp skills.json hoặc plugins.json cấp dự án.
  3. 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/.
  4. 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.
  5. 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ạpVị trí lưu trữ tiêu biểuMục đích sử dụng chính
1Dự án hiện hành.agents/skills/ tại gốc repoChia sẻ quy trình chuẩn của dự án qua Git
2Khai báo JSON dự án.agents/skills.jsonLiên kết thư mục kỹ năng ngoài đường dẫn mặc định
3Toà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
4Mặc định hệ thốngGắn sẵn trong cấu hình ứng dụngCung cấp năng lực nền tảng như trình duyệt, hướng dẫn
5Khai báo JSON toàn máy~/.gemini/config/skills.jsonKế 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

Đồ họa 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.
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ếnTệp cấu hình chínhCơ chế áp dụngPhù hợp nhất cho tác vụ
RulesGEMINI.md, AGENTS.mdTheo 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
Skillsskills/<name>/SKILL.mdNạp theo yêu cầu (Progressive)Đóng gói quy trình nhiều bước, runbook, kiểm thử
Pluginsplugins/<name>/plugin.jsonGó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
Hookshooks.jsonTheo 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 Serversmcp_config.jsonTích hợp công cụ ngoàiKế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ếuRules (GEMINI.md / AGENTS.md)Google Antigravity Skill (SKILL.md)
Trạng thái nạp mặc địnhNạp luôn nếu đặt always_onChỉ nạp name và description ban đầu
Tính chất nội dungQuy chuẩn tĩnh, rào chắn an toànQuy trình động gồm các bước thực thi tuần tự
Tài nguyên đi kèmChủ yếu là văn bản Markdown thuầnKè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

Mô hình 3D bóc tách cấu trúc thư mục .agents/skills chuẩn hóa gồm tệp SKILL.md chính và 4 thư mục tài nguyên phụ trợ.
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

Sơ đồ lộ trình 4 bước xây dựng và đồng bộ Google Antigravity Skill từ khởi tạo đến kiểm thử và phân phối Git.
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.

  1. 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.
  2. 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ạy git 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.

  1. Bước 3 - Khai báo cấu hình skills.json: Tạo tệp .agents/skills.json với mảng entries trỏ tới thư mục kỹ năng và mảng inherits nế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.
  2. 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.json lê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ường exclude hoặc chỉ định danh sách qua include_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

Bảng đối chiếu giữa 4 sai lầm gây lãng phí token khi viết Google Antigravity Skill và chuẩn thiết kế tinh gọn hiệu quả.
Đố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ếtVí dụ trường description trong YAMLHệ 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ình skills.json và 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ả