Kitviet

Kit Việt - Bộ AI Agent tiếng Việt cho 20 nghề

Giao việc bằng tiếng Việt, nhận lại file Word, Excel, PDF, PowerPoint đúng thể thức.
Chạy trên Claude Desktop, Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI và 20 AI khác.

mochistudio.io.vn · Cài đặt · 20 bộ theo nghề · Bản Pro

Kit Việt là gì?

Kit Việt không phải kho prompt. Đây là các quy trình nghề đóng gói sẵn cho người đi làm ở Việt Nam. Mỗi bộ gồm:

• Skill (cách làm): mỗi skill là một việc cụ thể như đối chiếu công nợ, lập dự toán, soạn hợp đồng hay viết JD. Bạn nói việc bình thường, AI tự chọn đúng skill. Tên skill có tiền tố kv:, ví dụ kv:viet-bao-cao.
• Trợ lý (agent) có khóa quyền: mỗi trợ lý giữ một vai.
  • Thu thập chỉ đọc và tra cứu.
  • Thực thi soạn bản nháp và ghi file.
  • Gác cổng chỉ được báo lỗi, không được sửa thay.
  • Điều phối lập kế hoạch và kiểm định bàn giao.
• Luồng việc nối tiếp: mỗi skill kết thúc bằng gợi ý bước kế tiếp, nên các việc nối thành chuỗi cố định.
• Xuất file: Word, Excel, PDF và PowerPoint trình bày sẵn, như công văn, tờ trình, bảng lương, báo cáo, slide họp.
• Chống bịa và bảo mật: có skill kiểm tra chống bịa số liệu, skill che thông tin nhạy cảm, và trợ lý soát bảo mật trước khi bạn dán dữ liệu vào AI.

20 bộ theo nghề

Mỗi bộ có 30–43 skill (gồm 18 kỹ năng nền dùng chung) và 12–15 trợ lý. Mở HUONG-DAN.html của từng nghề để xem hướng dẫn có hình và ví dụ thật.

Cài đặt nhanh

Có 3 cách. Chọn cách hợp với nơi bạn dùng AI.

Cách 1: Claude Code Marketplace (2 lệnh)

Gõ trong Claude Code:

/plugin marketplace add mochistudio-vn/kitviet
/plugin install kv-ke-toan@kitviet

Thay ke-toan bằng nghề của bạn, xem tên ở bảng 20 bộ theo nghề, ví dụ kv-xay-dung@kitviet hay kv-y-te@kitviet. Cài xong gõ /kv: để xem skill. Cập nhật bằng /plugin marketplace update kitviet.

Nếu báo lỗi Host key verification failed, dùng địa chỉ HTTPS: /plugin marketplace add https://github.com/mochistudio-vn/kitviet.git. Trên Windows mà báo Filename too long thì chạy một lần git config --global core.longpaths true.

Cách 2: CLI kitviet (khuyên dùng)

Cần Node.js 18 trở lên. Chạy thẳng, không cần cài:

npx github:mochistudio-vn/kitviet init ke-toan --ai claude

Hoặc cài CLI cho cả máy rồi dùng lệnh kitviet:

npm install -g github:mochistudio-vn/kitviet

kitviet init ke-toan --ai claude         # Claude Code -> ~/.claude/skills/kv
kitviet init ke-toan --ai cursor         # Cursor -> ./.cursor/skills
kitviet init ke-toan --ai codex,gemini   # nhiều AI một lần
kitviet init ke-toan nhan-su --ai copilot # nhiều nghề
kitviet init                             # không ghi gì: hiện menu chọn nghề, tự nhận biết AI

Hỗ trợ 26 nền tảng. Skill cài vào thư mục dự án đang mở; thêm --global để cài cho cả máy (vào thư mục người dùng ~). Các AI ngoài Claude Code đều dùng chuẩn Agent Skills (kv-<tên>/SKILL.md).

Codex cài thêm trợ lý vào .codex/agents. Claude Desktop nhận file zip để tải lên (Customize → Skills). --ai all cài cho tất cả nền tảng.

Lệnh khác:

kitviet list                  # danh sách nghề
kitviet versions              # phiên bản đang dùng
kitviet update                # cài lại các bộ đã cài bằng phiên bản CLI hiện tại
kitviet init ... --dry-run    # xem trước sẽ chép gì, không ghi file
kitviet platforms             # danh sách nền tảng và thư mục cài
kitviet uninstall             # gỡ khỏi mọi nền tảng đã cài
kitviet uninstall --ai cursor

Muốn dùng đúng một phiên bản: npx github:mochistudio-vn/kitviet#v1.3.0 init ....

Cách 3: Cài thủ công

Tải repo về (Code → Download ZIP) rồi giải nén. Mỗi thư mục nghề có sẵn 3 bản cho 3 nền tảng.

Claude Desktop / claude.ai:

1. Vào Customize → Skills. Cần gói trả phí và bật Code execution.
2. Bấm Upload skill, chọn các file kv-<tên>.zip trong <nghề>/claude-web/. Mỗi file là một skill.
3. Bật skill vừa tải, rồi gõ việc bằng tiếng Việt, hoặc gọi thẳng "Dùng skill kv-<tên> để ...".

Claude Code: copy <nghề>/claude-code/kv vào ~/.claude/skills/, mở lại Claude Code, gõ /kv:. Dùng nhiều nghề thì copy đè vào cùng thư mục kv.

ChatGPT Codex: copy <nghề>/codex/.agents/skills/* vào ~/.agents/skills/ và <nghề>/codex/.codex/agents/* vào ~/.codex/agents/. Trong Codex gõ /skills, gọi skill bằng $kv-<tên>.

Muốn xuất file bằng script trên Claude Code hoặc Codex thì cài thêm: pip install python-docx openpyxl python-pptx reportlab.

Ví dụ

Làm giúp bảng lương tháng 10 từ file cham-cong-t10.csv. Tỷ lệ bảo hiểm và giảm trừ
lấy theo bảng tham số trong CLAUDE.md của tôi. Xuất ra Excel.

Claude tự gọi kv:tinh-luong-thue-tncn-bhxh, đưa bảng tham số ra để bạn duyệt, kiểm chéo tổng thu nhập, che tên và số tài khoản, rồi xuất file .xlsx. Xem thêm ví dụ trên Claude Desktop, Claude Code và Codex trong HUONG-DAN.html của từng nghề.

Bản Pro

Mỗi nghề có bản Pro:

Mỗi skill Free đều có mục "Bản Pro có thêm" ở cuối file SKILL.md để bạn xem trước bản Pro làm được gì. Liên hệ nâng cấp: mochistudio.io.vn

Cộng đồng

Góp ý, báo lỗi, chia sẻ cách dùng: mochistudio.io.vn. Bạn cũng có thể mở Issue ngay trong repo này.

Ba nguyên tắc khi dùng:

1. AI hỗ trợ, bạn chịu trách nhiệm cuối. Đọc lại mọi bản trước khi gửi, ký hoặc nộp.
2. Không để AI tự gửi thay bạn. Bộ kit chỉ soạn và lưu file.
3. Che thông tin nhạy cảm trước khi dán vào AI. Dùng kv:an-thong-tin-nhay-cam.

Kit Việt là sản phẩm của MochiStudio · mochistudio.io.vn
Bộ phát hành theo giấy phép MIT, giữ nguyên file LICENSE trong gói.

_{Kit Việt là sản phẩm độc lập, không liên kết với Anthropic hay OpenAI. Claude là nhãn hiệu của Anthropic. ChatGPT và Codex là nhãn hiệu của OpenAI.}