vietnamese-dev

vietnamese-dev

Trả lời tiếng Việt gọn. Tech terms tiếng Anh giữ nguyên.

A Claude Code skill that makes the agent respond in terse Vietnamese while keeping English technical vocabulary verbatim — matching how Vietnamese developers actually talk at work.

---

Why Vinglish, not pure Vietnamese?

Tiếng Việt thuần ("phần mềm trung gian" thay cho middleware) dịch tech term là tự làm khó người đọc. VN dev thật sự nói Vinglish: VN prose + English tech vocabulary. Skill này bám sát cách đó — gọn, tự nhiên, đúng kỹ thuật.

Lưu ý: đây không phải skill tiết kiệm token. Ký tự có dấu (ă, ê, ơ, đ + thanh) tokenize kém hơn English trong BPE, nên compression gain không đáng kể. Giá trị ở readability cho VN dev, không phải %-token saved.

Before / After

🗣️ Normal Claude "The reason your React component is re-rendering is likely because you're creating a new object reference on each render cycle. When you pass an inline object as a prop, React's shallow comparison sees it as a different object every time, which triggers a re-render. I'd recommend using useMemo to memoize the object."	🇻🇳 vietnamese-dev (đầy) "Ref object mới mỗi render. Inline prop = ref mới = re-render. Dùng useMemo wrap lại."
"Sure! I'd be happy to help you with that. The issue you're experiencing is most likely caused by your authentication middleware not properly validating the token expiry. Let me take a look and suggest a fix."	"Bug trong auth middleware. Token expiry check xài < thay vì <=. Fix:"

Cùng nội dung. Tiếng Việt gọn. Tech terms nguyên văn.

Install

claude plugin marketplace add DevLungTung/vietnamese-dev
claude plugin install vietnamese-dev@vietnamese-dev

Test local trước khi push GitHub:

claude plugin marketplace add ~/vietnamese-dev
claude plugin install vietnamese-dev@vietnamese-dev

Usage

Activate:

• /vn — default cấp đầy
• /vn nhẹ — lite
• /vn đầy — full
• /vn cực — ultra
• "nói tiếng Việt" / "tiếng Việt mode" / "respond in Vietnamese"

Stop: "stop vn", "normal mode", "English please", "tiếng Anh"

Intensity Levels

Level	Trigger	Mô tả
nhẹ	/vn nhẹ	Ngữ pháp đầy đủ, chỉ bỏ filler. Professional register.
đầy (default)	/vn hoặc /vn đầy	Fragment OK, bỏ pronoun thừa, short synonym.
cực	/vn cực	Max nén. X → Y arrows, viết tắt, một chữ khi một chữ đủ.

Example — "Tại sao React component re-render?"

Level	Output
nhẹ	Component re-render vì mỗi lần render bạn tạo ref object mới. Inline object prop fail shallow comparison mỗi lần. Wrap trong useMemo để giữ ref ổn định.
đầy	Ref object mới mỗi render. Inline prop = ref mới = re-render. Dùng useMemo wrap lại.
cực	Inline obj prop → ref mới → re-render. useMemo.

Companion Skills

/vn-commit

Conventional Commits — English imperative subject + Vietnamese body:

feat(api): add GET /users/:id/profile

Mobile client cần profile data không kèm full user payload để
giảm LTE bandwidth khi cold-launch screen.

Closes #128

/vn-review

One-line PR review comments bằng tiếng Việt:

L42: 🔴 lỗi: user có thể null sau .find(). Thêm guard trước .email.
L88-140: 🔵 nit: fn 50 dòng làm 4 việc. Tách validate/normalize/persist.
L23: 🟡 rủi ro: không retry khi 429. Wrap trong withBackoff(3).
L67: ❓ hỏi: read-then-write không lock — race giữa 2 request cùng user?

Auto-Clarity

Skill tự động bỏ terse mode (viết VN đầy đủ) cho:

• Security warning — SQL injection, XSS, credential exposure
• Irreversible action — rm -rf, DROP TABLE, git push --force, git reset --hard
• Multi-step destructive sequence — thứ tự fragment dễ gây hiểu lầm

Resume terse sau khi phần quan trọng đã rõ.

Boundaries

• Code / commit / PR body: theo quy ước project (thường English). Chỉ prose được compress.
• Error message, log output, file path: quote nguyên văn.
• User pha English + Việt: match register của user.

Dựa trên

Skill này model theo caveman của Julius Brussee — cùng architecture (SKILL.md + slash commands + marketplace), khác ngôn ngữ và triết lý (readability cho VN dev, không phải token savings).

License

MIT