The Web HIG

    1

    Apply a modern web Human Interface Guideline on UI work: accessibility, Core Web Vitals, design tokens, motion, forms, and AI/agent UI, with citable rule IDs.

    Free

    Security scanned

    Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more

    The Web HIG

    Example session with this skill installed

    Review this React button component and check that it follows The Web HIG:
    const IconButton = ({ icon }) => <button style={{ color: '#ff0000' }}>{icon}</button>;

    • Read your context and instructions
    • Compiled the the web hig

    I have reviewed the IconButton component against The Web HIG v1.15.0. It contains three critical violations of Layer 7 guardrails.

    Web HIG Audit

    Rule IDSeverityViolationRequired Fix
    HIG-TOK-001ErrorRaw hex color #ff0000 usedReplace with semantic token (e.g., var(--color-status-error))
    HIG-A11Y-004ErrorMissing accessible name on icon buttonAdd aria-label or visually hidden text
    HIG-A11Y-007ErrorMissing minimum target sizeEnsure button dimensions are at least 24px (WCAG 2.5.8 floor)

    Corrected Implementation

    // Resolved Archetype: Application
    // Layer 7 Enforcement: Tokens, A11y, Styles
    
    import React from 'react';
    
    /**
     * IconButton matching with HIG-A11Y-004 and HIG-TOK-001.
     * Uses logical properties (HIG-UX-001) and semantic tokens.
     */
    const IconButton = ({ icon, label }) => {
      return (
        <button 
          aria-label={label}
          style={{ 
            color: 'var(--token-text-critical)',
            minBlockSize: 'var(--token-size-24)',
            minInlineSize: 'var(--token-size-24)',
            display: 'inline-flex',
            alignItems: 'center',
            justifyContent: 'center',
            padding: 'var(--token-space-xs)'
          }}
        >
          {icon}
        </button>
      );
    };
    
    export default IconButton;
    

    Next steps

    • Move the inline styles to a dedicated CSS module or Tailwind class list to follow HIG-TOK-002.
    • Verify the icon component itself doesn't contain transition: all to avoid HIG-MOT-001 errors.
    • Ensure the parent container provides enough clear space for the 24px hit target.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    The Web HIG is an open-source, MIT-licensed human interface guideline for the web. This skill makes your coding agent apply it whenever it writes or changes UI, CSS, components, or forms. It resolves the page archetype (content, commerce, application, auth), loads the Quick Reference first and deeper guidance only when needed, applies Layer 7 guardrails (tokens, motion, accessibility, SSR), prefers the simplest implementation that meets the requirements, and cites stable HIG-* rule IDs in PRs and when declining conflicting requests. Pairs with the guideline files installed by npx @web-hig/install. Spec and docs: https://frozonfreak.github.io/webhig — Source: https://github.com/frozonfreak/webhig

    Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for Frontend & Web Apps.

    Requires a docs/hig/ directory for rule lookups. Focuses on Web HIG v1.15.0 only. Motion rules are restricted to a 300ms cap for micro-animations.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before buying a skill.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Free to use

    No account required to browse

    Trust & safety

    Security scan

    Security scan passed 20 days ago

    • Free with an Agensi account

    Permissions

    Read Files
    Listed20 days ago

    What's inside

    Frequently Asked Questions

    It guides your agent to follow The Web HIG: prefer semantic tokens over raw hex codes, avoid inefficient 'transition: all' properties, and cite HIG-* rule IDs, which helps keep styling consistent.

    It works with any agent that supports SKILL.md, including Claude Code, Cursor, GitHub Copilot, Windsurf, and Codex CLI. The Web HIG is framework-agnostic, so it applies to any web front-end stack.

    The skill requires a `docs/hig/` directory in your repository to store the rule registry and archetype mappings, ensuring the AI can reference specific HIG-ID constraints during the development process.

    The Web HIG has a short Quick Reference, a practical guide, and a full spec, with stable HIG-* rule IDs your agent can cite. The skill loads the Quick Reference first and deeper guidance only when needed.

    This version is specifically tuned to v1.15.0 of the Web Human Interface Guidelines; future updates to the HIG spec will be released as distinct version patches to ensure your project's architectural stability.

    It is intended for web-based front-ends and PWAs. It does not cover native mobile HIG specifications (iOS/Android) or legacy projects that cannot support modern CSS logical properties.

    New in Frontend & Web Apps

    Free