UX Clarity Refactor
Designux-clarity-refactorUX Clarity Refactor is an Agent Skill for design published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
General UX/UI refactor patterns for dense information products, including layout compression, view-mode clarity, selection-to-results flow, research workspace design (non-chat), and enforcing a no-emoji UI policy. Use when restructuring existing UIs for clarity while preserving all features.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/majiayu000/claude-skill-registry/blob/HEAD/skills/design/ux-clarity-refactor-benderfendor-thesis/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/ux-clarity-refactor, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
UX Clarity Refactor
Use this workflow
- Audit the current UI
- List primary user tasks and critical features that must remain.
- Map the main views/modes and the current navigation paths.
- Identify where vertical space is being spent without adding value.
- Apply layout compression
- Replace oversized hero blocks with a compact summary + actions row.
- Move long descriptive copy into a short paragraph or collapsible panel.
- Use a split layout: primary content on the left, compact summary cards on the right.
- Clarify view modes
- Separate mode switching (globe/grid/scroll) from filter controls.
- Add a view header that states what is being shown, and why.
- Show quantitative context (article count, source count, filters active).
- Improve selection-to-results flow
- A selection should update a dedicated context panel instantly.
- Always show the selected state and a single clear action to reset.
- Order results by importance: top sources first, then top articles.
- Build research workspaces (non-chat)
- Use an input bar at the top.
- Output in two columns: Brief on the left, Evidence/Steps on the right.
- Provide a Flow view that shows reasoning steps in sequence.
- Keep chat history optional and secondary (sidebar or history tab).
- Enforce the no-emoji rule
- Remove emojis from UI text, logs, and docs.
- Replace with icons, bullets, or plain text labels.
- Scan the repo for emojis using ripgrep and clean all hits.
References
- See
references/patterns.mdfor compact layout patterns, status display conventions, and sample copy rules.