OpenParable
Skip to content
← Back to skills

UX Clarity Refactor

Design
ux-clarity-refactor

UX 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. 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

  1. 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.
  1. 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.
  1. 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).
  1. 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.
  1. 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).
  1. 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.md for compact layout patterns, status display conventions, and sample copy rules.