clarify

Tổng quan về skill clarify

clarify là skill giúp viết lại những đoạn text UI khó hiểu để người dùng nắm được chuyện gì đã xảy ra, cần làm gì tiếp theo và vì sao điều đó quan trọng. Skill này được xây dựng cho công việc thiết kế UI/UX, đặc biệt khi sản phẩm có nhãn mơ hồ, thông báo lỗi yếu, hướng dẫn khó theo dõi hoặc microcopy nghe có vẻ đúng về mặt kỹ thuật nhưng vẫn làm người dùng thực tế bối rối.

clarify phù hợp nhất với trường hợp nào

Hãy dùng clarify khi vấn đề cốt lõi trước hết không nằm ở layout hay luồng tương tác, mà nằm ở câu chữ bên trong giao diện:

• nhãn nút không cho thấy kết quả sẽ xảy ra
• thông báo lỗi giải thích hệ thống thay vì giúp người dùng xử lý
• empty state không có bước tiếp theo
• phần trợ giúp trong form mặc định người dùng đã biết quá nhiều
• hướng dẫn tuy chính xác nhưng gây quá tải nhận thức trong lúc căng thẳng

Vì vậy, clarify skill đặc biệt phù hợp với product designer, UX writer, team frontend và founder đang tinh chỉnh nội dung hướng tới người dùng trước khi phát hành.

clarify thực sự giải quyết việc gì

Công việc thực tế của clarify là biến những đoạn copy giao diện còn thô hoặc chưa rõ ràng thành nội dung:

• dễ quét hơn
• dễ hành động hơn
• phù hợp hơn với mức độ hiểu biết của người dùng
• phù hợp hơn với trạng thái cảm xúc tại thời điểm đó

Điểm cuối cùng rất quan trọng. Skill gốc yêu cầu nêu rõ trình độ kỹ thuật của người dùng và trạng thái tinh thần trong ngữ cảnh đó, điều này hữu ích hơn nhiều so với kiểu prompt chung chung như “làm cho đoạn này rõ hơn”.

clarify khác gì so với một prompt rewrite thông thường

Một prompt thông thường có thể tạo ra câu chữ gọn gàng hơn. clarify thì có quan điểm rõ ràng hơn về vì sao copy thất bại:

• dùng thuật ngữ chuyên môn
• mơ hồ
• câu bị động
• thiếu ngữ cảnh
• giả định ngầm
• lệch tông giọng
• quá nhiều hoặc quá ít chi tiết

Skill này cũng phụ thuộc vào bối cảnh thiết kế rộng hơn. Nó yêu cầu /frontend-design và nếu chưa có bối cảnh đó thì cần /teach-impeccable trước. Phụ thuộc này rất quan trọng khi cân nhắc cài đặt: clarify không phải một macro đánh bóng câu chữ chạy độc lập; nó được thiết kế để hoạt động trong một quy trình UX/design system lớn hơn.

Cách dùng skill clarify

Cài clarify trong đúng ngữ cảnh repository

Đường dẫn clarify install tuân theo hệ thống skill của repo pbakaus/impeccable. Nếu bạn đang dùng môi trường tương thích Skills, hãy thêm repo rồi gọi skill clarify từ đó. Bản thân skill nằm tại:

/.agents/skills/clarify/SKILL.md

Vì bằng chứng từ repository hiện chỉ cho thấy SKILL.md, hãy đọc file đó trước khi mặc định rằng còn có script hỗ trợ hoặc tài nguyên bổ sung khác.

Hãy đọc file này trước lần chạy đầu tiên

Bắt đầu với:

• SKILL.md

Đây là nơi chứa logic vận hành thực sự: phần chuẩn bị bắt buộc, tiêu chí đánh giá và luồng review copy theo từng bước. Ở đây chưa thấy script hỗ trợ hay tài liệu tham chiếu nào khác, nên giá trị chính nằm ở việc làm đúng thứ tự mà skill yêu cầu.

Đừng bỏ qua dependency bắt buộc

Trước khi dùng clarify, skill yêu cầu gọi:

• /frontend-design

Và nếu chưa có design context:

• /teach-impeccable

Đây là trở ngại lớn nhất với người mới. Nếu bỏ qua bước chuẩn bị này, bạn vẫn có thể nhận được câu chữ khá ổn nhưng quyết định UX sẽ yếu hơn. Skill này giả định rằng các nguyên tắc thiết kế và phần thu thập ngữ cảnh đã có sẵn.

clarify cần đầu vào gì để hoạt động tốt

Mức đầu vào tối thiểu để clarify usage dùng được là đoạn text hiện tại cộng với vị trí nó xuất hiện. Kết quả sẽ tốt hơn nếu bổ sung thêm:

• màn hình hoặc flow mục tiêu
• loại UI element cụ thể
• mức độ kỹ thuật của người dùng
• trạng thái tinh thần của người dùng ở thời điểm đó
• hành động mong muốn sau khi đọc
• các ràng buộc như tone, brand voice hoặc giới hạn ký tự

Nếu thiếu những dữ liệu này, skill vẫn có thể viết lại text, nhưng sẽ khó chọn đúng mức độ trực diện, chi tiết hay sắc thái cảm xúc.

Dạng prompt tốt nhất cho clarify trong UI/UX Design

Một yêu cầu yếu:

• “Improve this error message: Authentication failed.”

Một yêu cầu tốt hơn:

• “Use clarify for UI/UX Design. Rewrite this login error message for non-technical users on mobile. They are likely frustrated and trying to get back into their account quickly. Current text: ‘Authentication failed.’ We want them to understand the problem and next step without sounding robotic. Keep it under 90 characters if possible.”

Đầu vào mạnh hơn này cung cấp phần dữ liệu ra quyết định còn thiếu cho skill: đối tượng người dùng, cảm xúc, bối cảnh thiết bị và tiêu chí thành công.

Biến một mục tiêu thô thành prompt clarify có thể dùng được

Nếu điểm xuất phát của bạn là “làm cho text trong app rõ hơn”, hãy chuyển nó thành cấu trúc sau:

1. copy hiện tại
2. vị trí trong sản phẩm
3. người dùng là ai
4. họ đang cố làm gì
5. họ đang ở trạng thái cảm xúc nào
6. họ nên làm gì tiếp theo
7. ràng buộc về độ dài hoặc tone

Cấu trúc này bám khá sát với clarify guide mà checklist của skill ngầm chỉ ra.

Quy trình gợi ý để dùng clarify hiệu quả trong thực tế

Một quy trình đáng tin cậy thường như sau:

1. Thu thập product context và design context bằng /frontend-design.
2. Xác nhận trình độ người dùng và trạng thái tinh thần.
3. Dán nguyên văn copy gốc đúng như đang hiển thị.
4. Giải thích màn hình đó và hành động người dùng được kỳ vọng thực hiện.
5. Yêu cầu chẩn đoán trước, rồi mới đến các phương án viết lại.
6. Chọn một hướng và lặp tiếp về tone, độ ngắn gọn hoặc mức độ cụ thể.

Bước “chẩn đoán trước” rất quan trọng vì skill này được thiết kế để chỉ ra vì sao copy chưa rõ, chứ không chỉ thay bằng câu khác.

Yêu cầu clarify chẩn đoán trước khi viết lại

Để nhận được nhiều giá trị hơn một lần “đánh bóng” LLM thông thường, hãy yêu cầu output theo 2 giai đoạn:

• các vấn đề về độ rõ ràng được phát hiện
• các phương án cải thiện

Ví dụ:

• “Use clarify. First identify jargon, ambiguity, missing context, assumptions, and tone issues in this onboarding copy. Then provide 3 rewrite options for first-time users.”

Cách này giúp team review quyết định tốt hơn thay vì chỉ chọn bản nào nghe xuôi tai nhất.

clarify mạnh nhất ở đâu

clarify skill phát huy tốt nhất với các đoạn text UI ngắn nhưng tác động lớn như:

• lỗi
• nhãn
• helper text
• xác nhận
• cảnh báo
• empty state
• hướng dẫn thiết lập

Đây là những vị trí mà câu chữ không rõ sẽ tạo ma sát rất nhanh, và nơi việc viết lại có tính đến ngữ cảnh có thể cải thiện đáng kể tỷ lệ hoàn thành lẫn mức độ tự tin của người dùng.

clarify yếu hơn trong trường hợp nào

Hãy cẩn trọng nếu vấn đề thực sự là:

• product flow sai
• thiếu chức năng
• information architecture kém
• câu chữ pháp lý hoặc tuân thủ gần như không thể thay đổi nhiều
• marketing copy dài

Trong các trường hợp đó, clarify có thể cải thiện độ dễ đọc, nhưng sẽ không sửa được nguyên nhân gốc.

Câu hỏi thường gặp về skill clarify

clarify chỉ dành cho UX writer thôi sao?

Không. clarify hữu ích cho designer, PM, engineer và founder chịu trách nhiệm về text giao diện nhưng không được đào tạo bài bản về UX writing. Điều kiện chính là bạn phải cung cấp đủ ngữ cảnh về người dùng và thời điểm sử dụng.

clarify có thân thiện với người mới không?

Phần lớn là có, nhưng chỉ nếu bạn để ý chuỗi dependency của nó. Skill gốc yêu cầu /frontend-design, và có thể cả /teach-impeccable, trước khi viết lại. Người mới bỏ qua bước này có thể nghĩ skill quá mỏng, trong khi workflow đúng của nó thực ra là ưu tiên ngữ cảnh trước.

clarify làm tốt hơn gì so với prompt “rewrite this” bình thường?

Lợi thế lớn nhất là chẩn đoán có cấu trúc. clarify tìm các nguyên nhân gây khó hiểu khá cụ thể như thuật ngữ chuyên môn, sự mơ hồ, câu bị động, thiếu ngữ cảnh và giả định sai về kiến thức người dùng. Điều này thường dẫn đến những bản viết lại hữu ích hơn cho copy trong giao diện.

Khi nào không nên dùng clarify?

Đừng dùng clarify khi copy chỉ là triệu chứng của một vấn đề sản phẩm sâu hơn. Nếu người dùng bối rối vì flow bị lỗi, quyền hạn không rõ ràng hoặc UI che mất thông tin quan trọng, thì chỉ cải thiện câu chữ sẽ không giải quyết được vấn đề.

clarify có tốt cho thông báo lỗi không?

Có. Đây là một trong những use case rõ ràng nhất. Skill này tính đến trạng thái tinh thần của người dùng một cách tường minh, điều rất quan trọng trong những thời điểm căng thẳng như lỗi đăng nhập, sự cố thanh toán hoặc lỗi validation form.

clarify có giúp về tone và brand voice không?

Có, nhưng chỉ khi bạn nêu rõ ràng buộc. Nếu bạn muốn kiểu “plain but premium”, “friendly but not playful” hoặc “supportive under stress”, hãy nói thẳng. Nếu không, skill sẽ chủ yếu tối ưu cho độ rõ ràng.

Cách cải thiện skill clarify

Hãy đưa cho clarify trạng thái người dùng, đừng chỉ đưa câu chữ

Cải thiện có đòn bẩy lớn nhất là mô tả tình huống của người dùng:

• lần đầu dùng hay đã thành thạo
• bình tĩnh hay căng thẳng
• đang khám phá hay đang cố khôi phục sau khi gặp lỗi
• desktop hay mobile
• mức chú ý cao hay thấp

Điều này ảnh hưởng trực tiếp đến việc copy tốt nhất nên ngắn hơn, ấm hơn, rõ ràng hơn hay mang tính hướng dẫn hơn.

Cung cấp phần UI xung quanh, không chỉ text tách rời

Một nhãn hoặc thông báo thường trông dở vì thiếu ngữ cảnh xung quanh. Để cải thiện kết quả của clarify, hãy kèm theo:

• các field hoặc button lân cận
• tiêu đề trang
• bước trước đó
• hành động dự kiến tiếp theo

Một dòng “tệ” có thể chấp nhận được ở màn hình này nhưng lại gây hại ở màn hình khác.

Yêu cầu nhiều chiến lược viết lại

Thay vì chỉ xin một câu trả lời, hãy yêu cầu các phương án như:

• phiên bản ngắn nhất nhưng vẫn rõ
• phiên bản mang tính hỗ trợ nhất
• phiên bản định hướng hành động nhất

Điều này đặc biệt hữu ích cho clarify for UI/UX Design vì các team thường phải đánh đổi giữa độ ngắn gọn, tone và mức độ hướng dẫn.

Nêu ràng buộc ký tự hoặc layout từ sớm

Nếu copy phải vừa trong button, toast, modal hoặc field của form trên mobile, hãy nói ngay từ đầu. Nếu không, clarify có thể tạo ra câu chữ rõ hơn về mặt lý thuyết nhưng lại không dùng được trong giao diện thực tế.

Theo dõi các kiểu lỗi phổ biến

Ngay cả khi dùng clarify, các team vẫn hay chấp nhận những bản viết lại:

• rõ hơn nhưng quá dài
• thân thiện hơn nhưng mơ hồ
• chính xác nhưng quá kỹ thuật
• trau chuốt nhưng tách rời khỏi tác vụ thực tế

Hãy review output dựa trên hành động bạn muốn người dùng thực hiện, không chỉ dựa trên chất lượng câu chữ.

Lặp lại ở phần chẩn đoán, đừng chỉ sửa câu chữ

Nếu kết quả đầu tiên chưa đúng ý, đừng chỉ yêu cầu viết ngắn hơn. Hãy hỏi skill có thể đã hiểu sai điều gì:

• giả định sai về đối tượng người dùng
• hiểu sai trạng thái tinh thần
• thiếu product context
• đơn giản hóa quá mức
• chưa giải thích đủ bước tiếp theo

Cách này cải thiện các lần output sau nhanh hơn nhiều so với chỉnh sửa bề mặt.

Kết hợp clarify với review ở cấp màn hình

Cách tốt nhất để cải thiện clarify skill trong thực tế là dùng nó như một phần của screen review, không phải chỉ như công cụ sửa từng câu riêng lẻ. Hãy review toàn bộ copy liên quan cùng nhau:

• tiêu đề trang
• nhãn field
• helper text
• validation text
• nhãn CTA
• thông báo thành công hoặc thất bại

Cách này giúp phát hiện những điểm thiếu nhất quán mà việc viết lại từng dòng riêng lẻ sẽ bỏ sót.

Giữ một prompt template tái sử dụng cho clarify usage

Một template đơn giản có thể tái sử dụng:

• “Use clarify. Context: [screen/flow]. Audience: [user type]. Mental state: [emotion/urgency]. Current copy: [text]. Goal: [desired action]. Constraints: [tone/length/brand]. First diagnose the clarity issues, then give 3 rewrite options.”

Cách này giúp clarify usage nhất quán hơn giữa các team và giảm các yêu cầu thiếu ngữ cảnh vốn dễ tạo ra output chung chung.