Clarify

educlopez/ui-craft/.agents/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位于.agents/skills/clarify提交ceecc8e

许可证: 无许可证

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架