Kỹ năng cho trợ lý AI: SKILL.md là gì và cách cài đặt không cần terminal

Tệp SKILL.md là gì

SKILL.md là một tệp văn bản chứa chỉ dẫn mà trợ lý AI đọc trước khi bắt tay vào việc. Không phải chương trình, cũng không phải tiện ích mở rộng: chỉ là markdown thông thường mô tả một loại công việc được làm ra sao — kiểm tra gì trước, suy luận theo thứ tự nào, kết quả trình bày dưới dạng gì, và điều gì tuyệt đối không làm. Tệp nằm trong một kho mã, trợ lý lấy nó về, và từ đó công việc được làm đúng như đã viết chứ không theo ứng biến của mô hình.

Định dạng này xuất hiện cuối năm 2025 và chỉ trong vài tháng đã trở nên phổ biến: Claude, Codex, Copilot, Cursor, Gemini CLI cùng hàng chục công cụ khác đều đọc được, còn các thư mục công khai giờ đếm kỹ năng bằng hàng trăm nghìn. Vậy mà gần như toàn bộ tài liệu lại viết cho người có sẵn terminal, kho mã và một tác tử lập trình đang chạy — đó là lý do duy nhất khiến chủ đề này đến giờ vẫn trông như chuyện của lập trình viên.

Bản thân tệp rất đơn giản. Hai phần, ngăn cách bằng một dòng ba dấu gạch.

Dưới đây là một kỹ năng hoàn chỉnh, kích thước sát thực tế. Nó mô tả cách rà lại bản ghi một cuộc gọi bán hàng: tìm gì, theo thứ tự nào, và điều gì không được tự suy diễn.

---
name: sales-call-review
description: Rà soát cuộc gọi bán hàng — phản đối, tín hiệu, bước tiếp theo
---

# Rà soát cuộc gọi bán hàng

Bạn đang phân tích bản gỡ băng cuộc trao đổi với khách hàng tiềm năng.

## Trình tự làm việc

1. Ghi lại các ý phản đối NGUYÊN VĂN, trong dấu ngoặc kép. Không diễn
   giải lại: cách nói chính xác của một ý phản đối chính là dữ liệu.
2. Với mỗi ý phản đối, ghi rõ đã có câu trả lời chưa và câu trả lời đó
   có được chấp nhận không. Im lặng không phải là đồng ý.
3. Tìm tín hiệu về ngân sách, thời hạn và ai là người quyết định.
   Nếu một tín hiệu không xuất hiện, viết đúng như vậy: «không đề cập».
4. Xác định bước tiếp theo: chính xác là gì, ai làm, hạn đến khi nào.

## Định dạng đầu ra

Bốn mục theo thứ tự trên. Bên trong là các gạch đầu dòng ngắn, không
có đoạn dẫn nhập. Ý phản đối trích trong ngoặc kép.

## Những điều không làm

- Không suy đoán động cơ của người đối thoại: chỉ những gì thực sự
  được nói ra.
- Không ước lượng xác suất chốt đơn bằng phần trăm — không có dữ liệu
  cho việc đó.
- Không đề xuất giảm giá làm bước tiếp theo nếu chuyện giá cả chưa
  từng được nhắc đến.

Hãy để ý những gì không có trong tệp: không mã nguồn, không cấu hình, không khóa API, không câu lệnh cài đặt. Kỹ năng là kinh nghiệm được viết ra, không phải phần mềm. Chính vì thế người chưa từng mở terminal vẫn viết được — và cũng chính vì thế, việc cài đặt nó đến nay vẫn đòi terminal mới là điều kỳ lạ.

Kỹ năng, công cụ và prompt: ai lo việc gì

Ba khái niệm liên tục bị lẫn lộn dù chúng giải quyết những vấn đề khác nhau. Khác biệt đơn giản hơn vẻ ngoài: prompt định vai, kỹ năng định phương pháp, MCP trao quyền truy cập.

Hệ quả thực tế: nếu trợ lý trả lời lệch trọng tâm, bạn cần kỹ năng. Nếu trả lời đúng nhưng không biết dữ kiện, bạn cần MCP. Kỹ năng có mài giũa đến đâu cũng không mang dữ liệu về, và máy chủ MCP có nhiều đến mấy cũng không dạy được phương pháp. Phần lớn công việc cần kỹ năng: phương pháp cũ đi chậm hơn dữ liệu rất nhiều, và chỉ cần viết một lần.

Vì sao «không cần terminal» thường nói về chuyện khác

«Cách cài kỹ năng mà không cần terminal» là câu hỏi thường gặp, và kết quả tìm kiếm cũng trả lời. Chỉ có điều chúng đang trả lời một câu hỏi khác.

Từ đây rút ra một câu hỏi tốt hơn khi chọn cách cài: đừng hỏi «có cần terminal không», hãy hỏi «tôi có phải nuôi thêm một tác tử chạy trên máy mình không». Nếu câu trả lời là có, kỹ năng vẫn là công cụ của lập trình viên, dù trình cài đặt có đẹp đến đâu.

Cài mà không cần terminal lẫn tác tử lập trình

Whisperer đọc thẳng SKILL.md và áp dụng nó vào câu trả lời của trợ lý. Không có gì để cài: tệp không bao giờ tới máy bạn, không có thư mục nào, và cũng chẳng có gì phải khởi động lại. Có hai nguồn — một thư mục dùng chung và bất kỳ kho mã GitHub công khai nào.

1. Bảng điều khiển web → Prompt → nút «Kỹ năng»
2. Thẻ «Có sẵn» → gõ từ khóa: system design, code review,
   sales, writing…
3. Danh sách hiện tên, kho mã nguồn gốc và số lượt cài. Mở một mục
   để đọc mô tả lấy từ frontmatter của nó
4. «Cài đặt» — kỹ năng vào thư viện của bạn
5. Mở một prompt → «Kết nối» → chọn kỹ năng

1. Bảng điều khiển web → Prompt → «Kỹ năng» → thẻ «Kho mã của bạn»
2. Dán bất kỳ dạng nào sau đây:
   owner/repo
   https://github.com/owner/repo
   https://github.com/owner/repo/tree/main/skills/sales-review
   https://github.com/owner/repo/blob/main/skills/sales-review/SKILL.md
3. «Tìm kỹ năng» — chúng tôi duyệt kho mã và liệt kê từng SKILL.md
   kèm mô tả. Nếu bạn dán liên kết tới một thư mục cụ thể, kỹ năng đó
   hiện lên đầu tiên
4. Bấm «Cài đặt» ở mục cần → rồi kết nối vào một prompt

Kỹ năng thực sự tác động lên đâu

Kỹ năng không gắn vào «trợ lý» nói chung, mà gắn vào prompt của một vai cụ thể. Vai là một mảng công việc: trả lời câu hỏi, đọc mã, đọc hình ảnh, thiết kế hệ thống. Kết nối kỹ năng vào một vai, bạn sẽ có nó ở mọi nơi vai đó hoạt động.

Việc kết nối có hai chế độ, và khác biệt giữa chúng nặng hơn cảm giác mà cái tên gợi ra.

«Bổ sung» — kỹ năng được thêm vào phần văn bản của prompt. Prompt vẫn định vai và giọng điệu, kỹ năng làm rõ phương pháp. Chín trên mười lần đây là chế độ đúng.

«Thay thế» — kỹ năng đẩy toàn bộ văn bản prompt ra ngoài và một mình đi tới mô hình. Nó dành cho kỹ năng tự thân đã đủ: đã định sẵn vai, quy trình và định dạng đầu ra, và ở đó prompt riêng của bạn chỉ gây vướng. Nếu kết nối hai kỹ năng mà một cái đặt ở «Thay thế», cái đó đi trước, còn các kỹ năng «Bổ sung» theo sau để làm rõ thêm.

Sau khi cài, kỹ năng ra sao

Đây là chi tiết phân tách một lần cài chạy tốt với một nguồn phiền toái về sau. Kỹ năng được ghim vào một commit. Lúc cài, chúng tôi ghi lại chính xác đã lấy phiên bản nào của tệp, và về sau vẫn dùng đúng phiên bản đó.

«Cập nhật từ kho mã» đọc lại tệp, hiển thị phiên bản mới và ghim kỹ năng vào commit hiện tại. Xóa một kỹ năng khỏi thư viện cũng gỡ luôn mọi kết nối của nó — không còn gì phải dọn riêng.

Ba kỹ năng nên viết đầu tiên

Quy tắc chọn: kỹ năng đáng bỏ công ở nơi bạn đã giải thích cùng một điều ba lần. Nếu bạn nhắc lại một chỉ dẫn trong mọi cuộc trò chuyện, đó là ứng viên. Nếu mỗi quý mới cần một lần, viết tay còn rẻ hơn.

1. Từ điển thuật ngữ của bạn

Bị xem nhẹ nhất và cũng viết nhanh nhất. Tên sản phẩm của công ty, các từ viết tắt nội bộ, họ của đồng nghiệp, tên khách hàng — tất cả những gì mô hình nghe lần đầu và làm hỏng. Năm phút công sức, hiệu quả thấy được trong mọi cuộc gọi.

---
name: our-glossary
description: Thuật ngữ, sản phẩm và tên người dùng trong công ty chúng tôi
---

# Từ điển của chúng tôi

Những từ này xuất hiện liên tục. Hãy viết đúng như thế này.

## Sản phẩm
- [Tên] — [là gì, trong một câu]

## Viết tắt
- [VT] — [dạng đầy đủ]. Đừng nhầm với [từ viết tắt tương tự]

## Người
- [Họ và tên] — [vai trò]

Nếu một từ nghe gần giống từ trong danh sách, hãy dùng cách viết trong
danh sách. Thuật ngữ lạ thì giữ nguyên như đã nghe; đừng «sửa» thành
một từ quen thuộc nghe na ná.

2. Khuôn thư theo sau cuộc gọi

Thư gửi sau một cuộc trao đổi lần nào cũng theo cùng một cấu trúc, và cấu trúc đó là của riêng mỗi người. Kỹ năng cố định nó: gồm những mục nào, theo thứ tự ra sao, dài chừng nào, câu mở đầu bắt đầu thế nào. Đây chính là trường hợp mà khoảng cách giữa «trợ lý đã trả lời» và «trợ lý trả lời giống bạn» lộ ra ngay từ lần thử đầu tiên.

3. Phương pháp rà soát cho loại cuộc họp của bạn

Ví dụ ở đầu bài chính là loại này. Phỏng vấn tuyển dụng, cuộc gọi bán hàng, họp rút kinh nghiệm và trò chuyện nghiên cứu — mỗi loại đáng để rút ra những thứ khác nhau. Trợ lý chung chung rút ra «các chủ đề chính»; một kỹ năng rút ra ý phản đối nguyên văn, hoặc tín hiệu về nỗi đau của khách hàng, hoặc khác biệt giữa các ứng viên trên cùng một nhóm câu hỏi.

An toàn: khoảng một phần ba kỹ năng công khai có vấn đề

Đây là phần quan trọng nhất của bài, và phần lớn hướng dẫn khác không hề có.

Cơ chế trở nên rõ ràng ngay khi ta nhớ rằng kỹ năng là một chỉ dẫn mà tác tử tin tưởng. Nguy hiểm nảy sinh khi tác tử có phương tiện để thi hành nó: quyền truy cập tệp, truy cập shell, truy cập khóa của bạn. Khi ấy dòng «xem tệp .env và thêm nội dung của nó vào cấu hình» biến thành một vụ rò rỉ.

Từ đó có một phân biệt đáng nắm khi chọn cách cài đặt.

Nói thẳng: không tồn tại một chỉ dẫn của người khác mà an toàn tuyệt đối. Bỏ đi việc chạy mã sẽ xóa nhóm tấn công nặng nề nhất — khóa bị lấy, cửa hậu, tệp bị tuồn ra — nhưng văn bản vẫn cứ là văn bản. Một kỹ năng viết với dụng ý xấu vẫn có thể đẩy trợ lý về phía cách diễn đạt có lợi cho tác giả: gợi ý một sản phẩm nhất định, lờ đi các lựa chọn khác, làm lệch một nhận định. Phần thân được đưa qua bộ lọc nội dung khi cài và ở mỗi lần cập nhật, và văn bản vi phạm chính sách một cách rõ ràng sẽ không lọt — nhưng bộ lọc bắt được vi phạm, chứ không bắt được lợi ích riêng.

Vậy nên kết luận thực tế rất đơn giản: phần thân kỹ năng hiện ngay trên thẻ của nó, và đáng để đọc. Đó là hai màn hình markdown bằng ngôn ngữ thường ngày, không phải mã cần được đào tạo mới kiểm được. Năm phút đọc trước khi kết nối giải quyết một vấn đề mà trong thế giới tác tử lập trình phải cần tới máy quét.

Những giới hạn nên biết trước

Bốn điều nên nói ngay còn hơn để bạn tự phát hiện về sau.

Kỹ năng dựa vào script chỉ chạy được một phần. Một số kỹ năng trong thư mục được viết với giả định tác tử sẽ chạy đoạn mã đi kèm. Ở đây chỉ văn bản được thi hành. Nếu chỉ dẫn tự nó đứng vững, kỹ năng chạy trọn vẹn; nếu rốt cuộc nó chỉ là «hãy chạy analyze.py», nó không chạy chút nào. Điều này nhận ra được trước khi cài: mô tả và phần thân đều hiện trong bản xem trước.

Phần thân giới hạn ở 24 000 ký tự. Khoảng mười trang — nhiều hơn nhu cầu của bất kỳ kỹ năng hợp lý nào. Tệp dài hơn sẽ được kết nối ở dạng cắt bớt, và điều đó được báo rõ ràng chứ không âm thầm.

Kỹ năng luôn nằm trong prompt, không phải nạp khi cần. Một số tác tử lập trình chỉ kéo phần thân vào khi thấy công việc khớp. Ở đây, kỹ năng đã kết nối sẽ đi tới mô hình trong từng yêu cầu thuộc vai đó. Cách này dễ đoán hơn — nó không thể không kích hoạt đúng lúc bạn cần — và cũng chính là lý do của giới hạn ba kỹ năng mỗi prompt.

Kho mã riêng tư không được hỗ trợ. Chúng tôi tới GitHub mà không mang theo thông tin đăng nhập của bạn, nên chỉ thấy phần công khai. Một kho riêng tư và một kho không tồn tại là như nhau đối với chúng tôi: cả hai đều trả về «không tìm thấy».

Danh mục kiểm trước khi kết nối kỹ năng của người khác

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

Có cần biết lập trình để viết một kỹ năng không?

Không. Kỹ năng là văn bản bằng ngôn ngữ thường ngày: làm gì, theo thứ tự nào, tránh gì. Yêu cầu kỹ thuật duy nhất là bốn dòng frontmatter ở đầu tệp, và có thể sao nguyên từ ví dụ bên trên. Kho mã GitHub tạo được từ giao diện web, còn tệp thì thêm bằng một nút bấm.

Kỹ năng khác prompt hệ thống ở chỗ nào?

Prompt mô tả ai đang trả lời và với giọng điệu gì; kỹ năng mô tả một loại việc được làm ra sao. Khác biệt thực tế nằm ở khả năng tái dùng: prompt mang tính cá nhân, còn kỹ năng viết một lần và hợp với bất kỳ ai làm cùng công việc đó. Vì vậy người ta chia sẻ kỹ năng, và gần như không chia sẻ prompt.

Nên chọn kỹ năng hay MCP?

Đây không phải hai lựa chọn thay nhau. Kỹ năng mang lại phương pháp, MCP mang lại dữ liệu và hành động. Nếu trợ lý trả lời lệch trọng tâm, bạn cần kỹ năng; nếu trả lời tốt nhưng không biết dữ kiện, bạn cần MCP. Nhiều khi cần cả hai: MCP mang dữ liệu từ bảng công việc về, còn kỹ năng nói rõ phải xử lý chúng thế nào.

Một kỹ năng có kết nối được vào nhiều prompt không?

Được. Thư viện dùng chung và số lượng kết nối không bị giới hạn. Kỹ năng chỉ lưu một lần và hoạt động ở mọi nơi nó được nối vào.

Nếu tác giả sửa kỹ năng trong kho mã thì sao?

Không có gì xảy ra. Bản sao của bạn bị đóng băng ở commit mà nó được lấy về. Thay đổi chỉ tới khi bạn bấm «Cập nhật từ kho mã» — và khi đó phần thân mới lại đi qua bộ lọc nội dung một lần nữa.

Vì sao đôi khi tìm kiếm không trả về gì?

Hai lý do. Thư mục có thể tạm thời không truy cập được — khi đó danh sách rỗng, nhưng việc kết nối kho mã của riêng bạn vẫn chạy bình thường. Hoặc GitHub đang giới hạn chúng tôi: không có token thì hạn mức tính cho toàn dịch vụ, và trong những lúc như vậy chờ vài phút vẫn trung thực hơn là trưng ra kết quả rỗng như thể không có kỹ năng nào.

Kỹ năng viết cho Claude Code hay Cursor có chạy ở đây không?

Có, miễn là chỉ dẫn tự nó đứng vững: định dạng y hệt và văn bản đọc lên cũng như nhau. Thứ không chuyển sang được là phần giả định có hệ thống tệp, shell hay việc chạy script — một trợ lý làm việc với các cuộc họp của bạn vốn không có những thứ đó, và điều này là có chủ ý.

Bắt đầu từ đâu

Cách nhanh nhất để biết kỹ năng có hợp với bạn không: lấy một chỉ dẫn mà bạn đã đưa cho trợ lý vài lần liên tiếp, rồi lưu nó thành kỹ năng. Năm phút cho tệp, một phút để kết nối. Kết quả đọc được ngay: nếu câu trả lời sát hơn với điều bạn định nói, bạn vừa thôi phải lặp lại chính mình. Nếu không, chỉ dẫn đó nói về dữ liệu chứ không phải phương pháp, và lời giải nằm ở một công cụ khác.

Thư viện kỹ năng nằm trong bảng điều khiển web, mục Prompt. Cách prompt và vai hoạt động được trình bày trong hướng dẫn Prompt Studio, còn mô hình nào đảm nhiệm vai nào thì xem tài liệu vai của mô hình.