Claude Skill

ux-product-auditor

Audits a website, app, onboarding flow, or design for usability, conversion, and product problems, tying every finding to a business outcome and a severity. Use this to review an interface, diagnose low conversion or activation, find where users drop off, get structured product f

LLM Mart · 0 points · 16 views 0 listing impressions 0 install-command copies
Virus-scanned Reviewed automatically before listing.

Full trust report

Download cbrock84-headcount-plugins_product_skills_ux-product-auditor-98d1c17.zip · 3 KB
Part of cbrock84/headcount — 160 skills

Install

skills CLI npx skills add https://github.com/cbrock84/headcount/tree/main/plugins/product/skills/ux-product-auditor
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install cbrock84-headcount@llmmart
Git git clone https://github.com/cbrock84/headcount.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole cbrock84/headcount collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

UX and product auditor

A finding that does not name a consequence is an opinion. Every item in an audit connects a specific friction to a specific outcome.

Audit by walking the real path

Do the actual task, on the actual device, as a first-time user with no context — not a tour of the screens. Most serious problems live in transitions between screens, which a screen-by-screen review never sees.

Then walk it again as a returning user, whose needs are opposite: speed over explanation, and recovery from whatever state they left in.

Lenses

Run each separately; combined, you find only what you were already looking for.

  • Comprehension — can a stranger tell what this does and whether it is for them?
  • First value — how many steps to the first genuinely useful moment, and how many are avoidable?
  • Friction — every field, click, decision, and wait. Which are load-bearing and which are habit?
  • Trust — does anything ask for more than it has earned at that point?
  • Recovery — what happens on error, empty, slow, offline, or wrong input?
  • Accessibility — contrast, keyboard reachability, target size, meaning carried by color alone. Below this floor, some people cannot use the product at all.

Severity

Assign one to every finding, and be strict — an audit where everything is critical has ranked nothing:

  • Critical — blocks the primary task, loses data, or excludes a group of users entirely.
  • High — measurably costs conversion or activation for many users.
  • Medium — friction with a workaround, or affects a narrower path.
  • Low — polish, inconsistency, or a preference.

Finding format

Each finding carries: where (the exact screen and step), what the user experiences, why it costs something, the consequence in business terms, severity, and the fix with rough effort.

"The signup form asks for company size before the account exists; users who do not know it guess or abandon; this sits before the only conversion event on the page" is a finding. "Form is too long" is a note.

Diagnosing low conversion or activation

Instrument the funnel to find where, then observe sessions to find why. Analytics say the step; only watching says the reason. Teams that skip the second half fix the wrong thing confidently.

Common causes, in rough order of frequency: asked for too much too early, value not visible before effort is required, an empty state with no path out of it, and a required integration the user cannot authorize.

Scoring

Where a numeric score is useful — tracking over time, comparing surfaces, reporting to someone who did not read the audit — score each lens from one to five against stated criteria, and publish the criteria alongside the score. An unexplained score is unfalsifiable and will be argued with rather than acted on.

Use the same scale everywhere so scores are comparable between audits. Do not average the lenses into one headline number: a product that is excellent everywhere and inaccessible scores well on the average and is still unusable for some people.

Moving from findings to solutions

An audit that stops at problems transfers the hard part back. For each finding above medium severity, propose a specific fix — the actual change, not a direction — with rough effort and what it would improve.

Where several findings share a root cause, say so and propose the one change. Fifteen findings traceable to a missing design system is one finding.

Where the right fix is uncertain, propose the cheapest way to find out rather than guessing.

Prioritizing

Rank by users affected × severity ÷ effort. Then state the one thing to fix first, and be willing to say that most of the list is not worth doing yet. A prioritized audit is more useful than a complete one.

Sources

references/sources.md in this skill lists the outside authorities that settle the questions here — what each one is authoritative for, and what you may do with it. Check them before answering on anything they cover, and cite what you used. Most are free to read and not free to reproduce; the use note on each is binding.

Never

  • Report a finding without the path that produces it. A claim nobody can reproduce gets ignored.
  • Rank findings by how easy they are to fix. Rank by cost to the user, then note which ones are cheap.
  • Audit a staging build or a marketing page that real users never touch.
  • Call a preference a defect. Say what breaks and for whom, or leave it out.
Files (headcount)
  • references
    • sources.md 2.8 KB
      # Sources — `product:ux-product-auditor`
      
      <!-- Generated by scripts/build-sources.py from sources/*.toml. Do not edit. -->
      
      Check these before answering on anything they cover, and cite what you used. The use note on each one is binding: most of what a professional cites is free to read and not free to reproduce.
      
      ## 36 CFR Part 1194 — Section 508 information and communication technology standards
      
      US Access Board · US · public domain (US government) — quote freely
      
      <https://www.ecfr.gov/current/title-36/subtitle-B/chapter-XI/part-1194>
      
      **Authoritative for:** What a product must satisfy to be lawfully procurable by a US federal agency. This decides a public-sector deal rather than expressing a design preference, which is why it reaches sales as often as engineering.
      
      ## CCPA regulations, California Code of Regulations title 11
      
      California Privacy Protection Agency · US-CA · public domain — quote freely
      
      <https://cppa.ca.gov/regulations/consumer_privacy_act.html>
      
      **Authoritative for:** Symmetry in choice, as law. It settles whether a consent flow where accepting is one click and declining is three is permissible — converting what is usually argued as design taste into a compliance question.
      
      ## EN 301 549 — accessibility requirements for ICT products and services
      
      ETSI · EU · **read and cite only — copyrighted, do not reproduce**
      
      <https://www.etsi.org/deliver/etsi_en/301500_301599/301549/03.02.01_60/en_301549v030201p.pdf>
      
      **Authoritative for:** The requirement set an EU public-sector buyer measures against, including non-web software, documents and hardware that the web guidelines do not cover. Which version is legally operative depends on what the Official Journal currently cites — check before relying on a newer one.
      
      ## WAI-ARIA and the ARIA Authoring Practices Guide
      
      World Wide Web Consortium · global · **read and cite only — copyrighted, do not reproduce**
      
      <https://www.w3.org/WAI/ARIA/apg/>
      
      Machine-readable: <https://www.w3.org/TR/wai-aria-1.2/>
      
      **Authoritative for:** Which roles, states and keyboard interactions a given widget must implement. Settles whether Escape should close a dialog and whether a role is the right one, without appeal to preference.
      
      ## Web Content Accessibility Guidelines 2.2
      
      World Wide Web Consortium · global · **read and cite only — copyrighted, do not reproduce**
      
      <https://www.w3.org/TR/WCAG22/>
      
      **Authoritative for:** Whether a page, email or video is accessible. It is the criteria list that US Section 508, the EU's EN 301 549 and most enterprise procurement point at, so it settles any argument that reaches a buyer's accessibility requirement.
      
      ---
      
      Sources are maintained in `sources/` upstream, not here. If one is wrong, out of date, or missing, fix it there — this file is regenerated and an edit to it is lost.
      
  • SKILL.md 4.9 KB
    ---
    name: ux-product-auditor
    description: Audits a website, app, onboarding flow, or design for usability, conversion, and product problems, tying every finding to a business outcome and a severity. Use this to review an interface, diagnose low conversion or activation, find where users drop off, get structured product feedback, or decide which UX fixes to ship first. For raising visual quality rather than finding problems, use `interface-craft`.
    ---
    
    # UX and product auditor
    
    A finding that does not name a consequence is an opinion. Every item in an audit connects a specific
    friction to a specific outcome.
    
    ## Audit by walking the real path
    
    Do the actual task, on the actual device, as a first-time user with no context — not a tour of the
    screens. Most serious problems live in transitions between screens, which a screen-by-screen review
    never sees.
    
    Then walk it again as a returning user, whose needs are opposite: speed over explanation, and
    recovery from whatever state they left in.
    
    ## Lenses
    
    Run each separately; combined, you find only what you were already looking for.
    
    - **Comprehension** — can a stranger tell what this does and whether it is for them?
    - **First value** — how many steps to the first genuinely useful moment, and how many are avoidable?
    - **Friction** — every field, click, decision, and wait. Which are load-bearing and which are
      habit?
    - **Trust** — does anything ask for more than it has earned at that point?
    - **Recovery** — what happens on error, empty, slow, offline, or wrong input?
    - **Accessibility** — contrast, keyboard reachability, target size, meaning carried by color alone.
      Below this floor, some people cannot use the product at all.
    
    ## Severity
    
    Assign one to every finding, and be strict — an audit where everything is critical has ranked
    nothing:
    
    - **Critical** — blocks the primary task, loses data, or excludes a group of users entirely.
    - **High** — measurably costs conversion or activation for many users.
    - **Medium** — friction with a workaround, or affects a narrower path.
    - **Low** — polish, inconsistency, or a preference.
    
    ## Finding format
    
    Each finding carries: **where** (the exact screen and step), **what** the user experiences, **why**
    it costs something, **the consequence** in business terms, **severity**, and **the fix** with rough
    effort.
    
    "The signup form asks for company size before the account exists; users who do not know it guess or
    abandon; this sits before the only conversion event on the page" is a finding. "Form is too long" is
    a note.
    
    ## Diagnosing low conversion or activation
    
    Instrument the funnel to find *where*, then observe sessions to find *why*. Analytics say the step;
    only watching says the reason. Teams that skip the second half fix the wrong thing confidently.
    
    Common causes, in rough order of frequency: asked for too much too early, value not visible before
    effort is required, an empty state with no path out of it, and a required integration the user
    cannot authorize.
    
    ## Scoring
    
    Where a numeric score is useful — tracking over time, comparing surfaces, reporting to someone who
    did not read the audit — score each lens from one to five against stated criteria, and publish the
    criteria alongside the score. An unexplained score is unfalsifiable and will be argued with rather
    than acted on.
    
    Use the same scale everywhere so scores are comparable between audits. Do not average the lenses
    into one headline number: a product that is excellent everywhere and inaccessible scores well on the
    average and is still unusable for some people.
    
    ## Moving from findings to solutions
    
    An audit that stops at problems transfers the hard part back. For each finding above medium
    severity, propose a specific fix — the actual change, not a direction — with rough effort and what
    it would improve.
    
    Where several findings share a root cause, say so and propose the one change. Fifteen findings
    traceable to a missing design system is one finding.
    
    Where the right fix is uncertain, propose the cheapest way to find out rather than guessing.
    
    ## Prioritizing
    
    Rank by users affected × severity ÷ effort. Then state the one thing to fix first, and be willing to
    say that most of the list is not worth doing yet. A prioritized audit is more useful than a complete
    one.
    
    ## Sources
    
    `references/sources.md` in this skill lists the outside authorities that settle the questions
    here — what each one is authoritative for, and what you may do with it. Check them before
    answering on anything they cover, and cite what you used. Most are free to read and not free
    to reproduce; the use note on each is binding.
    
    ## Never
    
    - Report a finding without the path that produces it. A claim nobody can reproduce gets ignored.
    - Rank findings by how easy they are to fix. Rank by cost to the user, then note which ones are cheap.
    - Audit a staging build or a marketing page that real users never touch.
    - Call a preference a defect. Say what breaks and for whom, or leave it out.
    

Comments (0)

Sign in to join the conversation.

No comments yet.

Reviews (0)

No reviews yet.

Related