agentleFS
varunk130varunk130/claude-code-skills/skills/ai-ux-design/ai-ux-audit/SKILL.md

ai-ux-audit

Skill1 starsChanged 21 days agoMITView on GitHub

Runs a scored heuristic audit of an Artificial Intelligence (AI) feature across six AI-specific dimensions - transparency, control, feedback, error recovery, expectation-setting, and trust calibration - and produces a severity-ranked fix list with owners. Use when reviewing an AI feature before launch; diagnosing low adoption or high abandonment of a copilot or agent; benchmarking an AI experience against competitors; or preparing a design review for a Large Language Model (LLM) feature.

The file

We split this skill into the rules it gives an agent

3 rules. About 0 are common, 3 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈3

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    No baseline to show whether the next release improved the experience

    line 20
  2. Distinctive:

    Run every stress scenario, including a seeded wrong output

    line 126
  3. Distinctive:

    Treat a disclaimer as sufficient trust calibration

    line 134

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

AI UX Audit

Classic usability heuristics miss the ways AI features fail. This audit scores the ones that matter.

What this skill is

A structured heuristic evaluation built for probabilistic products. It scores an Artificial Intelligence (AI) feature on six dimensions that standard heuristics underweight, walks the feature through a fixed set of stress scenarios (not just the happy path), and converts findings into a severity-ranked fix list. The result is a defensible score a team can track release over release.

What it solves

  • Design reviews that only evaluate the happy-path demo output
  • AI features that look polished but leave users unable to correct, undo, or verify results
  • Over-trust (users accept wrong answers) and under-trust (users redo the work manually) going unmeasured
  • Fix lists with no severity logic, so cosmetic issues crowd out trust-breaking ones
  • No baseline to show whether the next release improved the experience

When to invoke

  • Pre-launch review of a copilot, assistant, agent, or generative feature
  • Adoption is flat or users try the feature once and stop
  • Support tickets mention "it made something up" or "I could not undo it"
  • Competitive teardown of AI experiences in your category
  • Quarterly AI experience health check

Phase 1: Scope the feature and its job

Document before scoring:

FieldExample
Feature and surfaceInline drafting assistant in the ticket editor
User and jobSupport agent replying to a billing dispute
AI roleSuggests / drafts / acts (see agent-autonomy-level-mapper)
Stakes of a wrong outputLow / Medium / High / Critical
Model inputs the user can seeTicket thread, customer plan, prior replies
Success definitionReply sent with under 2 minutes of edits

Stakes set the bar. A Critical-stakes feature needs a higher score to pass than a Low-stakes one.

Phase 2: Run the stress scenarios

Walk the feature through each scenario and capture screenshots or transcripts. A heuristic that is never stressed cannot be scored.

#ScenarioWhat it reveals
S1Ideal input, clear requestBaseline quality and polish
S2Ambiguous or underspecified requestClarification behavior
S3Request outside capability or policyRefusal and redirection
S4Plausible but wrong output (seed one if needed)Whether users can detect and fix errors
S5Slow response or timeoutLatency and progress handling
S6User wants to change or undo the resultControl and reversibility
S7Returning user, second sessionMemory, continuity, expectation drift

Phase 3: Score the six dimensions

Score each dimension 0-4 using the anchors below.

Dimension0 - Absent2 - Partial4 - Strong
TransparencyNo signal that AI produced the outputAI labeled, but inputs and sources hiddenUser sees what the AI used and why, at the moment of decision
ControlOutput is final or applied silentlyCan edit, but cannot steer, retry, or undoEdit, regenerate with direction, undo, and turn off
FeedbackNo way to signal qualityThumbs up/down with no visible effectSpecific feedback that changes the next output or is acknowledged
Error recoveryFailures are dead ends or silentGeneric error with retryFailure named, partial work preserved, next best action offered
Expectation-settingNo guidance on what it can doGeneric "Ask me anything"Capabilities, limits, and good inputs shown in context
Trust calibrationUniform confidence regardless of qualityDisclaimers onlyConfidence varies with evidence; verification is cheap where stakes are high

Weight by stakes:

Weighted score = sum(dimension score x weight) / (4 x sum(weights)) x 100
Default weights: Error recovery 1.5, Trust calibration 1.5, Control 1.25, others 1.0
For High or Critical stakes: raise Trust calibration and Error recovery to 2.0
ScoreRatingLaunch guidance
85-100StrongShip
70-84AdequateShip with fixes scheduled
50-69WeakFix Severity 1 and 2 before broad release
Under 50FailingDo not ship; redesign

Any dimension scored 0 on a High or Critical-stakes feature is an automatic launch blocker.

Phase 4: Log and rate findings

For each issue, record scenario, dimension, evidence, and severity:

SeverityDefinitionExample
1 - Trust-breakingUser acts on wrong output without a reasonable chance to notice, or loses workAgent sends email with invented refund amount
2 - Task-blockingUser cannot complete the job or recover without leaving the featureTimeout clears the draft
3 - FrictionJob completes, but with avoidable effort or confusionMust retype the whole prompt to adjust tone
4 - PolishCosmetic or consistency issueInconsistent "AI" labeling across surfaces
Priority = Severity weight (1=8, 2=4, 3=2, 4=1) x Frequency (1-3) x Reach (1-3)

Phase 5: Build the fix list

Rank by priority. For each fix specify the pattern, not just the problem:

RankFindingDimensionSeverityRecommended patternOwnerEffort
1Design / Eng / ModelS / M / L

Separate fixes into interface fixes (design and front end), behavior fixes (prompting, retrieval, tool logic), and policy fixes (what the AI should not do). Teams often assign model-behavior problems to design, or the reverse.

Output

  • Feature scope card with stakes rating
  • Scenario evidence log (S1-S7) with screenshots or transcripts
  • Six-dimension scorecard with weighted score and rating
  • Severity-ranked fix list split into interface, behavior, and policy fixes
  • Launch recommendation with explicit blockers
  • Re-audit baseline for the next release

Operating rules

Always

  • Run every stress scenario, including a seeded wrong output
  • Set stakes before scoring and adjust weights accordingly
  • Cite evidence (screenshot, transcript, step) for every score below 4
  • Recommend a concrete pattern for each fix
  • Re-score against the same scenarios after fixes ship

Never

  • Score from a scripted demo or marketing video
  • Treat a disclaimer as sufficient trust calibration
  • Average away a 0 on a high-stakes dimension
  • Mix model-quality complaints with interface issues in one undifferentiated list
  • Count "users can thumbs-down it" as error recovery

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.