How-to · Design & Creative · By JR Brugger (Design Workflow)

How to use Heuristic Evaluation in your AI agent

Install and use the Heuristic Evaluation skill in Claude Code, Cursor, Codex, Gemini CLI, OpenCode, and Windsurf — with sample prompts.

What you'll get

This skill conducts systematic usability evaluations of digital interfaces using Nielsen's 10 Usability Heuristics—the gold standard for finding UX problems before user testing. It walks through your screens and flows, identifies issues, rates their severity, and provides specific recommendations. Perfect for PMs, designers, and founders who want to catch usability problems early.

Step 1 — Get the skill source URL

The Heuristic Evaluation skill lives at:

Step 2 — Add it to your AI agent

Copy one of these prompts and paste it into your AI tool. The agent will fetch and install the skill for you.

Claude Code

Add the agent skill from https://github.com/jrbrugger/design-workflow/tree/main/designer-skills-main/prototyping-testing/skills/heuristic-evaluation to my project.

Cursor

Install this agent skill: https://github.com/jrbrugger/design-workflow/tree/main/designer-skills-main/prototyping-testing/skills/heuristic-evaluation

Codex

Add this skill to .codex/skills/: https://github.com/jrbrugger/design-workflow/tree/main/designer-skills-main/prototyping-testing/skills/heuristic-evaluation

Gemini CLI

Add the skill at https://github.com/jrbrugger/design-workflow/tree/main/designer-skills-main/prototyping-testing/skills/heuristic-evaluation to my .gemini/skills/ directory.

OpenCode

Install this agent skill from https://github.com/jrbrugger/design-workflow/tree/main/designer-skills-main/prototyping-testing/skills/heuristic-evaluation

Windsurf

Add this skill: https://github.com/jrbrugger/design-workflow/tree/main/designer-skills-main/prototyping-testing/skills/heuristic-evaluation

Step 3 — Try these prompts

Once the skill is installed, ask your AI things like:

  • About to launch and want to catch UX issues before users do
  • Prioritize design improvements with limited resources
  • You want expert feedback on a prototype or new feature
  • Preparing for user testing and want to fix obvious problems first

What this skill does

  • Evaluates your interface against 10 proven usability heuristics like system visibility, error prevention, and consistency
  • Documents each issue with severity ratings from cosmetic to critical
  • Provides specific recommendations for fixing each problem found
  • Reviews both new user and experienced user perspectives
  • Prioritizes findings so you know what to fix first
Made byJR Brugger (Design Workflow)
CategoryDesign & Creative