vn-law-check — Claude Code skill for Vietnam website audits
The vn-law-check Claude Code skill reviews websites and mobile apps against Vietnamese law. It runs on requests for a compliance audit or help drafting a privacy policy, consent form, or cookie banner.
MIT ★ 509 updated 2026-11-13
npx skills add mhfed/vn-law-check --skill vn-law-check -a claude-codeWhat vn-law-check does
The skill scans a code directory or website, classifies the project, and selects relevant checks, such as personal data protection, e-commerce, or online advertising. It runs bash scripts/scan.sh <code-directory> or bash scripts/scan.sh <URL>, then examines actual pages, forms, and cookie banners.
Each finding receives a severity rating, and urgent code issues come with a repair prompt. The workflow starts with references/00-triage.md; legal sources should be checked on thuvienphapluat.vn or vbpl.vn. Its report is an initial review, not formal legal advice, and the skill recommends consulting a lawyer for final decisions.
What it helps with
- check a website against Vietnamese personal data rules
- select relevant compliance checks for an online store
- find issues in a consent form or cookie banner
- draft a privacy policy for a project
Example prompts for the agent
- Audit this website for compliance with Vietnamese law.
- Check this project against Vietnam's personal data protection rules.
- Draft a privacy policy and consent form for this website.
How to install vn-law-check
1Skills CLI (Vercel)
npx skills add mhfed/vn-law-check --skill vn-law-check -a claude-code2Manually: put the files in place
~/.claude/skills/vn-law-check/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/vn-law-check/
1Skills CLI (Vercel)
npx skills add mhfed/vn-law-check --skill vn-law-check -a codex2Manually: put the files in place
.agents/skills/vn-law-check/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add mhfed/vn-law-check --skill vn-law-check -a cursor2Manually: put the files in place
.cursor/skills/vn-law-check/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install mhfed/vn-law-check vn-law-check2Manually: put the files in place
.github/skills/vn-law-check/SKILL.md1Skills CLI (Vercel)
npx skills add mhfed/vn-law-check --skill vn-law-check -a gemini-cli2Platform CLI
gemini skills install https://github.com/mhfed/vn-law-checkManually: put the files in place
.devin/skills/vn-law-check/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about vn-law-check
How do I install vn-law-check in Claude Code?
Run npx skills add mhfed/vn-law-check --skill vn-law-check -a claude-code. The skill file is placed at ~/.claude/skills/vn-law-check/SKILL.md.
What does vn-law-check do?
It scans a website or mobile app and checks applicable Vietnamese legal requirements. The output is an initial report with severity ratings and prompts for urgent fixes.
How does the skill audit a website?
It first classifies the project using references/00-triage.md, runs bash scripts/scan.sh, and reviews the site's actual pages and forms. The checks depend on the project type.
Source text
SKILL.md · MIT
--- name: vn-law-check description: "Rà soát/audit một website hoặc mobile app theo pháp luật Việt Nam về bảo vệ dữ liệu cá nhân, thương mại điện tử, an ninh mạng, bảo vệ người tiêu dùng, quảng cáo trực tuyến, giao dịch điện tử và minh bạch AI. Dùng khi người dùng yêu cầu audit/kiểm tra/rà soát pháp lý website theo luật VN, hỏi về tuân thủ NĐ 356/2025, Luật Bảo vệ dữ liệu cá nhân, Luật Thương mại điện tử 2025, hoặc cần checklist compliance cho site Việt Nam. Cũng dùng khi người dùng muốn soạn chính sách bảo mật/chính sách bảo vệ dữ liệu cá nhân, form đồng ý, banner cookie đúng luật VN cho dự án. Also use for English requests: Vietnam legal compliance audit, Vietnamese privacy law (PDPL), Decree 356/2025, Vietnam e-commerce law, Vietnam cybersecurity law, website or mobile app compliance check for Vietnamese users." --- # VN Web Compliance Audit Rà soát (audit) một website theo quy định pháp luật Việt Nam hiện hành liên quan đến: bảo vệ dữ liệu cá nhân, thương mại điện tử, an ninh mạng/lưu trữ dữ liệu, bảo vệ người tiêu dùng, quảng cáo trực tuyến, giao dịch điện tử, và minh bạch AI (nếu áp dụng). ## Nguyên tắc bắt buộc 1. **Không khẳng định dứt khoát** "website này vi phạm/không vi phạm pháp luật". Đây là công cụ hỗ trợ rà soát ban đầu, không phải tư vấn pháp lý chính thức. 2. **Luôn trích dẫn số hiệu văn bản pháp luật cụ thể** (số văn bản, ngày ban hành/hiệu lực, điều khoản nếu biết) cho mỗi mục kiểm tra. Không bịa số hiệu. Nếu không chắc, nói rõ "cần tra cứu lại". 3. Luật Việt Nam về dữ liệu cá nhân, TMĐT, an ninh mạng đang trong giai đoạn chuyển tiếp mạnh (nhiều luật mới 2025 có hiệu lực trong 2026, một số nghị định xử phạt chưa ban hành hoặc chưa xác minh được). Mục nào checklist ghi "CHƯA XÁC MINH" thì chỉ dẫn tên văn bản, không tự điền số điều hay mức phạt. Luôn khuyến nghị người dùng xác minh lại văn bản còn hiệu lực tại thuvienphapluat.vn hoặc vbpl.vn. Đọc ngày "Cập nhật" ở đầu `sources/legal-references.md`: nếu cách ngày audit hơn 3 tháng, ghi một dòng cảnh báo ở đầu báo cáo rằng dữ liệu luật của bộ checklist có thể đã cũ. 4. Mỗi phát hiện phân loại mức độ: 🔴 Cần xử lý ngay / 🟡 Nên cải thiện / 🟢 Đạt yêu cầu / ⚪ Không áp dụng. Với site nhỏ, nghĩa vụ giấy tờ, thủ tục chỉ xếp tối đa 🟡 và gom ở cuối báo cáo; 🔴 dành cho lỗi sửa được trong code (xem "Mức ưu tiên" trong `references/00-triage.md`). 5. Luôn khuyến nghị tham vấn luật sư cho quyết định cuối cùng, đặc biệt với mục 🔴. 6. Tự xác định loại hình website bằng cách quét code/nội dung thực tế (xem `references/00-triage.md`). Không đoán bừa, nhưng cũng không hỏi người dùng nếu quét được. Chỉ hỏi lại khi quét xong vẫn không xác định được. 7. **Mức phạt chỉ lấy từ `references/08-penalties-reference.md`.** Hành vi nào bảng đó không có mức cụ thể thì ghi "mức phạt: CHƯA XÁC MINH", không tự đưa con số từ trí nhớ, không cộng dồn, không suy từ mức trần (ví dụ không ghi "tới 5% doanh thu" cho lỗi không phải chuyển dữ liệu xuyên biên giới). Không viết "sẽ bị đình chỉ/tạm dừng hoạt động" nếu checklist không dẫn căn cứ cụ thể. 8. Chỉ báo cáo những gì nằm trong phạm vi các checklist. Vấn đề ngoài phạm vi (bản quyền hình ảnh, file LICENSE, lỗi bảo mật code, thuế...) nếu thấy thì ghi một dòng "ngoài phạm vi, nên kiểm tra riêng", không xếp mức 🔴 và không gán điều luật hay mức phạt. Chỉ dùng thang 🔴🟡🟢⚪, không tự đặt nhãn khác (P0, Critical...). ## Quy trình 1. **Luôn bắt đầu bằng `references/00-triage.md`**: phân loại mức độ phức tạp (tĩnh/thu thập nhẹ/bán hàng/nền tảng quy mô) trước khi mở checklist nào. Chạy `bash scripts/scan.sh <thư-mục-code>`, hoặc `bash scripts/scan.sh <URL>` nếu chỉ có địa chỉ website, để quét tự động, rồi xem lại bằng chứng script in ra. Site tĩnh không form, không script theo dõi, không bán hàng thì KHÔNG audit đủ bộ checklist. 2. Theo bảng phân loại ở bước 1, chỉ mở checklist thực sự áp dụng tại `references/`: 01-personal-data-protection, 02-ecommerce, 03-cybersecurity, 04-consumer-protection, 05-advertising, 06-electronic-transactions, 07-ai-transparency (luôn thêm nếu có chatbot/nội dung AI), 08-penalties-reference, 09-mobile-app (luôn thêm nếu là mobile app), 10-generate-policy (khi người dùng yêu cầu soạn chính sách bảo mật/form đồng ý). 3. Đọc code/nội dung website thực tế (footer, trang chính sách, cookie banner, form thu thập dữ liệu) để xác định trạng thái. Chưa kiểm tra thì không suy đoán. 4. Xuất báo cáo theo mẫu `examples/sample-audit-report.md`. Với site mức 0-1, dùng bản rút gọn, không liệt kê các checklist không áp dụng thành bảng dài. Mỗi mục 🔴 kèm một "Prompt sửa" ngắn trong khối code để người dùng copy dán vào công cụ vibe code: lấy từ mục "Prompt sửa nhanh theo từng lỗi 🔴" trong `examples/vibe-coder-prompts.md` nếu cùng loại lỗi, điền file:dòng thật; lỗi khác thì viết theo cùng kiểu. 5. Mở đầu báo cáo bằng dòng "🤖 Báo cáo do AI tạo..." theo `examples/sample-audit-report.md`, và đóng báo cáo bằng phần "Giới hạn & Khuyến nghị" (xem `DISCLAIMER.md`). 6. Site thu thập dữ liệu mà thiếu chính sách hoặc xin đồng ý sai: cuối báo cáo gợi ý người dùng có thể bảo "soạn chính sách bảo mật cho dự án này". Khi được yêu cầu, làm theo `references/10-generate-policy.md` với khung `examples/privacy-policy-template.md`. Nguồn pháp luật đầy đủ: `sources/legal-references.md`.
© mhfed · MIT · mhfed/vn-law-check