Style guide vi

Skill longhang2004/vietnamese-humanizer/skills/style-guide-vi

Agent Skills and lightweight tools for clearer, more natural Vietnamese writing, translation cleanup, grammar checks, and style consistency.

Install

npx -y skills add longhang2004/vietnamese-humanizer --skill style-guide-vi

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

16 days oldThe repository was created 16 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.

What its author says it does

Copied from the file, not written here

Kiểm tra và áp dụng nhất quán style guide tiếng Việt cho xưng hô, thuật ngữ, viết hoa, số, ngày giờ, đơn vị, heading, bullet và code. Dùng khi chuẩn hóa một hoặc nhiều tài liệu; không dùng để thay thế grammar review, áp quy tắc mặc định lên style guide riêng, hay đổi tên sản phẩm và nội dung được trích nguyên văn.

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

3.6 KB, as published. Nobody here has run it

Style guide tiếng Việt

Quy tắc của người dùng hoặc tổ chức luôn ưu tiên. Mặc định của skill chỉ dùng khi chưa có hướng dẫn và phải được áp dụng nhất quán, không hồi tố tùy tiện lên trích dẫn hoặc tên riêng.

Quy trình

Tìm style guide, glossary, tài liệu chuẩn hoặc ví dụ đã được duyệt. Ghi rõ nguồn quy tắc.
Lập bảng quyết định cho xưng hô, thuật ngữ, tên sản phẩm, viết hoa, số, ngày giờ, tiền tệ, đơn vị, dấu câu và định dạng.
Xác định phạm vi ngoại lệ: code, URL, identifier, tên thương hiệu, trích dẫn, dữ liệu nhập từ hệ thống khác.
Quét theo từng nhóm thay vì sửa ngẫu nhiên. Ghi lại biến thể và tần suất trước khi chọn dạng chuẩn.
Nếu không có style riêng, dùng defaults trong references và nói rõ đó là mặc định của dự án.
Rà chéo để một sửa đổi không tạo mâu thuẫn mới, chẳng hạn đổi xưng hô nhưng bỏ sót động từ lịch sự.
Xuất bản sạch hoặc báo cáo thay đổi theo yêu cầu.

Đọc terminology trước khi chuẩn hóa thuật ngữ hàng loạt và formatting cho Markdown.

Bảo toàn

Giữ dữ kiện, số trị, đơn vị, tên riêng, tên sản phẩm, trademark, code, URL, identifier và trích dẫn. Chuẩn hóa cách biểu diễn không được đổi giá trị: 1,5 và 1.5 chỉ đổi khi đã xác định quy ước thập phân; múi giờ phải được giữ.

Khi hai quy tắc xung đột, thứ tự ưu tiên là yêu cầu trực tiếp của người dùng, style guide dự án, glossary được duyệt, quy ước domain, rồi mới đến default của skill.

Nhóm quy tắc

Pronouns: quan hệ với độc giả và tính nhất quán.
Capitalization: tên riêng, heading, tên tính năng.
Numbers, dates, units: số, phần trăm, tiền tệ, giờ và múi giờ.
Terminology: glossary, tiếng Anh và từ viết tắt.
Formatting: heading, bullet, nhấn mạnh và code.

Anti-goals

Không áp default khi đã có style guide riêng.
Không sửa trích dẫn, code, URL, path hoặc identifier.
Không đổi số trị hay múi giờ trong lúc chuẩn hóa định dạng.
Không coi khác biệt vùng miền là lỗi.
Không đổi tên thương hiệu theo quy tắc viết hoa phổ thông.
Không biến consistency review thành viết lại giọng tác giả.
Không suy đoán văn bản do AI tạo hoặc tối ưu cho detector.

Đầu ra

Với tài liệu ngắn, trả bản đã chuẩn hóa và ghi vài quyết định quan trọng. Với corpus nhiều file, trả bảng quy tắc đã dùng, danh sách ngoại lệ và các chỗ cần chủ sở hữu quyết định. Xem examples.