333-333-333/laws-of-ux
skills/laws-of-ux/SKILL.md
Fundamental UX laws and principles from lawsofux.com for designing better interfaces. Trigger: When designing UI flows, reviewing UX decisions, or justifying design choices.
testing
Updated Mar 25, 2026
$ install --global
skillsauthnpx skillsauth add 333-333-333/agents laws-of-uxInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Error
VirusTotalMulti-engine malware detection
70%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Mar 25, 2026, 12:28 PM44.5s2 files scanned
SKILL.md
- name:
- laws-of-ux
- description:
- >
- Trigger:
- When designing UI flows, reviewing UX decisions, or justifying design choices.
- author:
- 333-333-333
- version:
- 1.0
- type:
- generic
- scope:
- [mobile]
When to Use
- Designing new features or flows
- Reviewing UI/UX for improvements
- Justifying design decisions to stakeholders
- Optimizing existing interfaces
Core Laws
Interaction & Time
| Law | Principle | Flutter Application | |-----|-----------|---------------------| | Fitts's Law | Time to target = f(distance, size) | Large touch targets (48dp+), important actions within thumb reach | | Hick's Law | Decision time ↑ with more choices | Limit options, use progressive disclosure | | Doherty Threshold | Response < 400ms keeps flow | Show loading states, optimistic UI updates |
Memory & Cognition
| Law | Principle | Flutter Application | |-----|-----------|---------------------| | Miller's Law | Working memory: 7±2 items | Chunk content, limit nav items to 5-7 | | Cognitive Load | Minimize mental effort | Simple layouts, clear hierarchy, familiar patterns | | Chunking | Group related info | Use cards, sections, visual grouping |
Perception & Gestalt
| Law | Principle | Flutter Application | |-----|-----------|---------------------| | Law of Proximity | Near = related | Group related controls, consistent spacing | | Law of Similarity | Similar = related | Consistent button styles, icon families | | Law of Common Region | Shared boundary = group | Cards, outlined sections, backgrounds | | Law of Prägnanz | Simplest interpretation wins | Clean shapes, minimal decoration |
Behavior & Psychology
| Law | Principle | Flutter Application | |-----|-----------|---------------------| | Jakob's Law | Users expect familiar patterns | Follow platform conventions, standard nav | | Peak-End Rule | Judge by peak + end moments | Strong onboarding, satisfying completion | | Von Restorff Effect | Different = memorable | Highlight CTAs, use contrast for key actions | | Serial Position Effect | Remember first/last best | Important items at top/bottom of lists | | Goal-Gradient Effect | Motivation ↑ near goal | Progress indicators, completion percentages | | Zeigarnik Effect | Incomplete = memorable | Progress saving, resume prompts |
Complexity & Design
| Law | Principle | Flutter Application | |-----|-----------|---------------------| | Tesler's Law | Complexity can't be eliminated, only moved | Hide complexity from users, smart defaults | | Occam's Razor | Simplest solution is best | Remove unnecessary elements, clear paths | | Aesthetic-Usability | Pretty = perceived as usable | Polish visual design, attention to detail | | Postel's Law | Accept liberally, send conservatively | Flexible inputs, strict validation output |
Decision Framework
User struggling with choices? → Hick's Law (reduce options)
UI feels slow? → Doherty Threshold (< 400ms feedback)
Users missing key actions? → Fitts's Law (bigger targets)
→ Von Restorff (make it stand out)
Users confused by layout? → Gestalt laws (proximity, similarity)
Users abandoning flows? → Peak-End Rule (improve completion)
→ Goal-Gradient (show progress)
Users not finding features? → Jakob's Law (use familiar patterns)
Too much on screen? → Miller's Law (chunk to 7±2)
→ Cognitive Load (simplify)
Quick Reference
See assets/laws_quick_reference.md for a printable checklist.
Anti-Patterns
| ❌ Violation | Law Broken | ✅ Fix | |-------------|------------|--------| | 15 nav items | Miller's Law | Group into 5 categories | | Tiny 24px buttons | Fitts's Law | Minimum 48dp touch target | | 500ms+ response, no feedback | Doherty Threshold | Immediate loading indicator | | All buttons look the same | Von Restorff | Highlight primary CTA | | No progress in long forms | Goal-Gradient | Add progress indicator | | Custom unfamiliar navigation | Jakob's Law | Use standard patterns | | Dense wall of text | Chunking | Break into scannable sections |
Resources
- Source: lawsofux.com
- Quick reference: See assets/laws_quick_reference.md
Related Skills
333-333-333/ux-review
testing
VerifiedTrustedCommunity
Review Flutter components and screens for UX/UI compliance. Trigger: When user invokes /ux-review command or requests UX audit.
SKILL.mdUpdated Mar 25, 2026
333-333-333/typescript
development
VerifiedTrustedCommunity
TypeScript strict patterns and best practices. Trigger: When implementing or refactoring TypeScript in .ts/.tsx (types, interfaces, generics, const maps, type guards, removing any, tightening unknown).
SKILL.mdUpdated Mar 25, 2026
333-333-333/testing-strategy
testing
VerifiedTrustedCommunity
Testing philosophy and strategy for every feature: test pyramid, mandatory levels per change type, completion checklist, and skill delegation. Trigger: When planning tests for a feature, reviewing test coverage, defining acceptance criteria, or asking what tests a change needs.
SKILL.mdUpdated Mar 25, 2026
333-333-333/terraform-security
development
VerifiedTrustedCommunity
Terraform security practices: sensitive variables, secret management, state protection, .gitignore patterns, and CI/CD credential handling. Trigger: When handling secrets in Terraform, configuring state backends, reviewing .gitignore for Terraform, or setting up CI/CD pipelines for infrastructure.
SKILL.mdUpdated Mar 25, 2026