スキル一覧に戻る
harmonbhasin

ux-review

by harmonbhasin

my configs

0🍴 0📅 2026年1月21日
GitHubで見るManusで実行

SKILL.md


name: ux-review description: Reviews UI code or designs for UX issues, suggests improvements based on Laws of UX. Use when reviewing components, designing new interfaces, or improving user experience for web applications.

Task

Analyze the provided UI code or design context and provide actionable UX recommendations.

For code review: Read the relevant component files first, then identify violations. For new designs: Ask clarifying questions about user goals, then suggest patterns.

Output Format

For each issue found, output:

**[Law Name]** - [Severity: High/Medium/Low]
- Issue: [One sentence describing the problem]
- Fix: [Specific actionable fix]
- Location: [file:line if reviewing code]

Group by severity. Limit to top 10 issues unless asked for comprehensive review.

Quick Reference: Most Common Web UX Issues

Layout & Visual Hierarchy

CheckLawAction
Touch targets < 44pxFitts's LawIncrease to min 44x44px
Related items spaced apartProximityGroup with whitespace or containers
No visual groupingCommon RegionAdd cards, borders, or background colors
Inconsistent button stylesSimilarityUnify styles for same-type actions
Primary CTA doesn't stand outVon RestorffUse distinct color/size for primary action
CheckLawAction
Too many nav items (>7)Miller's LawGroup into categories, use progressive disclosure
Many options without defaultHick's LawHighlight recommended option, reduce choices
Non-standard patternsJakob's LawUse familiar conventions (hamburger, search icon, etc.)
Important items in middleSerial PositionMove to start or end of lists
No progress indicatorGoal-GradientAdd progress bar/steps for multi-step flows

Feedback & Performance

CheckLawAction
No loading stateDoherty ThresholdAdd spinner/skeleton for >400ms operations
Form rejects minor variationsPostel's LawAccept flexible input, normalize internally
No error recoveryPeak-End RuleDesign graceful error states with clear next steps
Manual user input for known dataTesler's LawAuto-fill, save state, reduce user effort

Cognitive Load

CheckLawAction
Wall of textChunkingBreak into sections with headers
Complex form on one pageZeigarnikSplit into steps with progress indicator
Users must remember across pagesWorking MemoryPersist selections, show context
No embedded helpParadox of Active UserAdd tooltips, inline hints, contextual help

Review Checklist

When reviewing, check these in order:

  1. Critical (blocks users)

    • Touch/click targets too small (Fitts's Law)
    • No feedback on actions (Doherty Threshold)
    • Confusing navigation structure (Jakob's Law)
  2. Major (causes friction)

    • Choice overload without guidance (Hick's Law)
    • Poor visual grouping (Proximity, Common Region)
    • Missing progress indicators (Goal-Gradient)
  3. Minor (polish)

    • Inconsistent visual treatment (Similarity)
    • Suboptimal element positioning (Serial Position)
    • Missing micro-interactions (Flow)

Design Mode

When designing new interfaces:

  1. Start with user goal - What's the primary action?
  2. Apply 80/20 (Pareto) - Focus on the 20% of features serving 80% of users
  3. Match mental models (Jakob's Law) - Use patterns from similar products
  4. Minimize choices (Hick's Law) - Default to best option, hide advanced settings
  5. Show progress (Goal-Gradient, Zeigarnik) - Break flows into visible steps
  6. Design the end (Peak-End Rule) - Success states deserve premium attention

When to Read Full Laws Reference

Read laws-reference.md when:

  • User asks for detailed explanation of a specific law
  • Recommending significant architectural changes
  • Writing documentation or educating team members

スコア

総合スコア

40/100

リポジトリの品質指標に基づく評価

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

0/10
人気

GitHub Stars 100以上

0/15
最近の活動

3ヶ月以内に更新がある

0/10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

+5
タグ

1つ以上のタグが設定されている

0/5

レビュー

💬

レビュー機能は近日公開予定です