README.vi.md

OK Skills: bộ AI coding agent skills cho Codex, Claude Code, Cursor, OpenClaw và hơn thế nữa

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Deutsch | Español | Tiếng Việt | Русский | हिन्दी

Bộ sưu tập AI coding agent skills và playbook CLAUDE.md / AGENTS.md được tuyển chọn cho Codex, Claude Code, Cursor, OpenClaw, Trae và các công cụ khác tương thích với SKILL.md.

Kho này hiện gồm 32 skill có thể tái sử dụng, tất cả được duy trì trực tiếp dưới dạng thư mục skill cấp cao nhất trong repo này. Chỉ cần clone vào ~/.agents/skills/ok-skills; các thư mục bên trong đã khớp với bố cục mà workflow dựa trên AGENTS.md mong đợi, và CLAUDE_AGENTS.md cung cấp agent playbook hướng tới Claude Code.

Nếu bạn đang tìm Codex skills, Claude Code skills, Cursor skills, OpenClaw skills, các playbook CLAUDE.md / AGENTS.md có thể tái dùng, hoặc các ví dụ SKILL.md thực dụng, repo này được tổ chức để vừa dễ tìm kiếm vừa có thể dùng ngay.

Các tình huống dùng phổ biến: tra cứu tài liệu, tự động hóa trình duyệt, prompt engineering, workflow lập kế hoạch, thiết kế frontend, và xử lý PDF/Word/PPTX/XLSX.

Repo này phù hợp với ai

• Bạn dùng Codex, Claude Code, Cursor, OpenClaw, Trae hoặc một AI coding agent khác và muốn dùng lại skill thay vì viết prompt ad-hoc.
• Bạn duy trì workflow với CLAUDE.md / AGENTS.md / SKILL.md và muốn có hướng dẫn có thể dùng xuyên nhiều dự án.
• Bạn cần các skill đã được kiểm chứng cho tra cứu tài liệu, tự động hóa trình duyệt, lập kế hoạch, prompt engineering, thiết kế frontend, PDF, tài liệu Office, slide deck và bảng tính.

Bắt đầu từ đây

Nếu lúc đầu bạn chỉ cài vài skill, hãy bắt đầu với những skill sau:

• planning-with-files: lập kế hoạch dựa trên file cho tác vụ phức tạp, nghiên cứu và công việc kéo dài.
• find-docs: lấy tài liệu thư viện mới nhất, tham chiếu API và ví dụ được Context7 hỗ trợ.
• agent-browser: tự động hóa trình duyệt cho ảnh chụp màn hình, biểu mẫu, scraping và web QA.

Quick Start trong 1 phút

mkdir -p ~/.agents/skills
cd ~/.agents/skills
git clone https://github.com/mxyhi/ok-skills.git ok-skills

Sau khi clone, repo sẽ nằm tại ~/.agents/skills/ok-skills, và các thư mục bên trong đã theo đúng bố cục mong đợi:

~/.agents/skills/ok-skills/
  CLAUDE_AGENTS.md
  planning-with-files/
    SKILL.md
  find-docs/
    SKILL.md
  agent-browser/
    SKILL.md
  ...

Với chỉ dẫn toàn cục cho Claude Code hoặc Codex, hãy bắt đầu từ CLAUDE_AGENTS.md, rồi sao chép hoặc gộp vào CLAUDE.md của Claude Code hoặc AGENTS.md của Codex. File này đóng gói workflow Chinese-first, theo KISS, kiểm tra tài liệu/source mới nhất, ưu tiên multi-agent, bật mặc định caveman / planning-with-files / karpathy-guidelines, kỳ vọng TypeScript nghiêm ngặt và quy tắc định tuyến context-mode. Trước khi tái sử dụng, hãy chỉnh phần 语言要求 cho dự án của bạn. Phần 其他注意项 là cấu hình cục bộ theo dự án và có thể chỉnh khi cần.

Thêm các quy tắc kích hoạt đơn giản vào AGENTS.md của bạn, hoặc gộp cùng các trigger skill đó vào CLAUDE.md / AGENTS.md:

## Skills

- planning-with-files: Use for complex tasks, research, or anything that will take 5+ tool calls.
- find-docs: Use when you need current library docs, API references, or Context7-backed examples.
- agent-browser: Use for browser automation, screenshots, scraping, web testing, or form filling.

Sau đó bạn có thể yêu cầu một cách tự nhiên:

• Use planning-with-files before refactoring this module.
• Use find-docs to fetch the latest docs for this SDK.
• Use agent-browser to reproduce this UI bug.

Duyệt skills theo trường hợp sử dụng

Nghiên cứu và tài liệu

• find-docs: workflow Context7 CLI tập trung vào tra cứu tài liệu mới nhất.
• exa-search: nghiên cứu web, code và công ty bằng các công cụ tìm kiếm Exa.
• get-api-docs: lấy tài liệu API và SDK bên thứ ba mới nhất trước khi viết code.
• find-skills: khám phá các skill sẵn có khi người dùng cần một năng lực cụ thể.

Lập kế hoạch và prompting

• planning-with-files: lập kế hoạch Markdown bền vững với task_plan.md, findings.md và progress.md.
• autoresearch: vòng lặp tự động theo mục tiêu với goal, metric, verify loop và keep/discard gate rõ ràng.
• diagnosing-bugs: vong lap chan doan co ky luat cho bug kho va regression hieu nang.
• grill-with-docs: doi chieu plan voi domain language, CONTEXT.md, ADR va cap nhat docs inline.
• grilling: reusable one-question-at-a-time interview loop cho direct grill sessions va grill-with-docs.
• handoff: nen cong viec hien tai thanh handoff document da redact cho agent moi.
• teach: van hanh teaching workspace co mission, resources, lessons va learning records.
• domain-modeling: build and sharpen project domain terminology, CONTEXT.md, and ADRs.
• codebase-design: shared deep-module vocabulary for seams, interfaces, leverage, locality, and testability.
• improve-codebase-architecture: tìm cơ hội architecture deepening giúp tăng locality, leverage, testability và AI navigation.
• prototype: tao prototype logic hoac UI dung mot lan de tra loi nhanh design question.
• karpathy-guidelines: hướng dẫn hành vi coding giúp giảm overcomplication, giả định ẩn và thay đổi không kiểm chứng được.
• migrate-to-shoehorn: migrate as type assertions trong test sang @total-typescript/shoehorn.
• tdd: test-first red-green-refactor cho tính năng, bugfix, refactor và thay đổi hành vi.
• systematic-debugging: điều tra có hệ thống nguyên nhân gốc của bug, test lỗi hoặc hành vi bất thường trước khi đề xuất cách sửa.

Tự động hóa và QA

• agent-browser: tự động hóa trình duyệt cho điều hướng, biểu mẫu, ảnh chụp màn hình và scraping.
• kimi-webbridge: điều khiển trình duyệt thật của người dùng qua daemon cục bộ để điều hướng, điền biểu mẫu, chụp màn hình, đọc trang và dùng phiên đã đăng nhập.
• browser-trace: ghi lại CDP trace, ảnh chụp màn hình và DOM dump cho quá trình gỡ lỗi tự động hóa trình duyệt.
• opencli: biến website thành lệnh CLI bằng cách tái sử dụng phiên đăng nhập trình duyệt, truy cập API công khai và sinh adapter bằng AI.
• xquik-twitter: tìm kiếm dữ liệu X/Twitter và chạy thao tác tài khoản đã xác nhận qua Xquik API.

Frontend và thiết kế

• ai-elements: xây dựng các thành phần UI chat AI cho thư viện ai-elements.
• huashu-design: tạo prototype HTML độ trung thực cao, demo tương tác, slide deck, motion design, biến thể thiết kế, video export và design critique.
• better-icons: tìm kiếm, duyệt và lấy icon SVG từ hơn 200 bộ Iconify qua CLI hoặc MCP.

Tiện ích và biên soạn nội dung

• minimax-docx: tạo, chỉnh sửa và định dạng DOCX chuyên nghiệp với OpenXML SDK (.NET).
• minimax-pdf: tạo, điền và tái định dạng tài liệu PDF bằng hệ thiết kế token.
• pptx-generator: tạo, chỉnh sửa và đọc bản trình bày PowerPoint bằng PptxGenJS, luồng XML hoặc markitdown.
• huashu-design: tạo HTML deck, PPTX chỉnh sửa được, MP4/GIF motion pieces và video thiết kế có narration.
• minimax-xlsx: mở, tạo, đọc, phân tích, chỉnh sửa và kiểm tra tệp Excel/bảng tính với quy trình XML ít mất mát.

Gói skill vendored

planning-with-files/ dùng OthmanAdi/planning-with-files/.codex/skills/planning-with-files làm upstream baseline. Repo này dùng thư mục upstream đó làm baseline canonical cho skill cục bộ. Khac biet cuc bo chi gom frontmatter SKILL.md tuong thich skills-ref va tai lieu dung duong dan script tuong doi khong phu thuoc vi tri cai dat.

Các điều kiện tiên quyết phổ biến

• Một số skill giả định rằng gh đã được cài đặt và đăng nhập.
• Các skill thiên về trình duyệt có thể cần môi trường hỗ trợ Chrome/CDP.
• Các skill tra cứu tài liệu bên thứ ba có thể phụ thuộc vào CLI hoặc công cụ MCP bên ngoài; hãy kiểm tra từng SKILL.md để biết chi tiết.

Chỉ mục đầy đủ của skill

Cột Source URL trỏ tới upstream chính thức khi một skill được vendored/imported; nếu không, nó sẽ trỏ tới thư mục skill trong repo này.

Top-Level Skills

Skill	Mô tả	Source URL
agent-browser	CLI tự động hóa trình duyệt cho AI agents: điều hướng, điền biểu mẫu, chụp màn hình, trích xuất và kiểm thử web.	vercel-labs/agent-browser
ai-elements	Tạo các thành phần giao diện chat AI mới cho thư viện ai-elements với mô hình composable và quy ước shadcn/ui.	vercel/ai-elements
autoresearch	Engine lặp tự động theo mục tiêu cho workflow modify, verify, keep/discard và repeat.	uditgoenka/autoresearch
better-icons	Tìm trong hơn 200 bộ Iconify và lấy icon SVG qua CLI hoặc công cụ MCP.	better-auth/better-icons
kimi-webbridge	Điều khiển trình duyệt thật của người dùng qua daemon cục bộ để điều hướng, điền biểu mẫu, chụp màn hình, đọc trang và dùng phiên đã đăng nhập.	install.sh
browser-trace	Ghi lại CDP trace, ảnh chụp màn hình và DOM dump để gỡ lỗi tự động hóa trình duyệt.	browserbase/skills
caveman	Che do giao tiep sieu nen, tra loi kieu nguoi toi co de giam token nhung van giu do chinh xac ky thuat.	JuliusBrussee/caveman
diagnosing-bugs	Vong lap chan doan co ky luat cho bug kho va regression hieu nang.	mattpocock/skills
find-docs	Dùng Context7 CLI để tra cứu tài liệu mới nhất, tham chiếu API và ví dụ mã.	upstash/context7
minimax-docx	Tạo, chỉnh sửa và định dạng DOCX chuyên nghiệp với OpenXML SDK (.NET).	MiniMax-AI/skills
exa-search	Dùng Exa cho nghiên cứu web, code và công ty.	Custom
find-skills	Khám phá các skill hiện có khi người dùng cần những năng lực chuyên biệt.	vercel-labs/skills
huashu-design	Tạo prototype HTML độ trung thực cao, demo tương tác, slide deck, motion design, biến thể thiết kế, video export và design critique.	alchaincyf/huashu-design
get-api-docs	Lấy tài liệu API hoặc SDK bên thứ ba hiện tại trước khi viết code.	andrewyng/context-hub
grill-with-docs	Stress-test plan voi domain language, CONTEXT.md, ADR va cap nhat tai lieu inline.	mattpocock/skills
grilling	Reusable one-question-at-a-time interview loop cho direct grill sessions va grill-with-docs.	mattpocock/skills
handoff	Nen conversation hien tai thanh handoff document da redact cho agent khac tiep quan.	mattpocock/skills
teach	Day mot skill hoac concept trong workspace co mission, resources, lessons va learning records.	mattpocock/skills
domain-modeling	Build and sharpen project domain terminology, CONTEXT.md, and ADRs.	mattpocock/skills
codebase-design	Shared deep-module vocabulary for seams, interfaces, leverage, locality, and testability.	mattpocock/skills
improve-codebase-architecture	Tìm cơ hội architecture deepening giúp tăng locality, leverage, testability và AI navigation.	mattpocock/skills
prototype	Tao prototype logic hoac UI dung mot lan de tra loi nhanh design question.	mattpocock/skills
karpathy-guidelines	Hướng dẫn hành vi coding giúp giảm overcomplication, giả định ẩn và thay đổi không kiểm chứng được.	forrestchang/andrej-karpathy-skills
migrate-to-shoehorn	Migrate file test từ as type assertions sang @total-typescript/shoehorn.	mattpocock/skills
opencli	Biến website thành lệnh CLI bằng cách tái sử dụng phiên đăng nhập trình duyệt, truy cập API công khai và sinh adapter bằng AI.	jackwener/opencli
xquik-twitter	Tìm kiếm dữ liệu X/Twitter và chạy thao tác tài khoản đã xác nhận qua Xquik API.	Xquik-dev/x-twitter-scraper
minimax-pdf	Tạo, điền và tái định dạng tài liệu PDF bằng hệ thiết kế token.	MiniMax-AI/skills
planning-with-files	Lập kế hoạch dựa trên file cho các tác vụ phức tạp bằng task_plan.md, findings.md và progress.md.	OthmanAdi/planning-with-files
pptx-generator	Tạo, chỉnh sửa và đọc bản trình bày PowerPoint bằng PptxGenJS, luồng XML hoặc markitdown.	MiniMax-AI/skills
tdd	Dùng trước tính năng, bugfix, refactor hoặc thay đổi hành vi; ưu tiên integration-style tests qua public interface.	mattpocock/skills
systematic-debugging	Dùng khi gặp bug, test lỗi hoặc hành vi bất thường, trước khi đề xuất cách sửa.	obra/superpowers
minimax-xlsx	Mở, tạo, đọc, phân tích, chỉnh sửa và kiểm tra tệp Excel/bảng tính với quy trình XML ít mất mát.	MiniMax-AI/skills

Đóng góp

Chúng tôi hoan nghênh đóng góp cho các skill mới hoặc cải tiến skill hiện có.

1. Giữ điều kiện kích hoạt rõ ràng và có thể kiểm chứng.
2. Giữ ví dụ ngắn gọn và thiên về thực thi.
3. Nếu một skill phụ thuộc vào công cụ bên ngoài, hãy ghi rõ phụ thuộc đó trong SKILL.md.
4. Cập nhật README.md và README.zh-CN.md khi bạn thêm hoặc đổi tên skill, đồng thời làm mới các README bản dịch khác khi chỉ mục skill công khai thay đổi.

Giấy phép

Repo này được cấp phép theo LICENSE.