Bỏ qua tới nội dung
Ông T.vn

gemini-skills: dạy trợ lý AI viết code Gemini API đúng chuẩn — hướng dẫn cài đặt và dùng

10 phút đọcCập nhật

Bài này là một góc nhìn khác về google-gemini/gemini-skills — repo từng đổi tên nên mình viết lại với cách tiếp cận khác. Bài hướng dẫn chính: gemini-skills: dạy trợ lý AI viết đúng code Gemini API — hướng dẫn cài đặt và dùng →

gemini-skills: dạy trợ lý AI viết code Gemini API đúng chuẩn — hướng dẫn cài đặt và dùng

Tóm tắt nhanh

gemini-skills là thư viện skill của Google dành cho Gemini API, gồm 4 skill: viết app với API, gọi API từ dòng lệnh, streaming thời gian thực (Live API) và tạo/sửa video. Skill được cài vào trợ lý code AI để nó bớt viết sai code cũ. Cài chỉ cần một hai dòng lệnh, không khó.

gemini-skills là bộ "skill" (gói kiến thức cho trợ lý code AI) do chính nhóm Google Gemini làm, nói cho trợ lý của bạn biết cách viết code gọi Gemini API đúng chuẩn mới nhất. Bạn cài một lần vào Claude Code, Cursor, Codex hay Antigravity, rồi trợ lý sẽ tự tra skill khi bạn nhờ làm app dùng Gemini.

Vấn đề repo giải quyết khá thực tế. Model AI được huấn luyện tại một thời điểm cố định, nên không biết SDK vừa đổi gì, cách làm tốt nhất vừa thay đổi ra sao, thậm chí không biết cả model Gemini mới ra. Hậu quả là trợ lý hay viết code dùng tên model cũ, hàm cũ, cách gọi cũ. Skill vá đúng khoảng trống đó bằng cách đưa sẵn tài liệu đúng vào ngữ cảnh của trợ lý.

Điểm đáng giá nhất là số liệu đánh giá do chính tác giả nêu trong README: khi có skill, khả năng trợ lý viết code API đúng và theo thực hành tốt đạt 87% với Gemini 3 Flash và 96% với Gemini 3.1 Pro. Repo hiện có khoảng 4.469 sao và 497 fork, giấy phép Apache-2.0, và vẫn được cập nhật trong 3 tháng gần đây. Bạn có thể xem video ngắn bên dưới để thấy nhanh cách dùng.

Skill

google-gemini/gemini-skills

Bộ skill chính chủ từ Google giúp trợ lý code AI (Claude Code, Cursor, Codex, Antigravity) viết đúng code Gemini API, SDK và các model mới.

★ 4.5kPythonApache-2.0
Xem repo trên GitHub
Video giới thiệu gemini-skillsXem trên YouTubeXem trên Facebook

I.gemini-skills làm được gì

Repo chứa 4 skill. Mỗi skill là một "gói kiến thức" riêng, bạn cài cái nào cần dùng.

A.gemini-api-dev: viết app với Gemini API

Đây là skill chính. Nó dạy trợ lý dùng Gemini API qua Interactions API và Decisions API. Phạm vi khá rộng: sinh văn bản, chat nhiều lượt, streaming, gọi hàm (function calling), đầu ra có cấu trúc, quyết định có hiệu chuẩn (gemini-decision-1), tạo ảnh, tạo giọng nói (TTS), Voice Design, Voice Replication, agent được quản lý, Deep Research. Skill cũng có phần cảnh báo về các model đã bị ngừng dùng, và hỗ trợ cả SDK Python lẫn TypeScript.

Lợi ích thực tế: bạn nhờ "làm cho mình chatbot trả lời theo mẫu JSON" thì trợ lý dùng đúng cách gọi hiện hành, ít phải sửa lại.

B.gemini-api-cli: gọi Gemini từ dòng lệnh

Skill này đi kèm một công cụ dòng lệnh tên gemini-api (có repo riêng của Google). Nó dạy trợ lý gọi Gemini ngay trong terminal: tạo văn bản và media (image, tts, music, video), phân tích tệp và video YouTube, phiên âm, Deep Research, sandbox Antigravity, và viết script với --jq / --body. Hợp với người thích làm việc bằng lệnh hoặc muốn gắn Gemini vào script tự động.

C.gemini-live-api-dev: ứng dụng thời gian thực

Dành cho app cần nói chuyện hai chiều liên tục với Gemini bằng Live API. Skill bao gồm streaming âm thanh, video, văn bản qua WebSocket, phát hiện giọng nói (voice activity detection), tính năng native audio, gọi hàm và quản lý phiên. Nếu bạn muốn làm trợ lý giọng nói hoặc tổng đài ảo, đây là skill cần có.

D.gemini-omni-flash-api: tạo và chỉnh sửa video

Skill chuyên về model video Gemini Omni 1.2 Flash (gemini-omni-1.2-flash) qua Interactions API. Nó hỗ trợ sửa video, tạo video từ ảnh hoặc video tham chiếu, chuyển cảnh giữa khung đầu và khung cuối, và kéo dài video (3 đến 15 giây mỗi lượt, tối đa 40 giây tổng).

Skill vertex-ai-api-dev trước đây nằm trong repo này đã chuyển sang repo khác của Google (đường dẫn skills/cloud/gemini-api trong repo google/skills). Nếu bạn dùng Vertex AI, hãy tìm ở đó.

II.Cần chuẩn bị gì

README của repo rất gọn và không liệt kê yêu cầu hệ thống chi tiết. Những gì có thể nói chắc chắn từ tư liệu:

  • Một trợ lý code AI được hỗ trợ: Claude Code, Cursor, OpenAI Codex hoặc Antigravity. Cách cài khác nhau theo từng công cụ.
  • Nếu cài bằng skills CLI của Vercel hoặc Context7, các lệnh bắt đầu bằng npx, nghĩa là máy bạn cần có Node.js (npx đi kèm Node.js).
  • Ngôn ngữ chính của repo là Python, còn skill hướng dẫn cả SDK Python và TypeScript, nên app bạn làm ra có thể dùng một trong hai.

Những thứ README chưa nói: phiên bản Node cụ thể, hệ điều hành bắt buộc, yêu cầu phần cứng, và việc có cần API key hay không. Bản thân skill chỉ là tài liệu cho trợ lý, nhưng khi chạy app gọi Gemini API thật, bạn sẽ cần cách xác thực theo tài liệu của Google. Phần này bạn xem ở trang tài liệu Gemini API (ai.google.dev/gemini-api/docs) hoặc trang hướng dẫn thiết lập trợ lý code mà README dẫn tới.

III.Cài đặt từng bước

README cho nhiều đường cài. Bạn chỉ cần chọn đúng một đường, tùy công cụ bạn đang dùng.

  1. Chọn công cụXác định bạn đang dùng Claude Code, Cursor, Codex, Antigravity hay muốn cài bằng npx
  2. Mở đúng nơi gõ lệnhTerminal cho lệnh npx, agy, codex; khung chat của Claude Code cho lệnh /plugin
  3. Chạy lệnh càiChép lệnh của công cụ bạn chọn ở các bước bên dưới
  4. Chọn skill cần dùngCài cả bộ hoặc chỉ một skill như gemini-api-dev
  5. Mở lại phiên làm việcKhởi động lại trợ lý để nó nhận skill mới

A.Cài bằng Vercel skills CLI (chạy được với nhiều trợ lý)

Mở terminal (Windows: PowerShell hoặc Windows Terminal; Mac: Terminal) rồi chạy. Dòng đầu cho bạn duyệt danh sách skill và chọn bằng bàn phím. Dòng sau cài thẳng một skill.

Terminal
# Interactively browse and install skills.
npx skills add google-gemini/gemini-skills --list

# Install a specific skill (e.g., gemini-api-dev).
npx skills add google-gemini/gemini-skills --skill gemini-api-dev

Người mới hay vấp ở đây: dòng bắt đầu bằng # chỉ là chú thích, bạn không cần chép. Nếu máy báo không có npx, nghĩa là chưa cài Node.js.

B.Cài bằng Context7 skills CLI

Cũng là lệnh npx, nhưng đi qua Context7:

Terminal
# Interactively browse and install skills.
npx ctx7 skills install /google-gemini/gemini-skills

# Install a specific skill (e.g., gemini-api-dev).
npx ctx7 skills install /google-gemini/gemini-skills gemini-api-dev

C.Cài trong Antigravity

Skill đã đi kèm sẵn trong Antigravity. Bạn vào ⚙️ → Customizations → Build with Google Plugins để tìm. Hoặc cài bằng AGY CLI:

Terminal
# Install it directly
agy plugin install https://github.com/google-gemini/gemini-skills

D.Cài trong Claude Code

Hai lệnh dưới đây gõ bên trong khung chat của Claude Code, không gõ vào PowerShell hay Terminal thường. Lệnh đầu đăng ký "chợ" plugin của repo, lệnh sau cài plugin.

Terminal
# Register the marketplace
/plugin marketplace add google-gemini/gemini-skills

# Install the plugin
/plugin install gemini-skills@gemini-skills

Đây cũng là lý do repo có thư mục .claude-plugin và tệp plugin.json: chúng khai báo plugin cho Claude Code.

E.Cài trong Cursor

Bạn cài trực tiếp từ thư mục plugin của Cursor, hoặc gõ lệnh sau trong editor:

text
/add-plugin google-gemini/gemini-skills

F.Cài trong OpenAI Codex

Chạy ở terminal:

Terminal
# Add the marketplace source
codex plugin marketplace add https://github.com/google-gemini/gemini-skills

# Install the plugin
codex plugin add gemini-skills@gemini-skills

Skill chỉ là tài liệu hướng dẫn cho trợ lý, nhưng code mà trợ lý viết ra sẽ gọi Gemini API thật. Khi làm vậy, hãy giữ khóa API trong biến môi trường hoặc tệp cấu hình không đưa lên Git, và để ý chi phí nếu bạn tạo video, ảnh, giọng nói nhiều.

IV.Kiểm tra đã chạy được chưa

README chưa ghi cách kiểm tra sau khi cài. Bạn có thể tự kiểm tra bằng vài cách đơn giản:

  • Nếu dùng npx, chạy lại lệnh npx skills add google-gemini/gemini-skills --list để xem danh sách skill và đảm bảo lệnh chạy không báo lỗi.
  • Với Claude Code, Cursor, Codex, sau khi cài, hãy mở lại phiên làm việc rồi hỏi trợ lý một câu về Gemini API, ví dụ "Bạn đang có skill nào liên quan Gemini API?". Nếu cài đúng, trợ lý sẽ nhắc tới các skill như gemini-api-dev.
  • Thử nhờ trợ lý viết một đoạn gọi Gemini API đơn giản. Code đúng skill thường dùng tên model và cách gọi hiện hành, thay vì thư viện hay tên model cũ.

Muốn biết chính xác, bạn mở thư mục skills/ trong repo để xem nội dung từng skill, và đọc trang "coding agents" trong tài liệu Gemini mà README dẫn tới.

V.Dùng vào việc thật

A.Dev mới làm chatbot hỏi đáp bằng Python

Bạn là lập trình viên mới, cần một chatbot nhỏ cho website cửa hàng. Sau khi cài gemini-api-dev, bạn mở dự án và nhờ trợ lý:

text
Dùng skill gemini-api-dev, viết cho mình chatbot Python chat nhiều lượt, trả lời streaming, và trả về kết quả dạng JSON gồm trường answer và trường confidence.

Kết quả: trợ lý viết code theo SDK và cách gọi hiện hành, có chat nhiều lượt và đầu ra có cấu trúc. Bạn chỉ cần điền khóa API đúng chỗ rồi chạy thử.

Trợ lý AI giỏi đến đâu cũng chỉ biết những gì nó được học. Skill là cách đưa kiến thức mới nhất vào tay nó.

Ông T

B.Chủ shop cần giọng đọc và nội dung media từ dòng lệnh

Bạn bán hàng online, muốn tạo nhanh giọng đọc quảng cáo hoặc ảnh sản phẩm mà không viết cả ứng dụng. Cài gemini-api-cli, rồi nhờ trợ lý:

text
Dùng skill gemini-api-cli, tạo cho mình file giọng đọc (tts) cho đoạn giới thiệu sản phẩm này, rồi tạo thêm một ảnh minh họa.

Skill này nhắc tới các lệnh con image, tts, music, video, nên trợ lý biết gọi đúng công cụ gemini-api thay vì tự nghĩ ra cú pháp. Bạn cần cài công cụ gemini-api theo hướng dẫn trong repo riêng của nó.

C.Nhân viên văn phòng phân tích video và phiên âm họp

Bạn có một đoạn ghi âm cuộc họp hoặc một video YouTube cần tóm tắt. Skill gemini-api-cli có phần phân tích tệp, phân tích YouTube và phiên âm. Bạn nhờ:

text
Dùng skill gemini-api-cli, phiên âm file họp này và tóm tắt thành 5 ý chính kèm việc cần làm.

Kết quả là một bản phiên âm và một bản tóm tắt bạn có thể dán vào email hoặc biên bản. Hãy đọc lại trước khi gửi, vì kết quả AI vẫn có thể sai ở tên riêng và số liệu.

D.Dev làm ứng dụng giọng nói hoặc video

Nếu bạn muốn làm trợ lý nói chuyện trực tiếp với khách, hãy cài gemini-live-api-dev và nhờ trợ lý dựng khung ứng dụng streaming âm thanh qua WebSocket, có phát hiện giọng nói và quản lý phiên. Nếu làm nội dung video ngắn, gemini-omni-flash-api giúp trợ lý biết cách tạo video từ ảnh tham chiếu, nối khung đầu và khung cuối, hay kéo dài video theo từng lượt 3 đến 15 giây. Với video, nên thử bản ngắn trước vì chi phí có thể tăng nhanh.

VI.Lỗi hay gặp và cách xử lý

A.Báo không tìm thấy lệnh npx

Đây là lỗi quen với người mới: máy chưa cài Node.js. Cài Node.js từ trang chính thức, mở lại terminal rồi chạy lại lệnh. Nếu bạn dùng Claude Code hay Cursor, có thể chọn đường cài bằng /plugin hoặc /add-plugin để khỏi cần npx.

B.Gõ lệnh /plugin vào PowerShell nhưng không chạy

Lệnh /plugin ... chỉ chạy bên trong khung chat của Claude Code. Hãy mở Claude Code trước, rồi gõ lệnh ở đó. Ngược lại, các lệnh npx, agy, codex phải gõ ở terminal.

C.Cài xong nhưng trợ lý vẫn viết code cũ

Hãy mở lại phiên làm việc để trợ lý nạp skill, rồi nhắc rõ trong yêu cầu, ví dụ "dùng skill gemini-api-dev". Nếu vẫn sai, bạn kiểm tra lại danh sách skill đã cài, và đối chiếu code với tài liệu Gemini chính thức.

D.Không tìm thấy skill Vertex AI

Skill vertex-ai-api-dev đã chuyển sang repo google/skills (thư mục skills/cloud/gemini-api). Bạn cài từ repo đó thay vì repo này.

E.Lộ khóa API hoặc phát sinh chi phí ngoài ý muốn

Trợ lý đôi khi dán thẳng khóa API vào code. Hãy yêu cầu nó đọc khóa từ biến môi trường, thêm tệp chứa khóa vào .gitignore, và đừng đẩy khóa lên GitHub. Khi thử tạo ảnh, giọng nói, video, hãy bắt đầu với ví dụ nhỏ.

VII.Có nên dùng không

Điểm mạnh. Đây là repo chính chủ từ Google, bám sát API và model mới. Skill cài được trên nhiều công cụ (Claude Code, Cursor, Codex, Antigravity) và có số liệu đánh giá do tác giả nêu: 87% với Gemini 3 Flash và 96% với Gemini 3.1 Pro. Cài nhanh, giấy phép Apache-2.0, repo còn được cập nhật.

Giới hạn. Skill chỉ giúp trợ lý viết code tốt hơn, nó không phải ứng dụng chạy sẵn. Bạn vẫn cần hiểu cơ bản về cách chạy code và giữ khóa API an toàn. README cũng ghi rõ đây không phải sản phẩm được Google hỗ trợ chính thức và không thuộc chương trình thưởng lỗ hổng bảo mật mã nguồn mở của Google, nên đừng kỳ vọng hỗ trợ kỹ thuật chính thức. Các con số 87% và 96% là kết quả đánh giá của chính tác giả.

Khi nào chọn cách khác. Nếu bạn không dùng Gemini, skill này không có ích. Nếu bạn dùng Vertex AI, hãy xem repo skill riêng của nó. Nếu chỉ cần hỏi đáp thông thường mà không lập trình, bạn chưa cần cài gì cả.

Tóm lại, nếu bạn đang nhờ trợ lý code AI làm app với Gemini, cài gemini-skills là việc đáng làm: mất vài phút, và giảm hẳn tình trạng code dùng API đã cũ.

4.8/5 · Ông T chấm

Chưa có độc giả chấm

Bài này có ích với bạn không?

Câu hỏi thường gặp

gemini-skills có miễn phí không?

Bản thân repo dùng giấy phép Apache-2.0 nên bạn tải và cài được tự do. Còn việc gọi Gemini API thật có tính phí hay hạn mức miễn phí thế nào thì README không nói, bạn xem ở trang tài liệu Gemini API của Google.

gemini-skills khác gì việc tự dán tài liệu cho trợ lý?

Skill là cách đóng gói kiến thức để trợ lý tự nạp khi cần, bạn không phải dán thủ công mỗi lần. Theo README, đây là kỹ thuật nhẹ để thêm ngữ cảnh phù hợp cho agent. Tác giả cho biết kết quả code đúng đạt 87% với Gemini 3 Flash và 96% với Gemini 3.1 Pro.

Cài trên Windows được không?

README không nêu hệ điều hành bắt buộc. Các lệnh cài dùng npx, agy, codex hoặc lệnh trong Claude Code và Cursor, nên về nguyên tắc chạy ở nơi các công cụ đó chạy được. Chưa có thông tin chính thức riêng cho Windows.

Dùng skill này có cần GPU không?

README không đề cập GPU. Skill chỉ là tài liệu cho trợ lý, còn model Gemini chạy trên hạ tầng của Google qua API, nên về mặt tư liệu không có yêu cầu phần cứng nào được nêu.

Có những skill nào trong repo?

Có 4 skill: gemini-api-dev (viết app với Gemini API), gemini-api-cli (gọi API từ shell), gemini-live-api-dev (streaming thời gian thực với Live API) và gemini-omni-flash-api (tạo và sửa video). Skill vertex-ai-api-dev đã chuyển sang repo google/skills.

Dùng với Claude Code, Cursor hay Codex được không?

Được. README có hướng dẫn riêng cho Claude Code, Cursor, OpenAI Codex và Antigravity, ngoài ra còn hai đường cài bằng npx qua Vercel skills CLI và Context7 skills CLI.

Dữ liệu của mình có an toàn không?

README không nói gì về xử lý dữ liệu. Skill là tài liệu, nhưng code do trợ lý viết sẽ gửi dữ liệu tới Gemini API, nên bạn nên xem chính sách của Google và đừng đưa thông tin nhạy cảm hay khóa API vào mã nguồn công khai.

Chuyển nhanh tới mục

  1. I.gemini-skills làm được gì
    1. A.gemini-api-dev: viết app với Gemini API
    2. B.gemini-api-cli: gọi Gemini từ dòng lệnh
    3. C.gemini-live-api-dev: ứng dụng thời gian thực
    4. D.gemini-omni-flash-api: tạo và chỉnh sửa video
  2. II.Cần chuẩn bị gì
  3. III.Cài đặt từng bước
    1. A.Cài bằng Vercel skills CLI (chạy được với nhiều trợ lý)
    2. B.Cài bằng Context7 skills CLI
    3. C.Cài trong Antigravity
    4. D.Cài trong Claude Code
    5. E.Cài trong Cursor
    6. F.Cài trong OpenAI Codex
  4. IV.Kiểm tra đã chạy được chưa
  5. V.Dùng vào việc thật
    1. A.Dev mới làm chatbot hỏi đáp bằng Python
    2. B.Chủ shop cần giọng đọc và nội dung media từ dòng lệnh
    3. C.Nhân viên văn phòng phân tích video và phiên âm họp
    4. D.Dev làm ứng dụng giọng nói hoặc video
  6. VI.Lỗi hay gặp và cách xử lý
    1. A.Báo không tìm thấy lệnh npx
    2. B.Gõ lệnh /plugin vào PowerShell nhưng không chạy
    3. C.Cài xong nhưng trợ lý vẫn viết code cũ
    4. D.Không tìm thấy skill Vertex AI
    5. E.Lộ khóa API hoặc phát sinh chi phí ngoài ý muốn
  7. VII.Có nên dùng không

Repo & Skill · 13/11/2026 · 11 phút đọc

Garden Skills: bộ skill thiết kế web, tạo ảnh, làm video cho AI — hướng dẫn cài đặt và dùng

Garden Skills là bộ sưu tập Agent Skills (kỹ năng cho AI) của tác giả ConardLi, dùng được với Claude Code, Cursor, Codex và các AI coding agent khác. Mỗi skill dạy agent làm tốt một việc như thiết kế trang web, tạo ảnh, làm video bằng code, biến tài liệu thành bài viết đẹp. Cài không khó, nhưng README có nhiều cách cài nên bạn cần chọn một cách hợp với công cụ đang dùng.

Repo & Skill · 13/11/2026 · 15 phút đọc

thesysdev/openui: xây giao diện AI dạng streaming — hướng dẫn cài đặt và dùng

OpenUI là framework full-stack, độc lập framework, giúp mô hình AI sinh giao diện có cấu trúc và hiển thị dần khi dữ liệu streaming về. Bạn có thể dựng nhanh một ứng dụng chat bằng CLI hoặc cài từng gói cho React, Vue, Svelte, Angular và LangChain. Việc bắt đầu khá đơn giản nếu máy có đúng phiên bản Node; README chưa ghi đầy đủ lệnh chạy ứng dụng sau khi scaffold.

Repo & Skill · 13/11/2026 · 11 phút đọc

Ruflo: điều phối nhóm agent AI cho Claude Code và Codex — hướng dẫn cài đặt và dùng

Ruflo (trước đây là Claude Flow) là một agent harness: lớp công cụ bao quanh Claude Code và Codex, bổ sung nhiều agent chuyên biệt, bộ nhớ qua các phiên và khả năng chia việc cho nhóm agent. Cài bằng một lệnh `npx ruflo@latest init` trong thư mục dự án, cần Node 20 trở lên. Cài khá dễ, nhưng hệ thống rất rộng nên bạn nên bắt đầu từ một tác vụ nhỏ.