
Ux Principles
Ground agent-driven UI and flow decisions in proven UX patterns with real product case studies instead of generic design advice.
Install
npx skills add https://github.com/manutej/luxor-claude-marketplace --skill ux-principlesWhat is this skill?
- 20 documented UX principle examples with context, implementation notes, design decisions, user impact, and metrics
- Coverage spans progressive disclosure, contextual help, undo culture, smart defaults, constraint-based design, and error
- Reference implementations drawn from TurboTax, Slack, Gmail, Stripe, Airbnb, Spotify, Figma, Duolingo, and similar produ
- Table-of-contents structure maps one principle per major product for quick lookup during reviews or specs
- Suitable as a pattern library when auditing solo-builder SaaS, mobile, or marketing-site UX before ship
Adoption & trust: 544 installs on skills.sh; 58 GitHub stars; 3/3 security scanners passed (skills.sh audits).
Recommended Skills
Journey fit
Canonical shelf is Build because the skill’s value peaks when shaping interfaces, flows, and product surfaces—though the principles inform earlier validation and later launch polish. Frontend is the primary subphase for applying layout, interaction, onboarding, and feedback patterns while screens and journeys are being designed or refined.
Common Questions / FAQ
Is Ux Principles safe to install?
skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.
SKILL.md
READMESKILL.md - Ux Principles
# UX Principles Examples This document provides detailed, real-world examples of UX principles in action. Each example includes context, implementation details, design decisions, user impact, and metrics. ## Table of Contents 1. Progressive Disclosure - TurboTax 2. Contextual Help - Slack 3. Undo Culture - Gmail 4. Smart Defaults - iOS Camera 5. Feedback and Confirmation - Stripe 6. Constraint-Based Design - Airbnb 7. Recognition Over Recall - Spotify 8. Consistency - Apple HIG 9. Error Prevention - Grammarly 10. Minimalist Design - Dropbox 11. Accessibility First - BBC 12. Affordances - Material Design 13. User Control - YouTube 14. Mental Models - Figma 15. Gamification - Duolingo 16. Onboarding - Slack 17. Error Recovery - Amazon 18. Information Scent - Medium 19. Social Proof - Booking.com 20. Micro-interactions - Twitter --- ## 1. Progressive Disclosure - TurboTax ### Context Tax filing is inherently complex with hundreds of potential questions and forms. TurboTax needed to serve both simple filers (W-2 only) and complex situations (business income, investments, rental properties) without overwhelming anyone. ### The Challenge - Tax code is extremely complex - Users range from simple to complex tax situations - Fear and anxiety around taxes are high - Errors can be costly - Users want to be done quickly ### Implementation **Step-by-Step Interview Style**: ``` Question 1: "Let's start with your personal info. What's your filing status?" [Single] [Married filing jointly] [Married filing separately] [Head of household] After selection... Question 2: "Did you have any income in 2023?" [Yes] [No] If Yes... Question 3: "What type of income did you have?" ☐ W-2 wages ☐ Self-employment ☐ Investment income ☐ Rental properties ☐ Other Based on selections, only relevant questions appear... ``` **Progressive Complexity**: - Basic questions first (name, address, filing status) - Income section reveals only relevant forms - Deductions start with common ones (mortgage, charitable) - Advanced deductions hidden unless user indicates need - "Does this apply to you?" gates for complex situations **Visual Hierarchy**: - One question per screen (focus) - Progress bar shows completion - "Skip" option for optional sections - Summary screens at milestones - Plain language explanations ### Design Decisions 1. **One Question Per Screen** - Rationale: Reduces cognitive load, prevents overwhelm - Trade-off: More screens, but less intimidating - Result: Higher completion rates 2. **Dynamic Branching** - Rationale: Only show relevant questions - Implementation: Smart logic based on previous answers - Result: Simple returns finish in 15 minutes vs. 2+ hours 3. **Plain Language** - Technical: "Line 11 - Taxable Refunds, Credits" - TurboTax: "Did you get a state tax refund last year?" - Impact: 90% fewer help requests 4. **Summary Screens** - After each section, show what was entered - Builds confidence and trust - Allows error correction early ### User Impact **Quantitative Results**: - 30% faster completion for standard returns - 45% reduction in help/support requests - 60% reduction in abandonment rate - 25% increase in accuracy (fewer errors) **Qualitative Feedback**: - "I didn't feel overwhelmed like other tax software" - "I only saw questions that applied to me" - "It felt like talking to a friendly accountant" ### UX Principles Applied 1. **Progressive Disclosure**: Complexity revealed gradually 2. **Cognitive Load Reduction**: One decision at a time 3. **Match Real World**: Conversational interview style 4. **Error Prevention**: Validation at each step 5. **Recognition over Recall**: Show previous entries in summaries ### Lessons Learned - Complexity doesn't have to feel complex - Breaking tasks into tiny steps reduces anxiety - Clear progress indicators motivate completion - Plain language matters more than technical accuracy - Smart defaults accelerate simple cases --- ## 2. Cont