Web Interface Guidelines Reviewer
vercel-labs/openreview
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my…
Implements onboarding and help systems including product tours, interactive tutorials, tooltips, checklists, help panels, and progressive disclosure patterns.
$ npx skills add ancoleman/ai-design-components --skill guiding-users -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install ancoleman/ai-design-components guiding-users --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/ancoleman/ai-design-components.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/guiding-users .claude/skills/guiding-users && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "guiding-users" agent skill from https://github.com/ancoleman/ai-design-components/tree/main/skills/guiding-users into .claude/skills/guiding-users/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "guiding-users", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/ancoleman/ai-design-components/tree/main/skills/guiding-usersType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add ancoleman/ai-design-components --skill guiding-users -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install ancoleman/ai-design-components guiding-users --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ancoleman/ai-design-components.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/guiding-users .agents/skills/guiding-users && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "guiding-users" agent skill from https://github.com/ancoleman/ai-design-components/tree/main/skills/guiding-users into .agents/skills/guiding-users/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "guiding-users", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ancoleman/ai-design-components --skill guiding-users -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install ancoleman/ai-design-components guiding-users --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ancoleman/ai-design-components.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/guiding-users .cursor/skills/guiding-users && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "guiding-users" agent skill from https://github.com/ancoleman/ai-design-components/tree/main/skills/guiding-users into .cursor/skills/guiding-users/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "guiding-users", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/ancoleman/ai-design-components.git --path skills/guiding-users--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add ancoleman/ai-design-components --skill guiding-users -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install ancoleman/ai-design-components guiding-users --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ancoleman/ai-design-components.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/guiding-users .gemini/skills/guiding-users && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "guiding-users" agent skill from https://github.com/ancoleman/ai-design-components/tree/main/skills/guiding-users into .gemini/skills/guiding-users/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "guiding-users", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install ancoleman/ai-design-components guiding-usersInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add ancoleman/ai-design-components --skill guiding-users -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/ancoleman/ai-design-components.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/guiding-users .github/skills/guiding-users && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "guiding-users" agent skill from https://github.com/ancoleman/ai-design-components/tree/main/skills/guiding-users into .github/skills/guiding-users/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "guiding-users", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ancoleman/ai-design-components --skill guiding-users -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install ancoleman/ai-design-components guiding-users --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ancoleman/ai-design-components.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/guiding-users .opencode/skills/guiding-users && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "guiding-users" agent skill from https://github.com/ancoleman/ai-design-components/tree/main/skills/guiding-users into .opencode/skills/guiding-users/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "guiding-users", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
guiding-usersImplements onboarding and help systems including product tours, interactive tutorials, tooltips, checklists, help panels, and progressive disclosure patterns.
Guiding Users is an agent skill from ancoleman/ai-design-components. Implements onboarding and help systems including product tours, interactive tutorials, tooltips, checklists, help panels, and progressive disclosure patterns. Use when building first-time experiences, feature discovery, guided walkthroughs, contextual help, setup flows, or user activation features. Provides timing strategies, accessibility patterns (keyboard, screen readers, reduced motion), and metrics for measuring onboarding success.
Its SKILL.md is about 3.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 32 other files, including scripts, reference files and assets (for example `assets/celebration-animations/README.md`, `assets/message-templates.json` and `assets/timing-config.json`).
It sits in Frontend & Design, covering Accessibility. The repository describes itself as: Comprehensive UI/UX and Backend component design skills for AI-assisted development with Claude. The licence is MIT.
5 steps, taken from the step headings in SKILL.md.
Read from SKILL.md and the folder at commit 76551b7. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Ships 1 file in scripts/, which the agent can run.
Shell commands in SKILL.md call:
npmnodepythonFrom the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Guiding Users loads about 3.5k tokens when it runs, and up to ~7.8k if it reads all its reference files. Until then it costs about 114 tokens; SKILL.md has 1,392 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
The full file from ancoleman/ai-design-components at commit 76551b7, republished under its MIT licence (© ancoleman). 1,392 words, ~3,478 tokens.
.claude/skills/guiding-users/SKILL.md (or your agent's skills folder). This skill also uses 28 other files; get the full folder from GitHub.This skill provides systematic patterns for onboarding users and delivering contextual help, from first-time product tours to ongoing feature discovery. It covers the complete spectrum of user guidance mechanisms, ensuring optimal user activation, feature adoption, and self-service support.
Activate this skill when:
Select the appropriate guidance mechanism based on user state and content type:
First-time user → Product Tour (step-by-step)
New feature launch → Feature Spotlight (tooltip + animation)
Complex workflow → Interactive Tutorial (guided tasks)
Account setup → Checklist (progress tracking)
Contextual help needed → Tooltip/Hint system
Ongoing support → Help Panel (sidebar/searchable)
Feature unlock → Progressive DisclosureReference references/selection-framework.md for detailed selection criteria.
Step-by-step walkthroughs that guide users through key features:
Implementation:
npm install react-joyrideSee examples/first-time-tour.tsx for complete implementation.
Reference references/product-tours.md for patterns and best practices.
Announce new features to existing users:
See examples/feature-spotlight.tsx for implementation.
Reference references/tooltips-hints.md for patterns.
Guided task completion with validation:
See examples/guided-tutorial.tsx for implementation.
Reference references/interactive-tutorials.md for patterns.
Track multi-step onboarding progress:
See examples/setup-checklist.tsx for implementation.
Reference references/checklists.md for patterns.
Just-in-time help when users need it:
See examples/contextual-help.tsx for implementation.
Reference references/tooltips-hints.md for complete patterns.
Comprehensive help systems:
See examples/help-panel.tsx for implementation.
Reference references/help-systems.md for patterns.
Appropriate triggers:
Avoid showing when:
Auto-dismiss timing:
Reference references/timing-strategies.md for detailed guidelines.
Show only what's needed, when it's needed:
Techniques:
Reference references/progressive-disclosure.md for implementation patterns.
Essential keyboard support:
ARIA patterns for announcements:
Respect prefers-reduced-motion:
To validate accessibility:
node scripts/validate_accessibility.jsReference references/accessibility-patterns.md for complete implementation.
Library: /gilbarbara/react-joyride
Trust Score: 9.6/10
Code Snippets: 29+
Best for comprehensive product tours:
npm install react-joyrideSee examples/joyride-tour.tsx for complete setup.
Best for minimal bundle size:
npm install driver.jsBest for traditional tours:
npm install intro.jsReference references/library-comparison.md for detailed analysis and selection criteria.
All onboarding components use the design-tokens skill for consistent theming:
Token categories used:
Supports light, dark, high-contrast, and custom brand themes. Reference the design-tokens skill for complete theming documentation.
Track these indicators:
Iterate based on data:
To analyze onboarding metrics:
python scripts/analyze_onboarding_metrics.pyReference references/measuring-success.md for complete analytics implementation.
Common mistakes that harm user experience:
❌ Forced Tours: Requiring tour completion before product use ❌ Too Long: Tours exceeding 7 steps lose user attention ❌ Every Session: Showing same tour repeatedly ❌ No Skip Option: Preventing users from exploring independently ❌ Wall of Text: Using lengthy explanations instead of visuals ❌ Blocking Everything: Preventing interaction during tours ❌ Premature Guidance: Showing help before users explore ❌ Poor Timing: Interrupting focused work ❌ No Context: Generic tips without specific relevance
Identify key moments:
Match mechanisms to moments:
Build incrementally:
Verify compliance:
Run validation:
node scripts/validate_accessibility.jsTrack and improve:
Start with the example matching the use case:
first-time-tour.tsx # Product walkthrough with react-joyride
feature-spotlight.tsx # New feature announcement
guided-tutorial.tsx # Interactive task completion
setup-checklist.tsx # Multi-step onboarding progress
contextual-help.tsx # Tooltips and progressive hints
help-panel.tsx # Sidebar help with search
celebration-animation.tsx # Completion feedbackscripts/generate_tour_config.js - Generate tour configurations from user flowsscripts/analyze_onboarding_metrics.py - Analyze completion and drop-off ratesscripts/validate_accessibility.js - Test keyboard and screen reader supportreferences/product-tours.md - Tour patterns, step design, navigationreferences/interactive-tutorials.md - Guided tasks and sandbox modesreferences/tooltips-hints.md - Contextual help and progressive hintsreferences/checklists.md - Progress tracking and gamificationreferences/help-systems.md - Help panels, videos, and documentationreferences/progressive-disclosure.md - Advanced patterns and feature unlockingreferences/timing-strategies.md - When and how to trigger guidancereferences/accessibility-patterns.md - WCAG compliance and ARIA patternsreferences/measuring-success.md - Analytics and optimizationreferences/library-comparison.md - Detailed library evaluationreferences/selection-framework.md - Decision trees for choosing mechanismsassets/celebration-animations/ - Success animations and confettiassets/tour-templates.json - Reusable tour configurationsassets/message-templates.json - Tooltip and hint copy templatesassets/timing-config.json - Recommended timing valuesThis skill works with other component skills:
© ancoleman, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 28 other files (scripts, references, assets) in skills/guiding-users of ancoleman/ai-design-components.
Open the folder on GitHubat commit 76551b7
Guiding Users next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Guiding Users this skillancoleman/ai-design-components | 526 | — | ~3.5k | Automated safety check: Pass | MIT | |
| Web Interface Guidelines Reviewervercel-labs/openreview | 1.7k | 98 repos | ~308 | Automated safety check: Pass | None | |
| Accessibility Reviewmarkmead/hyperui | 12k | 1 repos | ~1.1k | Automated safety check: Pass | MIT | |
| Web Animation DesignbaptisteArno/typebot.io | 11k | 2 repos | ~2.7k | Automated safety check: Pass | Custom licence | |
| Accessibility Fixeribelick/ui-skills | 9.4k | 4 repos | ~1.2k | Automated safety check: Pass | MIT | |
| Wcag Audit PatternsvmDeshpande/ai-agent-automation | 178 | 10 repos | ~610 | Automated safety check: Pass | Apache-2.0 |
vercel-labs/openreview
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my…
markmead/hyperui
Run a WCAG 2.1 AA accessibility audit on a design or page. An agent skill from markmead/hyperui.
baptisteArno/typebot.io
Guides easing, timing and animation choices for UI motion, based on a web animation course, and reviews existing animations in a before-and-after table.
ibelick/ui-skills
Audits and fixes HTML accessibility problems such as ARIA labels, keyboard navigation, focus management, contrast and form errors with minimal changes.
vmDeshpande/ai-agent-automation
Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance.
ibelick/ui-skills
Applies a fixed set of UI rules for stack, components, interaction, animation, typography and layout, or reviews a file against them with concrete fixes.
ancoleman/ai-design-components
Builds AI chat interfaces and conversational UI with streaming responses, context management, and multi-modal support.
ancoleman/ai-design-components
Builds form components and data collection interfaces including contact forms, registration flows, checkout processes, surveys, and settings pages.
ancoleman/ai-design-components
Builds tables and data grids for displaying tabular information, from simple HTML tables to complex enterprise data grids.
ancoleman/ai-design-components
Creates comprehensive dashboard and analytics interfaces that combine data visualization, KPI cards, real-time updates, and interactive layouts.
ancoleman/ai-design-components
Designs layout systems and responsive interfaces including grid systems, flexbox patterns, sidebar layouts, and responsive breakpoints.
ancoleman/ai-design-components
Displays chronological events and activity through timelines, activity feeds, Gantt charts, and calendar interfaces.
Categories
Implements onboarding and help systems including product tours, interactive tutorials, tooltips, checklists, help panels, and progressive disclosure patterns. Guiding Users is an agent skill from ancoleman/ai-design-components. Implements onboarding and help systems including product tours, interactive tutorials, tooltips, checklists, help panels, and progressive disclosure patterns.
Guiding Users fits situations like: building first-time experiences; feature discovery; guided walkthroughs; contextual help.
Run `npx skills add ancoleman/ai-design-components --skill guiding-users -a claude-code`. Or copy the skill folder (skills/guiding-users in ancoleman/ai-design-components) into .claude/skills/guiding-users in your project. Claude Code loads it when a task matches its description.
Run `npx skills add ancoleman/ai-design-components --skill guiding-users -a codex`. Or copy the skill folder (skills/guiding-users in ancoleman/ai-design-components) into .agents/skills/guiding-users in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ancoleman/ai-design-components --skill guiding-users -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/guiding-users, .gemini/skills/guiding-users, .github/skills/guiding-users and .opencode/skills/guiding-users in your project.
Going by SKILL.md and its folder, Guiding Users needs the command-line tools its instructions call (npm, node and python). Our summary lists: Python 3; Node.js.
SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
Guiding Users is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 3.5k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.3k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with Guiding Users: Web Interface Guidelines Reviewer (vercel-labs/openreview, 1.7k stars), Accessibility Review (markmead/hyperui, 12k stars), Web Animation Design (baptisteArno/typebot.io, 11k stars) and Accessibility Fixer (ibelick/ui-skills, 9.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
ancoleman (a GitHub user) maintains it in ancoleman/ai-design-components, which has 526 GitHub stars. The repository holds 75 skills in this directory. The repository was last updated on December 11, 2025.
Source: ancoleman/ai-design-components on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.