Ui Doctor
If you're working with the Iress Design System (IDS) and need to audit UI components for compliance, accessibility, and usability, this does the heavy lifting. It runs three audit modes: a quick UX review checking cognitive load and Nielsen's heuristics, an accessibility pass for WCAG 2.1 AA compliance, or a full IDS audit with component validation and design token checks. The skill knows to skip test files and Storybook stories, traces your app's actual entry point to verify Provider setup, and is version-aware for IDS v5 and v6 migrations. It generates actionable reports with prioritized recommendations. Useful when refactoring legacy UI or maintaining design system consistency across a React codebase.
- skills.sh installs
- 1.3K
- GitHub stars
- 1
- last updated
- Aug 21, 2026
Install
$ npx -y skills add iress/design-system --skill ui-doctor --agent claude-codeInstalls into .claude/skills of the current project.
Files
Skill: UI Doctor
Audit and review application UI for IDS compliance, accessibility, usability, and cognitive load. This skill helps AI agents perform comprehensive UI reviews covering component usage, accessibility (WCAG), usability heuristics (Nielsen's 10), cognitive load, and progressive disclosure — then produce actionable reports with prioritised recommendations.
When to Use
Activate this skill when the user says things like:
- "Review this page / component / file for accessibility"
- "Check the usability of this UI"
- "Audit this for IDS compliance"
- "This feels like too much cognitive load"
- "Are we following IDS guidelines?"
- "Check for a11y issues"
- "Review this UI"
- "Is this form accessible?"
- "Can you do a UX review?"
Or more generally:
- Reviewing application UI code for IDS compliance
- Validating accessibility (WCAG 2.1 AA)
- Assessing usability and cognitive load
- Evaluating design token usage and consistency
- Generating a UI health report with a compliance score
- Providing recommendations to improve UX, accessibility, and IDS adoption
Audit Modes
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/iress/design-system
- Categories
- Frontend Development, Git & Pull Requests, Code Review & Quality, Design & UI/UX
- First seen
- Jun 3, 2026
Recommended
More Frontend Development
cssmindrally/skillsBest practices for CSS development including modern layout techniques, naming conventions, theming, and maintainable stylesheet architecture1.2Kskills.sh installs
capacitor-reactcapawesome-team/skillsGuides the agent through Capacitor app development with React — project structure, hooks for native features, state management patterns, using Capacitor plugins1.2Kskills.sh installs
hooks-patternpatternsdev/skillsTeaches React Hooks for reusing stateful logic across components. Use when extracting shared behavior like form handling, subscriptions, or side effects into re1.2Kskills.sh installsreact-composition-2026patternsdev/skillsTeaches modern React composition patterns for 2025/2026. Use when designing component APIs, building shared UI libraries, or refactoring prop-heavy components.1.2Kskills.sh installs
typescript-react-patternsasyrafhussin/agent-skillsTypeScript best practices for React development. Use when writing typed React components, hooks, events, refs, or generic components. Triggers on tasks involvin1.1Kskills.sh installsoptimized-nextjs-typescriptmindrally/skillsOptimized Next.js TypeScript best practices with modern UI/UX, focusing on performance, security, and clean architecture1Kskills.sh installs