ux-copy là Agent Skill viết mới, rà soát và tái cấu trúc nội dung giao diện (UX writing và microcopy) bằng tiếng Việt và tiếng Anh trên văn bản thuần, Markdown, JSON i18n và mã nguồn UI (JSX/TSX/HTML).
https://github.com/user-attachments/assets/c1a917e3-4d5f-4976-b0be-fdb43f229162
Tính năng chính
- Viết mới bộ microcopy từ đầu theo 4 ngữ cảnh giọng điệu (Success, Error, Warning, Informative) và các mẫu thành phần UI (CTA, thông báo lỗi, trạng thái trống, hộp thoại xác nhận, biểu mẫu, tooltip, tiến trình, onboarding).
- Rà soát, dọn dẹp copy thừa (Subtract Before Rewriting) và sửa chuỗi giao diện có sẵn trên bảng copy, tệp JSON i18n và component JSX/TSX/HTML theo thứ tự ưu tiên từ an toàn mã nguồn đến typography.
- Tách riêng quy chuẩn ngữ pháp và định dạng từng ngôn ngữ: Sentence Case, dấu ngoặc kép cong, dấu ba chấm đơn, loại bỏ câu bị động và định dạng ngày/số cho tiếng Việt; câu chủ động, dạng rút gọn tự nhiên và định dạng số chuẩn cho tiếng Anh.
- Kiểm tra microcopy trợ năng (
aria-label,alt, nhãn liên kết có nghĩa), tránh nối chuỗi i18n trong code và cân chỉnh độ dài nhãn khi dịch sang tiếng Việt cho nút/tab hẹp. - Bảo toàn cấu trúc key i18n, cú pháp biến động (
{var},{{var}},%s, ICU, thẻ rich-text), props và dấu nháy cú pháp khi chỉnh sửa trực tiếp; không tự ý xóa key i18n hoặc thẻ component ngoài ranh giới an toàn. - Cung cấp bộ tiêu chí và mẫu đầu vào kiểm thử trong
evals/để đánh giá lại chất lượng skill sau khi cập nhật.
Chế độ làm việc
Tương thích với các coding agent hỗ trợ chuẩn AgentSkills.
| Chế độ | Đầu vào thường gặp | Đầu ra |
|---|---|---|
| Viết mới (Draft) | Mô tả màn hình, luồng thao tác, loại thông báo | Bộ microcopy nhóm theo thành phần kèm biến động {...} |
| Rà soát & Sửa (Audit) | Văn bản, Markdown, JSON i18n, tệp JSX/TSX/HTML | Bảng đối chiếu Trước/Sau hoặc tệp đã sửa giữ nguyên cú pháp |
Cài đặt
Qua Plugin Marketplace (Claude Code, Codex, Antigravity)
Cài plugin trực tiếp từ repository này:
Claude Code:
/plugin marketplace add dexter826/ux-copy
/plugin install ux-copy@ux-copy
Codex:
codex plugin marketplace add dexter826/ux-copy
codex plugin add ux-copy@ux-copy
Antigravity:
agy plugin install https://github.com/dexter826/ux-copy
Qua Skills CLI (Khuyên dùng)
Cài trực tiếp từ GitHub qua skills.
Cài theo dự án:
npx skills add dexter826/ux-copy
Cài global (không hỏi xác nhận):
npx skills add dexter826/ux-copy -g -y
Cài thủ công bằng Git
Sao chép thư mục skills/ux-copy vào thư mục skills của agent để chỉ cài phần runtime (SKILL.md và references/), không kéo theo README.md, assets/ hay evals/.
Global trên Unix/macOS (~/.agents/skills):
tmp=$(mktemp -d) && git clone --depth 1 https://github.com/dexter826/ux-copy.git "$tmp" && mkdir -p ~/.agents/skills && rm -rf ~/.agents/skills/ux-copy && cp -R "$tmp/skills/ux-copy" ~/.agents/skills/ux-copy && rm -rf "$tmp"
Theo dự án trên Unix/macOS (.agents/skills):
tmp=$(mktemp -d) && git clone --depth 1 https://github.com/dexter826/ux-copy.git "$tmp" && mkdir -p .agents/skills && rm -rf .agents/skills/ux-copy && cp -R "$tmp/skills/ux-copy" .agents/skills/ux-copy && rm -rf "$tmp"
Global trên Windows PowerShell ($HOME\.agents\skills):
$tmp = Join-Path $env:TEMP "ux-copy-repo"
Remove-Item -Recurse -Force $tmp -ErrorAction SilentlyContinue
git clone --depth 1 https://github.com/dexter826/ux-copy.git $tmp
New-Item -ItemType Directory -Force -Path "$HOME\.agents\skills" | Out-Null
Remove-Item -Recurse -Force "$HOME\.agents\skills\ux-copy" -ErrorAction SilentlyContinue
Copy-Item -Recurse "$tmp\skills\ux-copy" "$HOME\.agents\skills\ux-copy"
Remove-Item -Recurse -Force $tmp
Cách sử dụng
Skill tự kích hoạt khi bạn yêu cầu viết, dịch, kiểm tra hoặc sửa chữ giao diện, nút bấm, thông báo lỗi, trạng thái trống, hộp thoại xác nhận, biểu mẫu, tooltip hoặc tệp i18n. Bạn cũng có thể gọi trực tiếp /ux-copy kèm ngữ cảnh hoặc tệp mục tiêu.
Ví dụ prompt
Viết microcopy song ngữ VI/EN cho hộp thoại xác nhận xóa dự án và trạng thái lỗi mất kết nối.
Kiểm tra và sửa lỗi UX copy trong src/locales/vi.json, giữ nguyên toàn bộ key và biến {{...}}.
Cấu trúc repository
ux-copy/
├── skills/
│ └── ux-copy/ # Payload runtime cài đặt qua npx skills add
│ ├── SKILL.md # Hướng dẫn điều phối chính và quy trình 2 chế độ
│ └── references/
│ ├── component-patterns.md # Chi tiết 12 mục mẫu UI, cleanup, a11y và Do's & Don'ts
│ └── locale-and-code-rules.md # Quy chuẩn tiếng Việt, tiếng Anh và an toàn mã nguồn/i18n
├── README.md # Tài liệu giới thiệu và hướng dẫn cài đặt
├── CHANGELOG.md # Nhật ký thay đổi theo chuẩn Keep a Changelog
├── LICENSE # Giấy phép MIT
├── .gitignore # Loại trừ workspace tạm, gói .skill và file OS/IDE
├── .gitattributes # Chuẩn hóa ký tự xuống dòng LF
├── plugin.json # Manifest plugin dạng portable cho Codex
├── .claude-plugin/
│ ├── plugin.json # Manifest plugin cho Claude Code
│ └── marketplace.json # Catalog marketplace cho Claude Code
├── .antigravity-plugin/
│ └── plugin.json # Manifest plugin cho Antigravity
├── .agents/
│ └── plugins/
│ └── marketplace.json # Catalog marketplace cho Codex
├── assets/ # Bộ logo Quote Exchange SVG (theme sáng/tối)
│ ├── logo-light.svg
│ ├── logo-dark.svg
│ ├── logo-horizontal-light.svg
│ └── logo-horizontal-dark.svg
└── evals/
├── evals.json # Kịch bản kiểm thử và tiêu chí đánh giá (assertions)
└── files/ # Tệp mẫu đầu vào (vi.json, WorkspaceDangerModal.tsx, BillingSettingsCard.tsx)
Giấy phép
Phân phối theo giấy phép MIT.