← Back to Skills Marketplace
dawen-ye

nielsen-ui-review

by Dawen-Ye · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
173
Downloads
1
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install ui-review
Description
Run a structured UI/UX heuristic review based on Nielsen's 10 usability principles for screenshots, mockups, wireframes, product pages, app screens, and desi...
README (SKILL.md)

Nielsen UI Review

Review a UI image through the lens of usability, not personal visual taste. Gather minimal context first, then produce a structured review based on Nielsen's 10 heuristics.

Core Behavior

  • Start from the screenshot and any user-provided description.
  • Ask a short clarification round before making strong judgments.
  • Prefer multiple-choice options over open-ended questions.
  • If the user skips clarification, state assumptions and continue.
  • Separate visible evidence from inference.
  • Prioritize issues that affect task success, comprehension, trust, and error risk.
  • Give concrete recommendations tied to specific UI elements.
  • Do not force issues into every heuristic if no issue is visible.

Workflow

  1. Inspect the screenshot.
  2. Infer the likely screen type, platform, and primary task.
  3. Ask 3 to 5 concise clarification questions.
  4. Wait for answers if the user responds.
  5. If the user does not respond, proceed with explicit assumptions.
  6. Review the screen against Nielsen's 10 heuristics.
  7. Summarize the most important issues first.
  8. End with prioritized, actionable recommendations.

Inspect First

Identify, if possible:

  • Screen type: landing page, dashboard, form, checkout, settings, modal, onboarding, detail page, empty state, error state
  • Platform: web, mobile, desktop, internal tool, consumer app
  • Primary task: understand, compare, fill, submit, purchase, manage, configure, navigate
  • Main hierarchy: title, key content, main CTA, secondary CTA, navigation, warnings, helper content
  • Missing context: whether this is one state in a larger flow, whether content is real or placeholder, whether loading/success/error states exist elsewhere

If the screenshot is blurry, cropped, or too partial for high-confidence review, say so before continuing.

Clarification Round

Ask 3 to 5 questions. Keep them short. Use options when possible. End with:

If you're not sure, I can still do a first-pass review based on the screenshot and make my assumptions explicit.

Default Question Bank

Pick the most relevant questions from this list:

  1. Product goal
  • Increase conversion
  • Improve task completion
  • Reduce comprehension effort
  • Increase trust
  • Strengthen brand perception
  1. Target user
  • First-time users
  • Returning users
  • Expert users
  • General consumers
  • Internal employees
  • Admin or operations users
  1. Primary task on this screen
  • Understand information
  • Click the main CTA
  • Complete a form
  • Reduce mistakes
  • Compare options
  • Manage data or settings
  1. Business priority
  • Conversion
  • Completion rate
  • Feature adoption
  • Trust
  • Self-service resolution
  • Retention
  1. Usage context
  • First use
  • Frequent daily use
  • Urgent task
  • Mobile quick session
  • Desktop focused work
  1. Constraints
  • Must follow current design system
  • Copy cannot change much
  • Layout cannot change much
  • Business content must stay prominent
  • Large redesign is acceptable

Image-Driven Questions

Add 1 or 2 screenshot-specific questions only if they materially affect the review. Example questions:

  • Is this the main action you want users to take on this screen?
  • Are these numbers or labels real content or placeholders?
  • Is this screen for first-time users or experienced users?
  • Are loading, success, and error states missing from this screenshot?
  • Have users already completed earlier steps before reaching this screen?

If No Clarification Arrives

Continue with a short assumption block such as:

This review is based on the visible screenshot only. I am assuming this is a primary task screen, the visible copy is intentional, and the goal is to help users complete the main action with low confusion.

Review Standard

Judge usability, not taste.

Do:

  • Point to specific UI elements
  • Explain why the issue matters
  • Link the issue to user behavior or business risk
  • Suggest a concrete fix

Do not:

  • Give vague comments like "the hierarchy feels weak"
  • Over-index on aesthetics without user impact
  • Assume business intent that was not stated
  • Invent hidden states or flows without labeling them as assumptions

Nielsen Heuristics

Review the screen against these heuristics:

  1. Visibility of system status
  • Check whether current state, progress, loading, success, error, selection, and save status are visible.
  1. Match between system and real world
  • Check whether labels, icons, grouping, and wording match user mental models.
  1. User control and freedom
  • Check whether users can go back, cancel, close, undo, revise, or recover.
  1. Consistency and standards
  • Check whether visual and interaction patterns are internally consistent and aligned with common conventions.
  1. Error prevention
  • Check whether the UI helps prevent mistakes before they happen.
  1. Recognition rather than recall
  • Check whether the UI exposes choices and guidance rather than making users remember rules or previous information.
  1. Flexibility and efficiency of use
  • Check whether the layout supports both new and experienced users with reasonable speed.
  1. Aesthetic and minimalist design
  • Check whether the screen is focused and free from distracting or redundant content.
  1. Help users recognize, diagnose, and recover from errors
  • Check whether the UI explains errors clearly and provides recovery paths.
  1. Help and documentation
  • Check whether the UI provides the right amount of guidance, helper text, onboarding cues, or explanation.

Severity

Assign one severity per issue:

  • High: blocks or strongly harms the main task
  • Medium: adds friction, hesitation, or cognitive load
  • Low: polish, consistency, or secondary efficiency issue

Optionally add confidence:

  • High confidence
  • Medium confidence
  • Low confidence

Use confidence only when the screenshot is ambiguous.

Output Format

Use this exact structure unless the user asks for another format.

Context Summary

Summarize:

  • what the screen appears to be
  • what the main user task appears to be
  • what the user confirmed
  • what remains uncertain

Assumptions

List the assumptions used to proceed.

Top Findings

List the 3 to 5 most important findings first. For each finding, include:

  • Heuristic
  • Severity
  • Observation
  • Why it matters
  • Recommendation

Heuristic Review

Cover all 10 heuristics briefly.

For heuristics with a real issue or strength, include:

  • Observation
  • Risk or benefit
  • Recommendation

If no clear issue is visible, write: No obvious issue detected from the screenshot.

Priority Actions

End with:

  1. Fix first
  2. Improve next
  3. Nice-to-have refinements

Make each action concrete.

Open Questions

List any remaining questions that would meaningfully change the review.

Response Style

Keep the tone:

  • direct
  • specific
  • calm
  • product-aware
  • actionable

Prefer statements like:

  • The primary CTA does not visually stand apart from secondary actions, which may slow decision-making.
  • The form asks users to remember earlier information instead of showing it at the point of action.
  • The error recovery path is unclear because the screen shows a warning without a next step.

Avoid statements like:

  • The design feels average.
  • The hierarchy could be better.
  • This looks nicer if...
  • The UI is not premium enough.

Default Opening Prompt

Use a short opening like this:

I'll start with a usability review based on the screenshot. To make the feedback more relevant, please pick the closest options below.

  1. Product goal
  • Increase conversion
  • Improve task completion
  • Reduce comprehension effort
  • Increase trust
  1. Target user
  • First-time users
  • Returning users
  • Expert users
  • General consumers
  • Internal employees
  1. Primary task on this screen
  • Understand information
  • Click the main CTA
  • Complete a form
  • Compare options
  • Reduce mistakes
  1. Business priority
  • Conversion
  • Completion rate
  • Feature adoption
  • Trust
  • Retention

If you're not sure, I can still do a first-pass review based on the screenshot and make my assumptions explicit.

Final Check

Before sending the review, verify:

  • A clarification round happened first
  • Facts and assumptions are clearly separated
  • The top findings are prioritized
  • All 10 heuristics were covered
  • Recommendations are concrete and tied to visible UI elements
  • The review focuses on usability impact, not personal taste
Usage Guidance
This skill appears coherent and low-risk, but be mindful when sharing screenshots: redact or remove passwords, tokens, user PII, or other sensitive data before upload. Confirm where images will be processed/stored (local vs cloud) according to your agent/platform privacy settings. When you request a review, answer the short clarification questions or accept the skill's stated assumptions so findings are appropriately targeted.
Capability Analysis
Type: OpenClaw Skill Name: ui-review Version: 1.0.0 The skill bundle is a legitimate tool designed to perform UI/UX heuristic evaluations based on Nielsen's 10 usability principles. The instructions in SKILL.md provide a structured workflow for analyzing screenshots, asking clarifying questions, and generating prioritized recommendations without any evidence of data exfiltration, malicious execution, or prompt injection attacks.
Capability Assessment
Purpose & Capability
The name/description promise a heuristic UI review and the SKILL.md contains detailed step-by-step guidance for performing that review. There are no unrelated requirements (no credentials, binaries, or config paths) that would be disproportionate to a UI review task.
Instruction Scope
Instructions are narrowly scoped to inspecting a provided screenshot, asking clarifying questions, and producing findings mapped to Nielsen's heuristics. The skill does not instruct the agent to read unrelated files, access environment variables, or transmit data to unexpected endpoints. It does advise making explicit assumptions if the user doesn’t respond.
Install Mechanism
No install spec or code files are present; this is instruction-only so nothing is written to disk or fetched during install. That minimizes installation risk.
Credentials
The skill declares no required environment variables, credentials, or config paths. The only input expected is user-provided screenshots and minimal context questions, which is proportionate to the stated purpose. Note: screenshots can contain sensitive data—see user guidance.
Persistence & Privilege
always is false and the skill does not request persistent system-wide privileges or config changes. disable-model-invocation is false (normal), so the agent could invoke the skill autonomously per platform defaults, but that is not unusual for a user-invocable skill and is not combined with other red flags here.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ui-review
  3. After installation, invoke the skill by name or use /ui-review
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of nielsen-ui-review: a structured UI/UX heuristic review skill based on Nielsen's 10 usability principles. - Guides users through a concise clarification round using selectable options before reviewing UI screenshots. - Systematically evaluates interfaces against all 10 Nielsen heuristics, focusing on usability impact rather than visual taste. - Provides prioritized, actionable findings and recommendations for each review. - Explicitly separates visible evidence from assumed context. - Offers clear severity ratings and confidence levels for each issue. - Outlines a consistent, structured report format for all reviews.
Metadata
Slug ui-review
Version 1.0.0
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is nielsen-ui-review?

Run a structured UI/UX heuristic review based on Nielsen's 10 usability principles for screenshots, mockups, wireframes, product pages, app screens, and desi... It is an AI Agent Skill for Claude Code / OpenClaw, with 173 downloads so far.

How do I install nielsen-ui-review?

Run "/install ui-review" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is nielsen-ui-review free?

Yes, nielsen-ui-review is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does nielsen-ui-review support?

nielsen-ui-review is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created nielsen-ui-review?

It is built and maintained by Dawen-Ye (@dawen-ye); the current version is v1.0.0.

💬 Comments