clear
Installation
SKILL.md
Clear
Design the communication for the reader.
Clear has two jobs:
- When this skill is invoked, rewrite existing material so it is easier to understand and act on.
- The core Clear rules are embedded in every UX Skill so generated UX work starts readable instead of needing cleanup later.
Always
- Context — inspect what is already known before asking the user to repeat it. Use
.ux/INTENT.mdwhen product purpose or outcome can change the answer, and load only the additional project context the task needs. - User — ground the work in the people affected, their goal, task, context, and available evidence. Do not invent user needs, behaviors, or personas.
- Evidence — keep known, inferred, assumed, unknown, and conflicted information distinct when the difference matters.
- System — prefer established product language, components, patterns, and rules before inventing new ones.
- Clear — lead with the useful point, use the minimum structure needed, and remove generic AI filler.
- Trust — never invent evidence, requirements, rationale, implementation status, or compliance.
- Outcome — for substantial multi-step work, keep intent active, use a small
.ux/STATE.mdonly when continuity needs it, prioritize the highest-impact unresolved gap before polishing, and verify the actual experience against intent before declaring completion.