MCPInstall

heuristic-evaluation-ai

Adapting Nielsen's heuristics and new AI-specific heuristics for AI interfaces.

Installs
127
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/owl-listener/ai-design-skills --skill heuristic-evaluation-ai
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads heuristic-evaluation-ai automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Heuristic Evaluation for AI

Nielsen's 10 usability heuristics were designed for traditional software. AI products need adapted heuristics that address the unique challenges of probabilistic, generative, and conversational systems.

Classic Heuristics, Adapted for AI

1. Visibility of system status AI adaptation: The user should always know what the AI is doing, what it's working with, and how confident it is. Progress indicators for generation. Transparency about data sources. 2. Match between system and real world AI adaptation: The AI should use language and concepts the user understands. Don't expose model internals. Frame capabilities in terms of user tasks, not technical features. 3. User control and freedom AI adaptation: Users must be able to stop generation, undo AI actions, edit outputs, and override suggestions. AI autonomy should always have an exit. 4. Consistency and standards AI adaptation: The AI should behave consistently across similar requests. Same input type should produce same output format. Persona should be stable. 5. Error prevention AI adaptation: Design prompts and interfaces that guide users toward effective interactions. Suggest clarifications before producing low-quality output. 6. Recognition rather than recall AI adaptation: Show users what the AI can do rather than requiring them to discover commands. Surface relevant capabilities contextually. 7. Flexibility and efficiency of use AI adaptation: Support both novice (guided) and expert (shortcut) interaction modes. Power users should be able to customise AI behavior. 8. Aesthetic and minimalist design AI adaptation: AI outputs should be concise and well-structured. Don't pad responses with unnecessary caveats or filler. 9. Help users recognise, diagnose, and recover from errors AI adaptation: When the AI fails, explain what went wrong in user terms, not technical terms. Offer clear recovery paths. 10. Help and documentation AI adaptation: Provide contextual guidance on how to interact with the AI effectively. Teach prompting skills through the interface.

AI-Specific Heuristics

Beyond the classic 10, AI products need evaluation against:

  • Calibrated trust: Does the interface help users trust the AI appropriately — neither too much nor too little?
  • Graceful degradation: When the AI can't fully help, does it partially help rather than failing completely?
  • Feedback effectiveness: Can users correct the AI easily, and does the AI adapt?
  • Transparency of limitations: Are the AI's boundaries clear before the user hits them?
  • Appropriate autonomy: Does the AI take the right amount of initiative for the task and context?

Running an AI Heuristic Evaluation

  1. Select 3-5 evaluators with AI product experience
  2. Define the scope (which features, which user tasks)
  3. Each evaluator independently works through the heuristics
  4. Capture issues with severity ratings
  5. Consolidate findings and prioritise

Design Artefacts

  • AI heuristic checklist (adapted classics + AI-specific)
  • Evaluation protocol and scoring rubric
  • Issue severity classification guide
  • Heuristic evaluation report template
  • Prioritised findings matrix

FAQ

What does the heuristic-evaluation-ai skill do?

Adapting Nielsen's heuristics and new AI-specific heuristics for AI interfaces.

How do I install heuristic-evaluation-ai?

Run npx skills add https://github.com/owl-listener/ai-design-skills --skill heuristic-evaluation-ai in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/heuristic-evaluation-ai/ (personal) or .claude/skills/heuristic-evaluation-ai/ (project).

Which AI agents can use heuristic-evaluation-ai?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is heuristic-evaluation-ai safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains heuristic-evaluation-ai?

It is published by owl-listener in owl-listener/ai-design-skills. It has 127 recorded installs.

More from owl-listener/ai-design-skills

View all →

system-prompt-structure

owl-listener/ai-design-skills

Anatomy of effective system prompts — role, context, constraints, format.

AI & Agents456 installs

guardrail-design

owl-listener/ai-design-skills

Open the skill to read its SKILL.md instructions.

391 installs

constraint-specification

owl-listener/ai-design-skills

Defining output format, length, tone, and content boundaries within prompts.

AI & Agents375 installs

generative-ui

owl-listener/ai-design-skills

Designing interfaces where AI generates UI components dynamically.

Frontend & Design335 installs

conversation-patterns

owl-listener/ai-design-skills

Turn-taking, repair sequences, grounding, and dialogue structure for human-AI interaction.

328 installs

progressive-disclosure

owl-listener/ai-design-skills

Revealing AI capability gradually to match user mental models.

319 installs

Popular other skills

View category →

hyperframes-cli

heygen-com/hyperframes

The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.

1.3M installs

triage

mattpocock/skills

Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs