clarify
Originally fromopen-horizon-labs/impeccable
Installation
SKILL.md
Identify and improve unclear, confusing, or poorly written interface text to make the product easier to understand and use.
Context Gathering
Before assessing copy, gather the context that determines what "clear" means here:
- Design context — if the repo carries
PRODUCT.md,DESIGN.md,.impeccable.md, or a## Design Contextblock in.github/copilot-instructions.md, read it for voice and audience. Skip silently if none exist. - Audience — technical level (engineer, general consumer, first-time user) and the user's mental state at this moment (stressed mid-error, confident on success, rushed during checkout). Tone follows from this.
- Existing voice — skim a handful of existing strings in the product so improvements match the established terminology instead of introducing a second dialect.
Assess Current Copy
Identify what makes the text unclear or ineffective: