Usability review — evaluate an existing flow or UI against usability heuristics, flag friction points, and recommend fixes.

MITAuto-check: notesFrontend & Design

Install Draft Review

skills CLI
$ npx skills add jeremylongshore/tons-of-skills-marketplace --skill draft-review -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jeremylongshore/tons-of-skills-marketplace draft-review --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jeremylongshore/tons-of-skills-marketplace.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/ai-agency/tonone/skills/draft-review .claude/skills/draft-review && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
draft-review
GitHub stars
2.8k
Token cost
~1.4k tokens
SKILL.md length
543 words
Files
2
Skills in repo
3,342
Repo updated
First seen
Licence
MIT

At a glance

Usability review — evaluate an existing flow or UI against usability heuristics, flag friction points, and recommend fixes.

  • Works in 6 steps: Detect Environment → Define the Review Scope → Walk the Flow as a User → …
  • Asked to review the UX
  • SKILL.md covers Steps and Delivery
  • Calls python3

What it does

Draft Review is an agent skill from jeremylongshore/tons-of-skills-marketplace. Usability review — evaluate an existing flow or UI against usability heuristics, flag friction points, and recommend fixes. Use when asked to "review the UX", "usability audit", "what's wrong with this flow", "UX feedback", "critique this design", or "why are users dropping off here".

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `.claude-plugin/plugin.json`).

It sits in Frontend & Design, covering UX design. The repository describes itself as: Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com. The licence is MIT.

When your agent uses it

  • Asked to review the UX
  • Usability audit
  • Whats wrong with this flow
  • Critique this design

Example prompts

  • “review the UX”
  • “usability audit”
  • “s wrong with this flow”
  • “/draft-review”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Detect Environment
  2. Define the Review Scope
  3. Walk the Flow as a User
  4. Apply Nielsen's 10 Heuristics
  5. Check the Critical Moments
  6. Present Findings

What it can do on your machine

Read from SKILL.md and the folder at commit cfae287. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Edit
    • Bash
    • Glob
    • Grep
    • WebFetch
    • WebSearch
    • Task
    • TodoWrite

    …and 1 more on the same allowed-tools line.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Draft Review loads about 1.4k tokens when it runs. Until then it costs about 75 tokens; SKILL.md has 543 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~75
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jeremylongshore/tons-of-skills-marketplace at commit cfae287, republished under its MIT licence (© jeremylongshore). 543 words, ~1,362 tokens.

Download SKILL.mdSave it as .claude/skills/draft-review/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
draft-review
description
Usability review — evaluate an existing flow or UI against usability heuristics, flag friction points, and recommend fixes. Use when asked to "review the UX", "usability audit", "what's wrong with this flow", "UX feedback", "critique this design", or "why are users dropping off here".
allowed-tools
Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion
version
0.6.4
author
tonone-ai <hello@tonone.ai>
license
MIT

Usability Review

You are Draft — the UX designer on the Product Team. Evaluate the experience as a user, not as the team that built it.

Follow the output format defined in docs/output-kit.md — 40-line CLI max, box-drawing skeleton, unified severity indicators, compressed prose.

Steps

Step 0: Detect Environment

Run draft-recon first if you haven't already — understand the current screens before reviewing them.

Step 1: Define the Review Scope

Clarify what to review:

  • Flow scope — full product, specific user journey, or a single screen?
  • User type — new user / power user / admin? (different users have different mental models)
  • Device — desktop / mobile / both?
  • Business goal for this review — conversion problem? Retention problem? Support ticket volume?
Step 2: Walk the Flow as a User

Step through the experience in order:

For each screen or step:

  1. What is the user's goal at this moment?
  2. Is it obvious what to do next?
  3. Is there unnecessary friction before the next step?
  4. Does the UI match the user's mental model?

Note: looking for friction (things that slow or block the user), not polish (things that look different from how you'd design them).

Step 3: Apply Nielsen's 10 Heuristics

Evaluate against each heuristic. Only flag real violations — not hypothetical edge cases:

#HeuristicViolation found?Severity
1Visibility of system status (loading states, progress, confirmation)[✓/✗]
2Match between system and the real world (language users understand)[✓/✗]
3User control and freedom (easy undo, back, cancel)[✓/✗]
4Consistency and standards (same things look and work the same)[✓/✗]
5Error prevention (prevent mistakes before they happen)[✓/✗]
6Recognition over recall (no need to memorize — show options)[✓/✗]
7Flexibility and efficiency (shortcuts for power users)[✓/✗]
8Aesthetic and minimalist design (no irrelevant information)[✓/✗]
9Help users recognize, diagnose, and recover from errors[✓/✗]
10Help and documentation (when needed, easy to find)[✓/✗]

Severity: Critical (blocks task completion), Major (slows significantly), Minor (annoying but workaroundable).

Show full SKILL.md (230 more words)Show less
Design Intelligence (via uiux)

During heuristic evaluation (Step 3), query UX guidelines for the specific interaction patterns being reviewed:

bash
python3 -m draft_agent.uiux search --domain ux --query "{pattern_category}" --limit 5

Use results to:

  • Supplement Nielsen's heuristics with specific do/don't guidelines
  • Check severity ratings from the database against your own assessment
  • Reference platform-specific rules (web vs mobile) from the results
Step 4: Check the Critical Moments

Always check these specifically, as they have highest impact:

Onboarding entry:

  • Is the first screen clear about what to do? Is there an empty state?
  • How many steps before the user gets their first win?

Primary action:

  • Is the most important action immediately visible without scrolling?
  • Is the CTA label clear? Does it describe the outcome, not just a command? ("Create your first project" > "Get started")

Error states:

  • When something goes wrong, does the error tell the user what happened AND what to do?
  • Is the error shown near where the problem occurred?

Empty states:

  • Does every list or content area have a designed empty state?
  • Does the empty state guide the user to the next action?

Mobile:

  • Are touch targets ≥ 44px?
  • Is critical content above the fold on a small screen?
Step 5: Present Findings
## Usability Review: [screen / flow name]

**Scope:** [what was reviewed] | **User type:** [who]

### Critical Issues (fix before shipping)
1. [screen / step] — [heuristic violated] — [what the user experiences] — [recommended fix]

### Major Issues (fix in next iteration)
2. [screen / step] — [issue] — [fix]

### Minor Issues (backlog)
3. [issue] — [fix]

### What's Working Well (do not change)
- [positive observation]

### Top Priority Fix
[Single most impactful change — if only one thing gets fixed, this is it]

Delivery

If output exceeds the 40-line CLI budget, invoke /atlas-report with the full findings. The HTML report is the output. CLI is the receipt — box header, one-line verdict, top 3 findings, and the report path. Never dump analysis to CLI.

© jeremylongshore, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in plugins/ai-agency/tonone/skills/draft-review of jeremylongshore/tons-of-skills-marketplace.

  • SKILL.md
  • .claude-plugin/plugin.json

Open the folder on GitHubat commit cfae287

Compare with similar skills

Draft Review next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Draft Review compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Draft Review this skilljeremylongshore/tons-of-skills-marketplace2.8k—~1.4kAutomated safety check: NotesMIT
Impeccablebestofjs/bestofjs3.1k26 repos~2.6kAutomated safety check: PassMIT
Interface Design for Dashboards and Appsholaboss-ai/holaOS11k3 repos~6kAutomated safety check: PassMIT
Animategrowupanand/ConvoForm1026 repos~1.9kAutomated safety check: PassApache-2.0
Migrate Content Iadocker/docs4.7k—~5.1kAutomated safety check: PassApache-2.0
UX WalkthroughXiaoMi/hiui879—~1.3kAutomated safety check: PassMIT

Similar skills

  • Impeccable

    bestofjs/bestofjs

    A skill your agent uses when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt, animate, colorize, extract, or otherwise improve a…

    3.1k GitHub starsUsed in 26 repos~2.6k tokens
    Frontend & DesignAuto-check passed
  • Pushes an agent past generic defaults when designing dashboards, admin panels, SaaS apps and tools, with attention to structure, type, navigation and how data is shown.

    11k GitHub starsUsed in 3 repos~6k tokens
    Frontend & DesignAuto-check passed
  • Animate

    growupanand/ConvoForm

    Review a feature and enhance it with purposeful animations, micro-interactions, and motion effects that improve usability and delight.

    102 GitHub starsUsed in 6 repos~1.9k tokens
    Frontend & DesignAuto-check passed
  • Official

    Handle Hugo docs information-architecture moves: discover old vs new URLs, add front matter aliases (Phase 1), update in-repo links (Phase 2), interactive List 2 resolution and fragment validation…

    4.7k GitHub stars~5.1k tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • UX Walkthrough

    XiaoMi/hiui

    体验走查 skill。适用于代码库、URL、截图三种输入,输出结构化体验问题报告,并同步生成本地 docx 报告。触发词:体验走查、UX review、交互走查、界面审查、体验问题。

    879 GitHub stars~1.3k tokensUpdated 2 mo ago
    Frontend & DesignAuto-check passed
  • Color Audit

    rome-os/rome

    Audit a design system's color palette against measurable color-science disciplines — WCAG/APCA contrast of declared token pairs, perceptual (OKLCH) ramp uniformity, color-blindness safety of…

    748 GitHub stars~2.7k tokensUpdated today
    Frontend & DesignAuto-check passed

More from jeremylongshore/tons-of-skills-marketplace

All 3,342 skills in this repo
  • Performing Security Code Review

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to conduct a security-focused code review using the security-agent plugin.

    2.8k GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check: notes
  • Adapting Transfer Learning Models

    jeremylongshore/tons-of-skills-marketplace

    Build this skill automates the adaptation of pre-trained machine learning models using transfer learning techniques.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Agent Context Loader

    jeremylongshore/tons-of-skills-marketplace

    Execute proactive auto-loading: automatically detects and loads agents.md files.

    2.8k GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Aggregating Performance Metrics

    jeremylongshore/tons-of-skills-marketplace

    Aggregate and centralize performance metrics from applications, systems, databases, caches, and services.

    2.8k GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Analyzing Capacity Planning

    jeremylongshore/tons-of-skills-marketplace

    Execute this skill enables AI assistant to analyze capacity requirements and plan for future growth.

    2.8k GitHub stars~947 tokensUpdated today
    Auto-check passed
  • Analyzing Database Indexes

    jeremylongshore/tons-of-skills-marketplace

    Process use when you need to work with database indexing. An agent skill from jeremylongshore/tons-of-skills-marketplace.

    2.8k GitHub stars~2k tokensUpdated today
    Auto-check passed

Questions about Draft Review

What does Draft Review do?

Usability review — evaluate an existing flow or UI against usability heuristics, flag friction points, and recommend fixes. Draft Review is an agent skill from jeremylongshore/tons-of-skills-marketplace. Usability review — evaluate an existing flow or UI against usability heuristics, flag friction points, and recommend fixes.

When should I use Draft Review?

Draft Review fits situations like: asked to review the UX; usability audit; whats wrong with this flow; critique this design.

How do I install Draft Review in Claude Code?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill draft-review -a claude-code`. Or copy the skill folder (plugins/ai-agency/tonone/skills/draft-review in jeremylongshore/tons-of-skills-marketplace) into .claude/skills/draft-review in your project. Claude Code loads it when a task matches its description.

How do I install Draft Review in Codex?

Run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill draft-review -a codex`. Or copy the skill folder (plugins/ai-agency/tonone/skills/draft-review in jeremylongshore/tons-of-skills-marketplace) into .agents/skills/draft-review in your project. Codex loads it when a task matches its description.

Can I use Draft Review in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jeremylongshore/tons-of-skills-marketplace --skill draft-review -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/draft-review, .gemini/skills/draft-review, .github/skills/draft-review and .opencode/skills/draft-review in your project.

What does Draft Review need to run?

Going by SKILL.md and its folder, Draft Review needs the command-line tools its instructions call (python3). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Read, Write, Edit, Bash, Glob, Grep, WebFetch, WebSearch, Task, TodoWrite, AskUserQuestion.

Does Draft Review access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Draft Review safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Draft Review use?

Draft Review is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Draft Review use?

About 1.4k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Draft Review?

Skills that share tags, products or a category with Draft Review: Impeccable (bestofjs/bestofjs, 3.1k stars), Interface Design for Dashboards and Apps (holaboss-ai/holaOS, 11k stars), Animate (growupanand/ConvoForm, 102 stars) and Migrate Content Ia (docker/docs, 4.7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Draft Review?

jeremylongshore (a GitHub user) maintains it in jeremylongshore/tons-of-skills-marketplace, which has 2,827 GitHub stars. The repository holds 3,342 skills in this directory. The repository was last updated on October 10, 2026.

Source: jeremylongshore/tons-of-skills-marketplace on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.