Audit UX waiting states in web apps with long-running operations (30+ seconds) using Claude Code and browser automation. Evaluates 10 key factors affecting perceived wait time.
git clone https://github.com/BayramAnnakov/ux-waiting-audit.gitUX Waiting States Audit is a Claude Code skill that evaluates how web applications handle extended operations lasting 30+ seconds or longer. Using browser automation and AI, it assesses your interface against a 10-point checklist covering progressive value, heartbeat indicators, time estimation, process explanation, sunk cost visibility, and other factors that influence how users perceive wait times. The skill generates detailed reports with screenshots, scoring, identified strengths and gaps, and prioritized recommendations. Built from real-world experience improving wait-time UX at AI agent platforms, it helps product teams reduce user anxiety and abandonment during long operations by implementing psychology-backed design patterns.
Clone the repository and add the skill to Claude Code by copying the folder to ~/.claude/skills/ux-waiting-audit/ or importing the .skill file via Claude Code settings. Invoke with 'Run a UX waiting audit on [URL]'. The skill will navigate to your app, trigger a long-running operation, capture screenshots at key intervals, and generate a report scoring against the 10-point checklist.
Audit AI agent platforms with 30-60+ second processing times
Evaluate report generation or data processing workflows
Assess streaming UI implementations (text, results, progress)
Identify missing feedback during long-running API calls
No install command available. Check the GitHub repository for manual installation instructions.
git clone https://github.com/BayramAnnakov/ux-waiting-auditCopy the install command above and run it in your terminal.
Launch Claude Code, Cursor, or your preferred AI coding agent.
Use the prompt template or examples below to test the skill.
Adapt the skill to your specific use case and workflow.
Conduct a UX waiting audit for [COMPANY]'s [WEBSITE] focusing on [SPECIFIC_FEATURE]. Identify all long-running operations and evaluate the waiting states. Use browser automation to test these states and provide recommendations for improvement. Include screenshots and timing data in your report.
# UX Waiting Audit Report ## Overview The audit focused on [COMPANY]'s [WEBSITE] with a specific emphasis on the [SPECIFIC_FEATURE] feature. The audit identified several areas where the user experience during waiting states could be improved. ## Findings - **Login Process**: The login process takes approximately 5 seconds. Currently, there is no loading indicator, which can lead to user confusion. - **Data Upload**: The data upload feature takes around 15 seconds. The progress bar is present but lacks clear feedback on the estimated time remaining. - **Report Generation**: The report generation process can take up to 30 seconds. There is no visual feedback during this process, leading to a perceived delay. ## Recommendations - **Add Loading Indicators**: Implement loading indicators for all long-running operations to provide clear feedback to users. - **Estimated Time Remaining**: Include an estimated time remaining for processes that take longer than 10 seconds. - **Progress Bars**: Enhance progress bars with more detailed feedback, such as the percentage completed and estimated time remaining. ## Screenshots    ## Timing Data | Process | Average Time (seconds) | |-----------------------|----------------------| | Login Process | 5 | | Data Upload | 15 | | Report Generation | 30 | ## Conclusion By implementing these recommendations, [COMPANY] can significantly improve the user experience during waiting states, leading to increased user satisfaction and engagement.
Automate your browser workflows effortlessly
AI assistant built for thoughtful, nuanced conversation
Get more done every day with Microsoft Teams – powered by AI
Automate your spreadsheet tasks with AI power
Agentic AI Workflow platform
Connected workspace for docs, wikis, and projects
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan