claudeers.
// Claude Skills

design-os-vietnamese

Free, offline Vietnamese copy linter plus 16 agent skills for Claude Code, Codex, Gemini CLI and Antigravity. Flags calques, US-style dates and numbers, unpr…

// Claude Skills[ cli ][ api ][ mobile ][ claude ]#claude#ai-agents#claude-code#claude-skills#codex#copywriting#design-system#i18n#skills◷ NOASSERTION$open-sourceupdated 19 days ago
Actively maintained
100/100
last commit 8 days ago
last release 23 days ago
releases 4
open issues 0

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up design-os-vietnamese (claude-plugin project) into my current project.
Found on https://claudeers.com/design-os-vietnamese
Repo: https://github.com/jangtrinh/design-os-vietnamese
Homepage/docs: https://jangtrinh.github.io/design-os-vietnamese/
Detected install method: claude-plugin → /plugin install design-os-vietnamese@jangtrinh/design-os-vietnamese
Category: skills. Platforms: cli, api, mobile.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or install directly (claude-plugin)
/plugin marketplace add jangtrinh/design-os-vietnamese
/plugin install design-os-vietnamese@jangtrinh/design-os-vietnamese
// or clone
git clone https://github.com/jangtrinh/design-os-vietnamese

// compatibility

Platformscli, api, mobile
Operating systems—
AI compatibilityclaude
LicenseNOASSERTION
Pricingopen-source
LanguagePython

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

DESIGN:OS Vietnamese (design-os-vietnamese) — v5.2 Multi-Industry Suite

Sovereign Vietnamese (vi-VN) language, typography, UX design system, 7-tier pedagogy (Mầm non -> Tiến sĩ & GS/PGS), and 16-domain statutory compliance suite for AI coding agents.

Equip Claude Code, OpenAI Codex, Gemini CLI, and Google Antigravity with 16 production skills, 31 audience registers, 100+ deterministic AST/regex rules, 489 golden evaluation pairs, and 18 UKMC.v1 cryptographically verified knowledge modules.

DESIGN:OS Vietnamese v5.2 Multi-Industry Architecture and 16-Skill Matrix

Quickstart · What it makes · Install · How it works · Limits · Tiếng Việt


Why this exists

Generic LLMs treat Vietnamese (vi-VN) as word-by-word translated English. In production software and regulated industries, that produces four systemic failure modes:

  1. Translationese & Syntactic Calques: Literal English-to-Vietnamese phrasing ("Làm ơn nhập của bạn mật khẩu", "Như một người dùng, tôi muốn...", "Thực hiện một quyết định") that breaks native trust.
  2. Stacked Diacritic Clipping & UI Expansion: Vietnamese combines base vowels with circumflex/breve/horn modifiers (ă, â, ê, ô, ơ, ư) and five tone marks (Ấ, Ệ, Ữ, Ợ), increasing vertical glyph bounds by 25–35% and expanding string length by 22–38% over English.
  3. Encoding & ICU Localization Bugs: Decomposed Unicode NFD from macOS clipboard/filesystems breaks search and regex; one/other ICU plural branches fail because Vietnamese uses only other (CLDR).
  4. Statutory & Multi-Industry Regulatory Violations: Unsubstantiated superlatives (Luật số 75/2025/QH15), conflated educational grading scales across the 7-Tier Pedagogy Continuum (VBHN 01/VBHN-BGDĐT, TT 27/2020, TT 22/2021, TT 04/2022, TT 08/2021, TT 23/2021, TT 18/2021, QĐ 37/2018/QĐ-TTg), missing TPCN disclaimers (NĐ 15/2018/NĐ-CP), commercial penalty caps over 8% (Luật Thương mại 2005 Điều 301), opaque hotel ++ pricing (Luật Du lịch 2017 Điều 50), and discriminatory JDs or sub-85% probation wages (Bộ luật Lao động 2019 Điều 8, Điều 26).
DimensionGeneric LLM / Unverified PromptingDESIGN:OS Vietnamese (design-os-vietnamese)
Linguistic & Tone EngineLiteral calques, mixed tone styles (hoà vs hòa), decomposed NFD bugsDeterministic validate_copy.py linter (NFC001, CAL001, SYN001, TONE001)
UI/UX & i18n EngineeringClipped stacked diacritics and broken one/other ICU pluralsStacked-diacritic line-height tokens, U+00A0 binding, check_i18n_parity.py & check_font_coverage.py
Pedagogy ContinuumConfuses K-12 rankings, undergraduate theses, and doctoral dissertationsFull 7-Tier MOET & VQF Continuum (Preschool Mầm non -> Doctoral Tiến sĩ & GS/PGS, EDU001–EDU012)
Multi-Industry ComplianceHallucinates repealed circulars (TT 200, BLLĐ 2012, BLDS 2005, DVC mức độ 4)16 domain rule engines (UX, LND, TECH, BIZ, FIN, EDU, MED, LEG, HOS, HR, REA, ECOM, GOV, INS, SEC, MEDJ)
Epistemic ProvenanceUnverifiable prose summaries with zero source hashes18 UKMC.v1 modules with 65+ SHA-256 anchors (STOP_SUFFICIENT) & PRIVACY.md zero telemetry

Quickstart

1. Clone and run the deterministic verification suite

git clone https://github.com/jangtrinh/design-os-vietnamese
cd design-os-vietnamese
python3 -m unittest discover -s tests -v
python3 scripts/self_check.py && python3 tools/verify_ukmc.py

2. Validate Vietnamese copy, i18n catalogs, and font coverage

# Validate a Vietnamese UI or Markdown file with domain & register rules
python3 shared/scripts/validate_copy.py path/to/copy.md --domain ux --register ux-microcopy

# Auto-fix decomposed NFD Unicode and normalize tone marks to kiểu mới (hoà, thuỷ)
python3 shared/scripts/validate_copy.py path/to/copy.md --fix --fix-tone new --output path/to/copy.clean.md

# Audit en.json <-> vi.json key parity, ICU plurals, and UI expansion caps
python3 shared/scripts/check_i18n_parity.py \
  --source skills/vn-design-system-ux/assets/en.sample.json \
  --target skills/vn-design-system-ux/assets/vi.sample.json \
  --json

3. Install the commands (pip / uvx) and add the pre-commit hooks

The three checkers are also installable. Runtime stays standard-library only; the commands take the same flags and return the same exit codes as the scripts above.

CommandWraps
vi-validate-copyshared/scripts/validate_copy.py
vi-i18n-parityshared/scripts/check_i18n_parity.py
vi-font-coverageshared/scripts/check_font_coverage.py
pip install git+https://github.com/jangtrinh/design-os-vietnamese
vi-validate-copy path/to/copy.md --domain finance --strict

# or run once without installing
uvx --from git+https://github.com/jangtrinh/design-os-vietnamese vi-validate-copy path/to/copy.md --domain all

Use the same checks as pre-commit hooks in your own repository (.pre-commit-config.yaml). pre-commit builds the hook environment for you, so nothing needs to be installed by hand:

repos:
  - repo: https://github.com/jangtrinh/design-os-vietnamese
    rev: v5.2.0
    hooks:
      - id: validate-copy
        args: [--domain, ux, --register, ux-microcopy]
      - id: check-i18n-parity
        files: ^locales/(en|vi)\.json$
        pass_filenames: false
        args: [locales/en.json, locales/vi.json]
      - id: check-font-coverage

check-i18n-parity needs the source catalog first and the target second, but pre-commit passes only the staged files in path order, so files: is just the trigger and args: names the pair explicitly (source first, e.g. values/strings.xml before values-vi/strings.xml for Android). Hook ids are validate-copy, check-i18n-parity and check-font-coverage.


What it makes

Every deliverable generated or audited by design-os-vietnamese is backed by a deterministic Python 3.9+ standard-library linter and 489 golden evaluation pairs (evals/*/pairs.jsonl).

#SkillDomain & Target ArtifactsDomain Rule EngineKey Reference Modules
1vn-design-system-uxDesign Tokens, Typography, UI Microcopy & i18n: line-height gates, character caps, empty/loading/error states, passkeys, AI streaming UX, U+00A0 compound-word bindingrules_ux.py (UX001–UX007)design-tokens-vi.md, microcopy-states.md, glossary.md, banned-phrases.md
2vietnamese-landing-copyLanding Pages, SaaS, E-Commerce & Real Estate: Hero formulas, value props, pricing tables, CTAs, Luật Quảng cáo 75/2025 & NĐ 98/2020 compliancerules_landing.py (LND001–LND004)vertical-playbooks.md, legal-copy.md, register-guide.md, examples.md
3vietnamese-tech-writingDeveloper Docs, API Specs, Runbooks, Changelogs, ADRs & Surveys: Code-switching rules, CLI/SDK docs, postmortems, Likert scalesrules_tech.py (ENG001–ENG008, PROD002–PROD004)code-switching.md, i18n-hazards.md, survey-design.md, doc-registers.md
4vietnamese-business-commsB2B Emails, Zalo OA/ZNS, Proposals & Administrative Công văn: Nghị định 30/2020/NĐ-CP format, Nghị định 13/2023/NĐ-CP PDPD consentrules_business.py (ADMIN001, ZNS001–ZNS002, SALES001–SALES004, MKT001–MKT003, SPAM001)admin-decree-30.md, b2b-xung-ho.md, channel-guide.md, promo-law.md
5vietnamese-finance-copyFintech, Banking, Tax, Invoices & Financial Reports: Thông tư 99/2025/TT-BTC (replacing TT 200), Nghị định 70/2025/NĐ-CP e-invoices, VietQR/Napasrules_finance.py (FIN001–FIN009)fintech-ekyc-vietqr.md, statement-formatting.md, statement-terminology.md, financial-promotion.md
6vietnamese-education-copyFull 7-Tier Pedagogy Continuum (Mầm non -> Tiểu học -> THCS/THPT -> GDNN -> Đại học -> Thạc sĩ -> Tiến sĩ & GS/PGS): VBHN 01, TT 27/2020, TT 22/2021, TT 04/2022, TT 08/2021, TT 23/2021, TT 18/2021, QĐ 37/2018rules_education.py (EDU001–EDU012)preschool-to-postgrad-continuum.md, grading-terminology.md, edtech-pedagogy.md, doc-registers.md
7vietnamese-healthcare-copyClinical EMR, E-Prescriptions, Hospital Discharge & Pharma/TPCN Compliance: Luật KCB 15/2023/QH15, TT 32/2023/TT-BYT, NĐ 15/2018/NĐ-CPrules_healthcare.py (MED001–MED007)clinical-and-emr-writing.md, pharma-and-tpcn-compliance.md, patient-communication.md, qa-checklist.md
8vietnamese-legal-contractsCivil, Commercial & Labor Contracts, NDAs, Terms of Service & Privacy Notices: BLDS 2015, Luật Thương mại 2005 (8% penalty cap), Luật BVQLNTD 2023rules_legal.py (LEG001–LEG007)contract-drafting-blds-ltt.md, labor-and-ip-clauses.md, pdpd-and-consumer-protection.md
9vietnamese-hospitality-travel5-Star Hotels, Resorts, Aviation, OTA Booking & Culinary/F&B: Luật Du lịch 2017 (Điều 50), transparent ++ pricing, TT 14/2015 & 19/2023 aviation rightsrules_hospitality.py (HOS001–HOS006)hotel-and-resort-standards.md, aviation-and-tour-policies.md, fnb-and-culinary-copy.md
10vietnamese-hr-recruitmentJob Descriptions (JD), Offer Letters, Labor Contracts, Probation & BHXH/PIT: Bộ luật Lao động 2019 (Điều 8, 17, 20, 25, 26), Luật BHXH 41/2024/QH15rules_hr.py (HR001–HR006)labor-code-and-offer-letters.md, jd-and-employer-branding.md, okr-kpi-and-performance-review.md
11vietnamese-real-estate-constructionReal Estate, Property Development & Construction BOQ: Luật KDBĐS 2023 (<=5% deposit cap Art. 23, 30%/70%/95% off-plan schedule Art. 25), Luật Đất đai 2024, Luật Nhà ở 2023 (thông thủy & 2% maintenance fund)rules_realestate.py (REA001–REA006)luat-kinh-doanh-bds-2023.md, luat-dat-dai-2024-va-nha-o-2023.md, construction-boq-and-calques.md
12vietnamese-ecommerce-retailE-Commerce, Omnichannel Retail & Consumer Law: NĐ 52/2013 & 85/2021 (Đã thông báo vs Đã đăng ký Bộ Công Thương), NĐ 128/2024 (<=50% promo cap), Luật BVQLNTD 2023, NĐ 43/2017 & 111/2021 labelsrules_ecommerce.py (ECOM001–ECOM006)tmdt-nd52-nd85-va-bct.md, khuyen-mai-nd81-nd128-va-bvqlntd.md, ecommerce-logistics-and-calques.md
13vietnamese-government-public-serviceE-Government, Public Services (DVC) & VNeID: NĐ 42/2022 (DVC trực tuyến toàn trình / một phần), Luật Căn cước 2023 (Thẻ căn cước), NĐ 69/2024 (VNeID Mức độ 1 / 2), Luật Cư trú 2020 (no paper Sổ hộ khẩu)rules_gov.py (GOV001–GOV006)dvc-truc-tuyen-nd42-2022.md, luat-can-cuoc-2023-va-vneid-nd69.md, luat-cu-tru-bo-so-ho-khau-giay.md
14vietnamese-insurance-insurtechLife, Health, Motor Insurance & Bancassurance: Luật KDBH 2022 & TT 67/2023/TT-BTC (21-day free-look Art. 35, affirmative exclusion disclosure Art. 19, 15-day payout Art. 31, anti-deposit disguise)rules_insurance.py (INS001–INS006)luat-kinh-doanh-bao-hiem-2022.md, thong-tu-67-2023-bancassurance.md, insurance-terminology-and-calques.md
15vietnamese-cybersecurity-infosecCybersecurity, SOC Advisories, ATTT Level 1–5 & 72h Breach Notice: NĐ 13/2023/NĐ-CP Art. 23 (<=72h breach report to A05 Bộ Công an), NĐ 85/2016 & TT 12/2022 (ATTT Cấp độ 1–5), VNCERT/NCSC CVE alertsrules_cybersecurity.py (SEC001–SEC006)ung-cuu-su-co-pdpd-72h-a05.md, attt-cap-do-1-5-nd85-tt12.md, infosec-terminology-and-calques.md
16vietnamese-media-journalism-prPress Releases, Journalism Ethics, Corrections & Crisis PR: Luật Báo chí 2016 & NĐ 147/2024 (Press vs ICP), Art. 42 press corrections, presumption of innocence (nghi phạm / bị can / bị cáo), Luật Trẻ em 2016rules_media.py (MEDJ001–MEDJ006)luat-bao-chi-2016-va-nd147-2024.md, suy-doan-vo-toi-va-bao-ve-tre-em.md, press-release-and-crisis-pr.md

Deterministic Tooling & Static Linters

Every skill bundles three zero-dependency Python 3.9+ CLI tools synchronized from shared/scripts/:

Rule CodeSeverityCheck Description
NFC001ERRORDetects decomposed Unicode NFD combining marks (--fix auto-normalizes to NFC)
ENC001ERRORDetects UTF-8 Mojibake (á, ạ, ư, đ) and legacy VNI/TCVN3 corruption
CAL001ERROR/WARNFlags literal English-to-Vietnamese calques (làm ơn nhập của bạn mật khẩu, làm ơn + verb, verb + của bạn + noun, tiến hành đăng nhập, viết ra giấy, chạy trên 1 hệ thống, giết process, lần thử mù). Ambiguous words (có mặt, giữ vững, nằm trong, dòng chảy, không thương lượng, 7 trên 11) are flagged as WARN only in the abstract sense
SYN001WARNFlags syntactic translationese word order (như một..., tôi muốn, nó là quan trọng để, chỉ vì … nên là, bắt đầu bằng việc) and adversity passive bị paired with a positive outcome (bị hủy thành công, bị nâng cấp)
CAL002WARNHeuristic: a sentence that hangs two or more abstract nouns (đường đi, dòng chảy, danh tính, vị trí, tầng) on physical verbs (nằm, đứng, đặt, giữ, mang, đi) and names no concrete object. Expect some false positives; silence with <!-- vlc-disable: CAL002 -->
PLAIN001–PLAIN007WARN (ERROR with --context doc-for-executives)Plain-tone checks on prose files: sentences over 25 words, audit labels (FACT, INFERENCE, ASSUMPTION, UNKNOWN) left in prose, meta openers (Bản đánh giá này, Lưu ý:), filler (điều này, một cách, thực hiện, tiến hành), không chỉ … mà còn, dash asides and stacked parentheses. See Plain Vietnamese
LAW001ERRORFlags unsubstantiated superlatives (số 1, tốt nhất, duy nhất, 100%) unless backed by <!-- proof: ... --> or negated
DIA001ERRORDetects unaccented Vietnamese prose across 140+ multi-word phrases
TONE001WARNEnforces document-wide consistency between kiểu mới (hoà, thuỷ) and kiểu cũ (hòa, thủy) (--fix-tone new|old)
NUM001–NUM004ERROR/WARNPeriod thousands (1.250.000 ₫), comma decimals (3,5%), and superscript m²/m³ (with hardware chip guard for Apple M2/M3, SSD M.2, BMW M2/M3)
DATE001 / PHONE001ERRORFlags US MM/dd/yyyy dates and redundant trunk zero +84 (0)9...
ICU001 / ICU002ERRORMulti-line ICU plural block parser (other-only) and translated placeholder detector ({tên})
PRO001 / PRO002ERROR/WARNEnforces pronoun consistency across 31 audience registers (ux-microcopy, edu-preschool, edu-postgrad, healthcare-clinical, legal-contract, hospitality-luxury, hr-candidate, realestate-luxury, ecommerce-shopper, public-citizen, insurance-policyholder, infosec-advisory, crisis-comms, etc.)

Multi-Domain Composition, Cross-Platform Catalogs & Inline Directives (v5.1)

# Audit hybrid documents across multiple regulated domains simultaneously (or use --domain all)
python3 shared/scripts/validate_copy.py contract.md --domain finance,insurance,legal,cybersecurity --strict

# Pipe text directly via stdin (-)
echo "Giao dịch hoàn tất thành công." | python3 shared/scripts/validate_copy.py - --json

# Check Apple Xcode String Catalogs (.xcstrings), Android strings.xml, or nested JSON arrays
python3 shared/scripts/check_i18n_parity.py ios/Localizable.xcstrings --json
python3 shared/scripts/check_i18n_parity.py android/values/strings.xml android/values-vi/strings.xml --json

Inline suppression directives are supported for verified exceptions: <!-- vncopy-disable: LAW001 --> (file/block), <!-- vncopy-disable-line: LAW001 --> (specific rule on line), or <!-- vncopy-disable-line --> (all rules on line; vlc-disable alias also supported).

Plain tone (PLAIN001–PLAIN007)

A text can pass every rule above and still read as long-winded and machine-written. The PLAIN family checks the habits behind that impression. It runs on prose files (.md, .mdx, .markdown, .txt, stdin); text inside backticks, code fences and URLs is ignored, and headings, table rows, quoted lines and front matter are skipped. A sentence with no Vietnamese letter (an English paragraph) is not judged.

RuleFires whenDefault
PLAIN001A sentence is longer than 25 words (--max-sentence-words N changes the limit; a word is one space-separated syllable)WARN
PLAIN002An audit label (FACT, INFERENCE, ASSUMPTION, UNKNOWN) is left in proseWARN
PLAIN003A sentence opens with a meta phrase (Bản đánh giá này, Phần mới:, Lưu ý:, Hệ quả:)WARN
PLAIN004Filler appears (điều này, nhìn chung, đáng chú ý, một cách, thực hiện, tiến hành)WARN
PLAIN005không chỉ … mà còn sits inside one sentenceWARN
PLAIN006A spaced dash (—, –) is used as an aside; number ranges such as 10 – 20 are skippedWARN
PLAIN007A sentence holds more than two parenthesesWARN

All seven become errors when you declare an executive reader (--context doc-for-executives) and are switched off by the casual chat presets (chat-close-friend, chat-colleague). --strict already exits non-zero on any warning. The phrase list for PLAIN002–PLAIN004 is a table in shared/references/plain-vietnamese.md, together with before/after pairs that the test suite executes; add a row to extend it. Silence a rule with <!-- vlc-disable: PLAIN001 --> (file) or <!-- vlc-disable-line: PLAIN004 --> (line).

python3 shared/scripts/validate_copy.py report.md
python3 shared/scripts/validate_copy.py report.md --context doc-for-executives
python3 shared/scripts/validate_copy.py report.md --strict --max-sentence-words 25

Writing context (--context)

--register models an organisation → customer voice. --context <preset> models one person writing to a specific person: a chat with friends, an email to the boss, a job application, a document for executives or for engineers. A preset is a bundle of five facets (relation, closeness, channel, purpose, reader) defined in shared/references/context-matrix.md. It turns on rules CTX001–CTX005 and turns off rules that do not suit the situation; real defects (NFC001, ENC001, mixed quý khách/bạn via PRO001) always stay on. Word lists and presets are conventions, not statute (evidence class proposed).

PresetSituationRules on (CTX)Relaxed (off)
chat-close-friendChat with a close friendCTX001DIA001 CAL001 LAW001 SYN001 CAL002 NUM002 NUM004 TONE001 CTX003 PLAIN001–PLAIN007
chat-colleagueColleague chat (Slack/Zalo group)CTX001same as above except NUM002 (amounts are business data between colleagues)
chat-to-managerMessage to the bossCTX001 CTX002 CTX003—
email-to-managerEmail to the boss / a superiorCTX001 CTX002 CTX003 CTX004—
email-to-colleagueEmail to a colleagueCTX001 CTX003 CTX004—
email-to-teamEmail or announcement to reports / the whole teamCTX001 CTX003 CTX004—
email-to-clientEmail to a client or partner, written by a personCTX001 CTX003 CTX004—
job-applicationCover letter, application email, CVCTX001 CTX003 CTX004—
doc-for-executivesReport or document for leadershipCTX001 CTX003 CTX005—
doc-for-engineersTechnical document for developersCTX001 CTX003—
RuleFires when
CTX001An address/self term forbidden for the context appears (mày/tao/mình/bạn to a superior, quý khách in a friend chat). error toward a superior, else warning.
CTX002A message to a superior addresses them (anh/chị, sếp) but has no politeness particle (ạ, dạ, vâng).
CTX003A chat abbreviation (ko, dc, đc, mn, ae, r, …) appears outside a close chat. error in an email/document toward a superior, else warning.
CTX004An email has no greeting line or no sign-off.
CTX005A document for executives has no summary or conclusion marker (Tóm tắt, Kết luận, Đề xuất, TL;DR, …) in its first 15 non-empty lines.

Three runs (abridged from real output; exit is the process exit code):

$ printf 'Chào sếp,\n\nMình gửi sếp báo cáo tuần này, mai sếp rảnh ko?\n' | vi-validate-copy --context email-to-manager -
<stdin>:1:6: warn  CTX002  the email-to-manager context addresses a superior but the message has no politeness particle
<stdin>:3:1: error CTX001  “Mình” does not fit the email-to-manager context (Email gửi sếp/cấp trên)
<stdin>:3:1: warn  CTX004  email has no sign-off
<stdin>:3:45: error CTX003  chat abbreviation “ko” (không) in the email-to-manager context
1 file(s) checked · 2 error(s) · 2 warning(s)        # exit 1

$ printf 'Tôi muốn ứng tuyển vị trí Kế toán tổng hợp, bạn xem CV giúp mình.\n' | vi-validate-copy --context job-application -
<stdin>:1:1: warn  CTX004  email has no greeting line
<stdin>:1:1: warn  CTX004  email has no sign-off
<stdin>:1:45: error CTX001  “bạn” does not fit the job-application context (Thư xin việc / email ứng tuyển / CV)
<stdin>:1:61: error CTX001  “mình” does not fit the job-application context (Thư xin việc / email ứng tuyển / CV)
1 file(s) checked · 2 error(s) · 2 warning(s)        # exit 1

$ printf 'ko biết nha mn, tối nay ae đi ăn ko, mai tao dc nghỉ r\ncam on nha, quán này rẻ nhất Sài Gòn, số 1 luôn\n' | vi-validate-copy --context chat-close-friend -
1 file(s) checked · 0 error(s) · 0 warning(s)        # exit 0, clean
# the same text without --context: DIA001 "cam on", LAW001 "rẻ nhất" and "số 1"

Composition: --context combines with --register, --domain and --doctype; context relaxations are applied after domain rules are collected, --strict semantics are unchanged, and the JSON shape is unchanged. An unknown preset exits 2 and lists the valid ids. A stand-alone CV file has no greeting or sign-off; add <!-- vlc-disable: CTX004 --> to it.

Suggestion, never a guess. With no --context, the linter may print one hint to stderr when strong signals appear (for example Kính gửi anh/chị plus Em xin… suggests email-to-manager). The hint never changes findings, the JSON on stdout or the exit code, and no context rule is applied on a guess.


Installation

Choose the setup that matches your AI coding agent. Browse docs/cookbook.md for copy-paste prompt recipes across all 16 domains.

Claude Code

/plugin marketplace add jangtrinh/design-os-vietnamese
/plugin install design-os-vietnamese@design-os-vietnamese

OpenAI Codex, Gemini CLI, Google Antigravity & Other Agent Harnesses

git clone https://github.com/jangtrinh/design-os-vietnamese /tmp/design-os-vietnamese
mkdir -p ~/.claude/skills ~/.codex/skills ~/.gemini/config/skills ~/.agents/skills
cp -R /tmp/design-os-vietnamese/skills/* ~/.claude/skills/
cp -R /tmp/design-os-vietnamese/skills/* ~/.codex/skills/
cp -R /tmp/design-os-vietnamese/skills/* ~/.gemini/config/skills/
cp -R /tmp/design-os-vietnamese/skills/* ~/.agents/skills/
rm -rf /tmp/design-os-vietnamese

How it works

  1. Intent & Register Routing — Your AI agent matches the prompt against skills/<skill>/SKILL.md and selects one of the 31 audience registers (shared/references/register-matrix.md).
  2. Progressive Context Loading — Only the target SKILL.md (~150 lines) loads initially; domain playbooks, templates, and UKMC.v1 knowledge modules load on demand.
  3. Deterministic Static Linting — validate_copy.py, check_i18n_parity.py, and check_font_coverage.py execute locally in <100ms with zero network calls.
  4. Epistemic & Repo Verification — python3 tools/verify_ukmc.py and python3 scripts/self_check.py verify all 18 UKMC.v1 modules (65+ SHA-256 anchors, STOP_SUFFICIENT) and 489 golden evaluation pairs.

What loads when

FileLoaded when
skills/<skill>/SKILL.mdAlways (~140–185 lines) — domain workflow, register matrix, and rule triggers
skills/<skill>/references/*.mdOn demand when drafting or auditing specific domain artifacts
docs/cookbook.mdWhen selecting multi-step prompt recipes across the 16 Vietnamese skills
commands/doctor.md / prompts/doctor.mdOnly when running /doctor diagnostics
llms.txtWhen indexed by AI answer engines, RAG pipelines, or repo crawlers

File structure

design-os-vietnamese/
├── .claude-plugin/                 # Claude Code plugin & marketplace manifests
├── .codex-plugin/                  # OpenAI Codex plugin & interface manifest
├── .agents/plugins/                # Cross-agent local plugin registry
├── .factory-plugin/                # Factory / Droid plugin manifests
├── assets/
│   └── design-os-vietnamese-architecture.svg
├── commands/doctor.md              # /doctor diagnostic slash command
├── prompts/doctor.md               # Codex diagnostic prompt mirror
├── scripts/self_check.py           # Deterministic repository & skill self-check
├── shared/
│   ├── references/                 # Universal compliance, register-matrix, context-matrix, typography, glossary, banned-phrases
│   └── scripts/                    # Canonical validate_copy.py, check_i18n_parity.py, check_font_coverage.py
├── skills/                         # 16 self-contained production skills across Vietnamese software & regulated industries
├── knowledge/                      # 18 UKMC.v1 cryptographically verified modules + _evidence/ SHA-256 corpus
├── evals/                          # 489 golden bad/good pairs across 16 skills + trigger queries
├── tests/                          # Automated unit, spec, sync, UKMC.v1, and QA regression tests
├── tools/                          # sync_shared.py, build_examples.py, verify_ukmc.py
├── docs/                           # 9-Tier GitHub Pages site (index.html, cookbook.md, llms.txt, sitemap.xml, robots.txt)
├── PRIVACY.md                      # Zero-telemetry & local-first privacy commitment
├── SECURITY.md                     # Security architecture & disclosure policy
├── CONTRIBUTING.md                 # Contribution workflow & mandatory test gates
├── CODE_OF_CONDUCT.md              # Contributor Covenant code of conduct
├── CHANGELOG.md                    # Release history
├── llms.txt                        # Root GEO / LLM discovery index
├── LICENSE                         # PolyForm Shield License 1.0.0
├── README.vi.md                    # Vietnamese documentation
└── README.md

Quality bar & Limitations

It's working if...

  • python3 scripts/self_check.py prints ok: design-os-vietnamese self-check passed (16 skills, 18 UKMC.v1 modules) and exits 0.
  • python3 -m unittest discover -s tests -v runs all 42+ tests (including all QA regression tests across PR #1 & Issue #2 and 489 golden evaluation pairs) and prints OK.
  • python3 tools/verify_ukmc.py prints files: 18 · anchors: 66 · failures: 0 · Decision: STOP_SUFFICIENT.
  • Network traffic during execution remains zero (guaranteed by PRIVACY.md).

When not to use

  • Phonetic IPA transcription of historical or regional dialectal corpora where non-standard orthography is intentionally preserved as linguistic research data.
  • Multi-seat cloud Translation Management Systems (TMS) for human translation agency billing and vendor invoicing.
  • Replacing licensed legal counsel or attending physicians on high-stakes statutory filings or clinical diagnoses.
Frequently Asked Questions (AEO & Statutory FAQ Registry)

What is DESIGN:OS Vietnamese and how does it prevent LLM translationese? design-os-vietnamese combines 16 domain-specialized agent skills with validate_copy.py, a deterministic Python 3.9+ linter that flags English calques (CAL001), syntactic translationese (SYN001), decomposed Unicode NFD (NFC001), mixed tone placement (TONE001), broken ICU plural branches (ICU001), and pronoun register drift (PRO001/PRO002) across 31 Vietnamese audience registers.

How does vietnamese-education-copy cover the 7-tier pedagogy continuum from Preschool to Doctoral studies? It enforces statutory grading and terminology across all 7 tiers: Tier 1 Preschool (Mầm non: Nhà trẻ 3–36 tháng & Mẫu giáo 3–6 tuổi under VBHN 01/VBHN-BGDĐT, blocking numeric scores via EDU011), Tier 2 Primary (TT 27/2020/TT-BGDĐT, EDU002), Tier 3 Secondary/High School (TT 22/2021/TT-BGDĐT, EDU001), Tier 4 TVET (TT 04/2022/TT-BLĐTBXH), Tier 5 Undergraduate VQF Level 6 (TT 08/2021/TT-BGDĐT), Tier 6 Master's VQF Level 7 (TT 23/2021/TT-BGDĐT), and Tier 7 Doctoral VQF Level 8 + GS./PGS. Academic Ranks (TT 18/2021/TT-BGDĐT & QĐ 37/2018/QĐ-TTg, EDU004, EDU008, EDU012).

Does DESIGN:OS Vietnamese require external dependencies or cloud APIs? No. All scripts run 100% offline using the Python 3.9+ standard library with zero external packages and zero telemetry (PRIVACY.md).


DESIGN:OS Ecosystem

design-os-vietnamese is part of the DESIGN:OS source-available engineering ecosystem:

EngineLive DocsRepositoryLayer
DESIGN:OS CLIjangtrinh.github.io/design-osjangtrinh/design-oscli
Knowledge Builderjangtrinh.github.io/design-os-knowledge-builderjangtrinh/design-os-knowledge-buildercompiler
Figma Plugin & CLIjangtrinh.github.io/design-os-figma-pluginjangtrinh/design-os-figma-pluginplugin
SVG Animation Enginejangtrinh.github.io/design-os-svg-animationjangtrinh/design-os-svg-animationengine
3D Blender Agentjangtrinh.github.io/design-os-3d-blenderjangtrinh/design-os-3d-blender3d / cad
OPAH ONE Dronejangtrinh.github.io/design-os-drone-showcasejangtrinh/design-os-drone-showcasehardware
GitHub Pages Enginejangtrinh.github.io/design-os-github-pagejangtrinh/design-os-github-pagepages
Apple Design OSjangtrinh.github.io/design-os-applejangtrinh/design-os-appleswiftui
Agent Teacherjangtrinh.github.io/design-os-pedagogyjangtrinh/design-os-pedagogypedagogy
Origami CADjangtrinh.github.io/design-os-origamijangtrinh/design-os-origamipackaging
Voice UX Architecturejangtrinh.github.io/design-os-voice-uxjangtrinh/design-os-voice-uxvoice-ai
Code2Flowjangtrinh.github.io/design-os-code2flowjangtrinh/design-os-code2flowast / audit
Generative UIjangtrinh.github.io/design-os-generative-uijangtrinh/design-os-generative-uiruntime
DESIGN:OS Vietnamesejangtrinh.github.io/design-os-vietnamesejangtrinh/design-os-vietnamesevi-VN / i18n

Contributing, Governance & License

// faq

What is design-os-vietnamese?

Free, offline Vietnamese copy linter plus 16 agent skills for Claude Code, Codex, Gemini CLI and Antigravity. Flags calques, US-style dates and numbers, unproven superlatives and outdated legal terms. 31 registers, 489 eval pairs, 18 UKMC.v1 modules. Zero telemetry. Source-available (PolyForm Shield 1.0.0).. It is open-source on GitHub.

Is design-os-vietnamese free to use?

design-os-vietnamese is open-source under the NOASSERTION license, so it is free to use.

What category does design-os-vietnamese belong to?

design-os-vietnamese is listed under skills in the Claudeers registry of Claude-compatible tools.

10 views
★ 12 stars
unclaimed
updated 19 days ago

// embed badge

design-os-vietnamese on Claudeers
[![Claudeers](https://claudeers.com/api/badge/design-os-vietnamese.svg)](https://claudeers.com/design-os-vietnamese)

// retro hit counter

design-os-vietnamese hit counter
[![Hits](https://claudeers.com/api/counter/design-os-vietnamese.svg)](https://claudeers.com/design-os-vietnamese)

// reviews

// guestbook

0/500

// related in Claude Skills

🔓

An agentic skills framework & software development methodology that works.

// skillsobra/⟨Shell⟩★ 314,126◷ MIT[ claude ]
🔓

Public repository for Agent Skills

// skillsanthropics/⟨Python⟩★ 188,182[ claude ]
🔓

AI coding assistant skill (Claude Code, Codex, OpenCode, Cursor, Gemini CLI, and more). Turn any folder of code, SQL schemas, R scripts, shell scripts, docs,…

// skillsGraphify-Labs/⟨Python⟩★ 149,064◷ MIT[ claude ]
🔓

💫 Toolkit to help you get started with Spec-Driven Development

// skillsgithub/⟨Python⟩★ 148,200◷ MIT[ claude ]
→ see how design-os-vietnamese connects across the ecosystem