Skip to content
Back to search

vietnamese-language-skill

Agent Skills that make Claude write Vietnamese a Vietnamese professional would actually ship.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/trussary--vietnamese-language-skill/badge.svg)](/listings/trussary--vietnamese-language-skill)

HTML

<a href="/listings/trussary--vietnamese-language-skill"><img src="/api/listings/trussary--vietnamese-language-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

`npx skills` (any agent)

The [`skills`](https://www.npmjs.com/package/skills) CLI installs into Claude Code, Cursor, and other agents from one command — no plugin system needed:

npx skills add trussary/vietnamese-language-skill

Useful flags:

npx skills add trussary/vietnamese-language-skill --list       # see what is in the repo first
npx skills add trussary/vietnamese-language-skill -g           # install globally, not per-project
npx skills add trussary/vietnamese-language-skill -a '*' --all # every agent, no prompts

Then `npx skills list` to confirm, `npx skills update` to pull newer versions, and `npx skills remove vietnamese-landing-copy` to uninstall.

To try one skill in a single session without installing anything:

npx skills use trussary/vietnamese-language-skill@vietnamese-landing-copy
npx skills use trussary/vietnamese-language-skill@vietnamese-tech-writing
npx skills use trussary/vietnamese-language-skill@vietnamese-business-comms
npx skills use trussary/vietnamese-language-skill@vietnamese-finance-copy
npx skills use trussary/vietnamese-language-skill@vietnamese-education-copy

Claude Code plugin

/plugin marketplace add trussary/vietnamese-language-skill

Then install the `vietnamese-language-skill` plugin from the marketplace. Each skill appears prefixed with the plugin name — `vietnamese-language-skill:vietnamese-landing-copy`, and so on.

Plain skill folder

Copy the skills you want into your personal or project skills directory. Each folder is self-contained — there is nothing to copy alongside it:

cp -r skills/vietnamese-landing-copy ~/.claude/skills/
cp -r skills/vietnamese-tech-writing ~/.claude/skills/

Use `.claude/skills/` inside a repo instead if you want it scoped to one project.

Claude.ai / Claude Cowork

Zip a skill folder and upload it in skill settings:

cd skills && zip -r vietnamese-landing-copy.zip vietnamese-landing-copy

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 40 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "vietnamese-language-skill",
  3. "owner": {
  4. "name": "trussary",
  5. "url": "https://github.com/trussary"
  6. },
  7. "metadata": {
  8. "description": "Vietnamese (vi-VN) language Agent Skills for Claude Code: landing pages, engineering and product docs, marketing and sales, regulated finance copy, and school and academic writing.",
  9. "version": "2.1.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "vietnamese-language-skill",
  14. "source": "./",
  15. "description": "Five Vietnamese writing skills that share one linter: native-quality landing-page copy, engineering and product documentation, marketing and sales communications, regulated finance content, and school and academic writing. Register and pronoun selection, code-switching, locale formatting, advertising and financial-promotion law, MoET statutory grading terms, and a dependency-free validator.",
  16. "version": "2.1.0",
  17. "author": {
  18. "name": "vietnamese-language-skill contributors"
  19. },
  20. "homepage": "https://github.com/trussary/vietnamese-language-skill",
  21. "license": "MIT",
  22. "category": "writing",
  23. "keywords": [
  24. "vietnamese",
  25. "vi-VN",
  26. "localization",
  27. "i18n",
  28. "copywriting",
  29. "landing-page",
  30. "technical-writing",
  31. "marketing",
  32. "sales",
  33. "finance",
  34. "education",
  35. "compliance",
  36. "linter"
  37. ]
  38. }
  39. ]
  40. }
README.md · README · 297 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # vietnamese-language-skill
  2. *[Tiếng Việt](README.vi.md)*
  3. Agent Skills that make Claude write Vietnamese a Vietnamese professional would actually ship.
  4. Vietnamese is a low-resource language for LLMs. Unguided, the output is fluent-sounding
  5. translationese: English word order in Vietnamese words, the wrong pronoun for the audience,
  6. CTAs translated literally, advertising superlatives that are **illegal under Vietnamese law**,
  7. and currency formatted the American way.
  8. The left column is not a strawman. It is what you get by default — one example per skill:
  9. `vietnamese-landing-copy`
  10. ```diff
  11. - Học thêm về dự án của chúng tôi
  12. + Tìm hiểu thêm về dự án
  13. - Chúng tôi cung cấp những căn hộ tốt nhất số 1 thị trường
  14. + Không gian sống đẳng cấp giữa lòng thành phố
  15. - Giá: 2,500,000,000 VND
  16. + Giá chỉ từ 2,5 tỷ đồng
  17. ```
  18. `vietnamese-tech-writing`
  19. ```diff
  20. - cam kết các thay đổi
  21. + commit các thay đổi
  22. - triển khai đến sản xuất
  23. + deploy lên production
  24. - Bạn sẽ thử lại request khi gặp lỗi.
  25. + Hệ thống sẽ tự động retry request khi gặp lỗi.
  26. ```
  27. `vietnamese-business-comms`
  28. ```diff
  29. - Cà phê số 1 Việt Nam
  30. + Cà phê được hơn 10.000 khách hàng lựa chọn mỗi ngày
  31. - Học thêm
  32. + Xem ngay
  33. - Đơn hàng đã xác nhận. Ưu đãi giảm 50% hôm nay, đặt ngay!
  34. + Đơn hàng của Quý khách đã được xác nhận. Dự kiến giao trước 20/08.
  35. ```
  36. `vietnamese-finance-copy`
  37. ```diff
  38. - Cam kết lợi nhuận 12%/năm cho nhà đầu tư
  39. + Lợi nhuận kỳ vọng 12%/năm. Đầu tư có rủi ro; kết quả trong quá khứ không đảm bảo kết quả trong tương lai.
  40. - Trả góp lãi suất 0% cho mọi đơn hàng
  41. + Trả góp lãi suất 0% — phí chuyển đổi 3%/khoản. Tổng chi phí phải trả: 10.300.000 ₫.
  42. - Bảng cân đối kế toán tại ngày 31/12/2026
  43. + Báo cáo tình hình tài chính tại ngày 31/12/2026
  44. ```
  45. `vietnamese-education-copy`
  46. ```diff
  47. - Học sinh đạt loại Giỏi trong học kỳ này.
  48. + Học sinh đạt mức Tốt trong học kỳ này.
  49. - Bạn cần hoàn thành bài tập trước giờ học ngày mai.
  50. + Em cần hoàn thành bài tập trước giờ học ngày mai.
  51. - Sai rồi! Điểm phát âm của bạn là 30%.
  52. + Em phát âm âm đầu rất tốt! Ở chữ "nghĩ", em thử kéo dài giọng ở giữa một chút và hạ giọng trước khi lên cao nhé.
  53. - GPA của sinh viên là 3.6/4.0.
  54. + Điểm trung bình tích lũy của sinh viên là 3,6/4,0.
  55. ```
  56. ## What is in here
  57. | Skill | What it does |
  58. |---|---|
  59. | [`vietnamese-landing-copy`](skills/vietnamese-landing-copy/) | Landing-page copy — real-estate (bất động sản), SaaS, and e-commerce registers. Terminology glossary, conventional CTAs, section labels, lead-form legal copy. |
  60. | [`vietnamese-tech-writing`](skills/vietnamese-tech-writing/) | Engineering and product docs — commits, PRs, RFCs, postmortems, runbooks, READMEs, API docs, UI microcopy, i18n files, PRDs, release notes, surveys. Code-switching rules and vi-VN i18n hazards. |
  61. | [`vietnamese-business-comms`](skills/vietnamese-business-comms/) | Marketing and sales — email campaigns, Zalo ZNS/ZBS, ads, marketplace listings, press releases, cold outreach, báo giá, dunning, Tết greetings. B2B xưng hô and promotion law. |
  62. | [`vietnamese-finance-copy`](skills/vietnamese-finance-copy/) | Regulated finance — hóa đơn điện tử, báo cáo tài chính, investor updates, fintech and insurance copy, credit disclosures. Thông tư 99/2025 terminology and financial-promotion limits. |
  63. | [`vietnamese-education-copy`](skills/vietnamese-education-copy/) | School, academic, and EdTech writing — K-12 report-card remarks, sổ liên lạc and parent notices, pedagogical nudges, diagnostic pronunciation feedback (Sandwich model), adaptive assessment, university syllabi, transcripts, and diploma reissuance. MoET statutory grading terms, learning science frameworks, and child data protection (Nghị định 13/2023). |
  64. They share one validator engine and four references (register matrix, Unicode and tone marks,
  65. locale formatting, compliance), which live in [`shared/`](shared/) and are copied into each
  66. skill by a build step — every skill folder stays independently installable.
  67. ## Install
  68. ### `npx skills` (any agent)
  69. The [`skills`](https://www.npmjs.com/package/skills) CLI installs into Claude Code, Cursor,
  70. and other agents from one command — no plugin system needed:
  71. ```bash
  72. npx skills add trussary/vietnamese-language-skill
  73. ```
  74. Useful flags:
  75. ```bash
  76. npx skills add trussary/vietnamese-language-skill --list # see what is in the repo first
  77. npx skills add trussary/vietnamese-language-skill -g # install globally, not per-project
  78. npx skills add trussary/vietnamese-language-skill -a '*' --all # every agent, no prompts
  79. ```
  80. Then `npx skills list` to confirm, `npx skills update` to pull newer versions, and
  81. `npx skills remove vietnamese-landing-copy` to uninstall.
  82. To try one skill in a single session without installing anything:
  83. ```bash
  84. npx skills use trussary/vietnamese-language-skill@vietnamese-landing-copy
  85. npx skills use trussary/vietnamese-language-skill@vietnamese-tech-writing
  86. npx skills use trussary/vietnamese-language-skill@vietnamese-business-comms
  87. npx skills use trussary/vietnamese-language-skill@vietnamese-finance-copy
  88. npx skills use trussary/vietnamese-language-skill@vietnamese-education-copy
  89. ```
  90. ### Claude Code plugin
  91. ```bash
  92. /plugin marketplace add trussary/vietnamese-language-skill
  93. ```
  94. Then install the `vietnamese-language-skill` plugin from the marketplace. Each skill appears
  95. prefixed with the plugin name — `vietnamese-language-skill:vietnamese-landing-copy`, and so on.
  96. ### Plain skill folder
  97. Copy the skills you want into your personal or project skills directory. Each folder is
  98. self-contained — there is nothing to copy alongside it:
  99. ```bash
  100. cp -r skills/vietnamese-landing-copy ~/.claude/skills/
  101. cp -r skills/vietnamese-tech-writing ~/.claude/skills/
  102. ```
  103. Use `.claude/skills/` inside a repo instead if you want it scoped to one project.
  104. ### Claude.ai / Claude Cowork
  105. Zip a skill folder and upload it in skill settings:
  106. ```bash
  107. cd skills && zip -r vietnamese-landing-copy.zip vietnamese-landing-copy
  108. ```
  109. ## Use it
  110. Once installed, they trigger on their own. Ask for Vietnamese writing in the normal way, and
  111. the keywords route to the right skill:
  112. > Viết landing page cho dự án căn hộ cao cấp tại Quận 7
  113. > Our Vietnamese README reads like Google Translate — should we translate "deploy"?
  114. > Viết email chào hàng gửi khách doanh nghiệp, kèm báo giá có VAT
  115. > Can we advertise a guaranteed 12% annual return in Vietnam?
  116. > Viết nhận xét học bạ cho học sinh lớp 9 môn Toán
  117. Each skill's linter runs directly too, with no Claude involved:
  118. ```bash
  119. python skills/vietnamese-landing-copy/scripts/validate_copy.py copy.md --register re
  120. python skills/vietnamese-tech-writing/scripts/validate_copy.py CHANGELOG.md --doctype commit
  121. python skills/vietnamese-business-comms/scripts/validate_copy.py email.md --doctype cold-outreach
  122. python skills/vietnamese-finance-copy/scripts/validate_copy.py bctc.md --doctype statement
  123. python skills/vietnamese-education-copy/scripts/validate_copy.py hoc-ba.md --doctype secondary-report-card
  124. ```
  125. ```text
  126. copy.md:3:1: error CAL001 calque "Học thêm"
  127. → use "Tìm hiểu thêm / Xem thêm" (glossary.md)
  128. copy.md:7:12: warn LAW001 regulated superlative "số 1"
  129. → needs a licensed market survey or award certificate; annotate with
  130. <!-- proof: ... --> or rewrite as a countable fact
  131. copy.md:11:8: error NUM001 comma-grouped number "2,500,000"
  132. → write "2.500.000"
  133. ```
  134. Python 3.9+, standard library only. No install step.
  135. ## What the linter checks
  136. | Rule | Catches |
  137. |---|---|
  138. | `NFC001` | Decomposed Unicode that breaks web-font rendering |
  139. | `CAL001` | English calques, from the glossary blocklist |
  140. | `LAW001` | Regulated superlatives (Luật Quảng cáo Điều 8 khoản 11) — warns, never blocks |
  141. | `DIA001` | Vietnamese written without diacritics |
  142. | `TONE001` | Both tone-mark conventions mixed in one document |
  143. | `NUM001`–`NUM004` | Comma thousands separators, ungrouped amounts, period decimals, ASCII `m2` |
  144. | `DATE001` | `MM/dd/yyyy` where Vietnamese uses `dd/MM/yyyy` |
  145. | `PHONE001` | Trunk zero kept after `+84` |
  146. | `ICU001` | Any non-`other` ICU plural branch — Vietnamese has only `other` |
  147. | `PRO001`/`PRO002` | Mixed register, or a pronoun that does not fit the declared one |
  148. Each skill adds its own rules on top. Run `--list-rules` against a skill's validator to see
  149. everything it can emit:
  150. | Skill | Adds |
  151. |---|---|
  152. | `vietnamese-tech-writing` | `ENG001` non-ASCII commit subject, branch or identifier · `ENG003` direct address in an RFC or postmortem · `ENG007` hedged runbook step · `PROD002` agree/disagree survey scale · `PROD003` app-store metadata over the platform limit · `PROD004` consent copy with no purpose |
  153. | `vietnamese-business-comms` | `ZNS001` marketing in a transactional Zalo template · `ZNS002` template over 400 characters · `MKT001` ALL-CAPS or emoji in a marketplace title · `MKT002` discount over the 50% ceiling · `SALES001` casual pronoun in B2B · `SALES003` outreach with no greeting · `SALES004` quote missing VAT or validity · `SPAM001` bulk message with no opt-out |
  154. | `vietnamese-finance-copy` | `FIN001` guaranteed-return language · `FIN002` promotional rate with no total-cost disclosure · `FIN005` statement table with no `Đơn vị tính` · `FIN006` minus-signed negative · `FIN007` invoice missing `MST` or `thuế GTGT` |
  155. | `vietnamese-education-copy` | `EDU001` abolished secondary grading term · `EDU002` `bạn` addressing a student · `EDU003` primary report-card calque for `cần cố gắng` · `EDU005` `tín dụng` for academic credit · `EDU006` GPA with a dot decimal · `EDU007` literal empty-state phrase on UI · `EDU009` harsh/unpedagogical pronunciation feedback |
  156. **Rules that only make sense for one kind of document are gated behind `--doctype` and stay
  157. silent without it.** A 400-character limit is right for a Zalo template and nonsense for a
  158. design doc. The one exception is `FIN001`: guaranteed-return language is prohibited wherever
  159. it appears, so it is never gated.
  160. Suppress a rule where it is genuinely wrong:
  161. ```markdown
  162. <!-- vlc-disable: TONE001 --> file-level
  163. Text here <!-- vlc-disable-line NUM001 -->
  164. Thương hiệu số 1 <!-- proof: Khảo sát Nielsen VN 2026 -->
  165. Giảm đến 90% <!-- khuyen-mai-tap-trung: QĐ 123/SCT ngày 01/06/2026 -->
  166. ```
  167. Directives work in HTML, `//`, `/* */`, `#`, and JSON string values. The `proof` and
  168. `khuyen-mai-tap-trung` annotations record that paperwork exists; they do not create it, and a
  169. reviewer is expected to check.
  170. ## Design notes
  171. Five decisions worth knowing before you contribute:
  172. 1. **The rule data lives in Markdown, not Python.** `validate_copy.py` parses the tables in
  173. `references/glossary.md`, `references/banned-phrases.md` and `references/register-matrix.md`
  174. at runtime. Adding a lint rule, or a whole register, is adding a table row — no code change,
  175. no test change. Rules that genuinely need logic go in a skill's own `scripts/rules_*.py`,
  176. which the engine imports automatically.
  177. 2. **Superlatives warn, they never block.** The law does not ban `số 1`; it bans `số 1`
  178. *without proof*. A linter that hard-blocks a legitimate proven claim gets disabled
  179. wholesale, which helps nobody. `FIN001` warns for a different reason: the guaranteed-return
  180. prohibition is assembled from three instruments rather than stated in one, so a warning that
  181. routes to a lawyer is the honest output.
  182. 3. **Tone-mark style is not a correctness question.** `hòa` (kiểu cũ) and `hoà` (kiểu mới) are
  183. both right. The skills default to kiểu mới and only ever flag *mixing* the two.
  184. 4. **Doctype gating is what keeps the linter switched on.** A rule that fires on documents it
  185. was never meant for gets the whole tool disabled, so structural rules stay silent until the
  186. caller declares what the artifact is.
  187. 5. **Shared files are generated, not symlinked.** `npx skills use`, the Claude.ai zip upload,
  188. and a plain `cp -r` each install exactly one folder, so every skill carries real copies of
  189. the shared references and engine. `tools/sync_shared.py` writes them and CI fails if a copy
  190. has drifted — edit `shared/`, never the copy.
  191. ## Contributing
  192. The most valuable contributions here are **linguistic, not code**: a glossary row, a bad→good
  193. example pair, a register profile for a vertical we do not cover. See
  194. [CONTRIBUTING.md](CONTRIBUTING.md).
  195. A native Vietnamese speaker must approve any change to the glossary or the examples corpus.
  196. ```bash
  197. python -m pytest tests/ -q # 500+ assertions, mostly the eval corpora
  198. python tools/build_examples.py # regenerate examples.md from evals/<skill>/pairs.jsonl
  199. python tools/sync_shared.py # copy shared/ into every skill
  200. ```
  201. The finance skill has a higher bar: statement terminology needs an accountant, and anything
  202. solifying investment, describing insurance, or presenting a credit rate needs a lawyer.
  203. ## Background
  204. [`research/research.md`](research/research.md) is the original design rationale: the documented
  205. failure modes, the native conventions that fix them, the legal citations, and the Agent Skill
  206. spec this repo is built to.
  207. [`research/exnpansion-research.md`](research/exnpansion-research.md) is the research behind the
  208. three newer skills — genre inventories, register deltas, regulated-language tables, and an
  209. explicit list of what could not be verified.
  210. [`research/expansion-plan.md`](research/expansion-plan.md) is how that research was turned into
  211. the current layout, including why the build order was inverted.
  212. [`research/education-research`](research/education-research) and [`research/edtech-research.md`](research/edtech-research.md) are the research behind
  213. `vietnamese-education-copy` — K-12 and higher-education writing, MoET statutory grading frameworks,
  214. and EdTech learning science (IRT/CAT, GOP speech scoring, SDT motivation, and Decree 13/2023 child data protection).
  215. ## Licence
  216. MIT — see [LICENSE](LICENSE). Legal references are provided for copywriting guidance and are
  217. not legal advice.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.