Clarify

educlopez/ui-craft/cli/assets/cursor/skills/clarify

作者 educlopezceecc8e1fb0c2befda73da996435900d6dd0c1ac無授權條款375 個星標收錄於 2026年10月9日更新於 2026年10月9日儲存庫5 週前更新

UX copy review across buttons, errors, empty states, and form hints — critiques by default, applies only on request. Use when copy feels vague, generic, or AI-sounding, or when the user says "fix the labels", "improve error messages", or "review the copy". Invoke when the user asks for clarify on their UI, or mentions 'clarify' alongside design / UI / frontend work.

AI 產生的概覽

審查介面文案,涵蓋按鈕、錯誤提示、空狀態與表單提示,預設只做評論,僅在使用者要求時修改。

功能
此技能會走訪使用者介面,從八個面向指出文案問題:按鈕標籤、錯誤訊息、空狀態、表單提示、確認用語、破壞性操作、大小寫與語氣。它會輸出 Review Format 表格,包含 Before、After、Why 三欄,依影響程度排序,並在最後用一段文字總結整體語氣變化。預設只做評論,只有當使用者說「apply」時才修改程式碼,之後重新印出附檔案路徑的表格。它被描述為更廣泛的 ui-craft 技能的一個視角,並引用文案與無障礙相關指引。
適用情境
當介面文案顯得含糊、空泛或像 AI 生成時使用,也適用於使用者要求修正標籤、改善錯誤訊息或審查文案的情境。當請求在提及 clarify 的同時涉及設計、UI 或前端工作時,同樣適用。
執行需求
僅為指令,不附帶指令碼。它期望先載入 ui-craft 技能,並引用 references/copy.md 與 references/accessibility.md 兩個檔案,而這兩個檔案並未包含在此技能資料夾中。
<!-- HARNESS MIRROR — do not edit here. Canonical source: skills/ or commands/. After editing source, copy into cli/assets/<harness>/ and repo-root harness mirrors. -->

Context: this sub-skill is one lens of the broader ui-craft skill. If the ui-craft skill is also installed, read its SKILL.md first for Discovery + Anti-Slop + Craft Test, then apply the specific lens below.

Clarify the copy in $ARGUMENTS. Load the ui-craft skill.

Default mode: critique, not edit. Return the copy diff in a Review Format table. Only apply changes if the user says "apply".

Checklist — walk the UI and flag every instance:

  1. Button labels — verb + object. "Send invite" > "Submit". "Delete project" > "Delete". Never "OK", "Submit", "Click here".
  2. Errors — inline, specific, actionable. "Email already in use — sign in or use another address." Never "Something went wrong."
  3. Empty states — one line explaining why empty + one CTA. "No projects yet. Create your first." not "It's empty here!"
  4. Form hints — below the field, persistent, not just validation-triggered. "Must include a number and a symbol" as helper text, not as an error after submit.
  5. Confirmation language — past tense, subject-first. "Project deleted." > "Successfully deleted project."
  6. Destructive actions — the noun lives in the button. "Delete {projectName}" > "Delete". The dialog confirms; the button commits.
  7. Case — sentence case by default. Title Case only for branded product names. Never ALL CAPS (exception: 11-13px category labels, already in SKILL.md).
  8. Voice — clear > clever. Active voice. Short sentences. Real words ("cancel" not "discontinue", "start" not "initiate").

Knob-agnostic — clarity is not tunable. Run the full checklist regardless of CRAFT_LEVEL.

References to read: references/copy.md (microcopy voice + patterns), references/accessibility.md (error message expectations for screen readers).

Output format — the Review Format table:

BeforeAfterWhy

Prioritize by impact (errors and destructive actions first, then CTAs, then helper copy). End with a one-paragraph summary of the overall voice shift. If the user says "apply", edit the code and re-print the table with file paths.

Next step: /critique — copy changes shift hierarchy; re-read the surface after (rung 1).

來源與署名

來源:educlopez/ui-craft位於cli/assets/cursor/skills/clarify提交ceecc8e

授權條款: 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架