# check-accessibility

Adopt this skill: https://proskills.md/skills/other/agnosticui-agnosticui-claude-skills-check-accessibility

Page: https://proskills.md/skills/other/agnosticui-agnosticui-claude-skills-check-accessibility
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: .claude/skills/check-accessibility/SKILL.md
size: 2540
upstream: https://github.com/agnosticui/agnosticui/blob/master/.claude/skills/check-accessibility/SKILL.md

```text
---
name: check-accessibility
description: Review component for accessibility issues
disable-model-invocation: true
allowed-tools: Read, Grep, Glob, WebSearch, WebFetch
---

**Usage:** `/check-accessibility COMPONENT_NAME`

**Examples:** 
- `/check-accessibility button`
- `/check-accessibility alert`
- `/check-accessibility v2/lib/src/components/Button.ts`

Check accessibility for: $ARGUMENTS

**Setup:**
1. Read `.claude/PROJECT_CONTEXT.md` for AgnosticUI structure and accessibility principles

**Process:**

2. **Search for latest standards:**
   - Use WebSearch for "WCAG 2.2 [component-type] accessibility"
   - Use WebSearch for "ARIA [specific-pattern] best practices"
   - Fetch W3C WAI-ARIA documentation if needed for specific patterns

3. **Locate component files:**
   - Core component: `v2/lib/src/components/$ARGUMENTS*`
   - Framework implementations if relevant: `v2/playgrounds/*/src/stories/*$ARGUMENTS*`
   - Check PROJECT_CONTEXT for AgnosticUI's accessibility standards location

4. **Analyze against current standards:**
   - **Semantic HTML:** Proper element usage for meaning and structure
   - **ARIA attributes:** Correct, necessary, and following latest specs
   - **Keyboard navigation:** Tab order, focus management, keyboard shortcuts
   - **Focus indicators:** Visible focus styles meeting contrast requirements
   - **Screen reader support:** Meaningful labels, descriptions, live regions
   - **Color contrast:** WCAG 2.2 AA requirements (4.5:1 text, 3:1 UI)
   - **Touch targets:** Minimum 44x44px for interactive elements
   - **Motion/animation:** Respects prefers-reduced-motion

5. **Framework-specific considerations:**
   - Check if accessibility differs across Lit, React, Vue implementations
   - Verify ARIA is applied correctly in each framework's rendering
   - Test that events work with keyboard in all frameworks

6. **Report findings:**
   - List issues with severity (Critical/High/Medium/Low)
   - Reference specific WCAG 2.2 success criteria
   - Provide remediation steps with code examples
   - Link to current W3C/MDN documentation
   - Note AgnosticUI-specific patterns to follow

7. **If fixes requested:**
   - Propose changes that work across all frameworks
   - Ensure fixes align with AgnosticUI's CSS-first approach
   - **WAIT FOR USER APPROVAL** before implementing

**AgnosticUI Accessibility Requirements:**
- WCAG 2.1 AA compliance minimum
- Framework-agnostic solutions preferred
- CSS custom properties for focus indicators
- Consistent behavior across Lit, React, Vue
```

## File: README.md
upstream: https://github.com/agnosticui/agnosticui/blob/master/README.md

````text
<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="./v2/graphics/hero-dark.svg">
    <img src="./v2/graphics/hero-light.svg" alt="AgnosticUI" width="610" />
  </picture>
</p>

<p align="center"><b>Copy the source</b> &nbsp;·&nbsp; <b>Own the code</b> &nbsp;·&nbsp; <b>Framework-agnostic</b> &nbsp;·&nbsp; Built for <b>humans and AI agents</b></p>

<p align="center">
  <strong>One component library. Every framework.</strong>
</p>

<p align="center">
  <a href="https://agnosticui.com">Documentation</a> ·
  <a href="https://www.agnosticui.com/playbooks/login.html">Login AI Playbook</a> ·
  <a href="https://www.agnosticui.com/playbooks/onboarding.html">Onboarding AI Playbook</a> ·
  <a href="https://www.agnosticui.com/playbooks/dashboard.html">Dashboard AI Playbook</a> ·
  <a href="https://www.agnosticui.com/components/button.html">Components</a> ·
  <a href="https://www.agnosticui.com/installation.html">Quick Start</a>
</p>

<br />

---

## Source-first architecture

AgnosticUI components are copied into your project at install time.

They live in your repo (not hidden inside `node_modules`):

- Full control over the source
- Native integration with your framework
- AI-readable, high-fidelity context

---

## You own the source (and the Context)

```bash
cd your-project
npx agnosticui-cli init --framework vue  # or react, lit, svelte
npx agnosticui-cli add Button Card Input
```

The component source lands **directly in your project**. Readable, editable, and yours.

```shell
src/
components/
ag/
Button/
Button.vue ← your file now
Button.css ← your tokens now
Button.test.ts ← your tests now
```

Components land under `src/components/ag/` by default: a dedicated namespace that keeps AgnosticUI components separate from your own. Configurable if you prefer otherwise.

### 🤖 AI-Native by Design

Because the code is local, it solves the "Black Box" problem of traditional libraries hidden in `node_modules`.

**Cursor · Claude · Copilot · Windsurf · Aider · Gemini · Replit · Kiro · Antigravity**

Every tool sees the **raw source**. This creates a high-fidelity environment for **Generative UI** and **Agent-driven interfaces**:

- **Reduce Hallucination:** No more "invented" props or APIs. Since the LLM reads local files like any other code, it knows exactly what is possible.
- **Better Token Efficiency:** Using semantic HTML and standard CSS provides "clean context." Agents spend fewer tokens to understand the UI, leading to faster, more accurate generations.
- **Agent Skills:** Treat [AgnosticUI Playbooks](https://www.agnosticui.com/playbooks/login.html) as pre-defined skills. Use them to prompt an agent to scaffold complex, accessible workflows (Login, Onboarding, Discovery Dashboard, Support Center, Data Grids) using the local components it already "sees."

This is the architecture for the next era of development: **context-aware, framework-agnostic, and AI-ready.**

The schema-driven layer ships with three companion documents:

- [`v2/docs/sdui-architecture.md`](./v2/docs/sdui-architecture.md) — full system architecture: codegen pipeline, node graph model, renderers, CI gates, and key design decisions
- [`v2/docs/llm-prompt-guide.md`](./v2/docs/llm-prompt-guide.md) — copy-paste system prompt template and few-shot examples for generating valid `AgNode[]` graphs
- [`v2/docs/schema-coverage.md`](./v2/docs/schema-coverage.md) — per-component SDUI coverage registry, renderer parity status, and omission reasons

---

## Built once. Runs everywhere.

AgnosticUI's components are authored as **Lit Web Components**, a standards-based layer over native Custom Elements. The CLI wraps them for your framework at copy time.

<p align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="./v2/graphics/architecture-dark.svg">
    <img src="./v2/graphics/architecture-light.svg" alt="AgnosticUI Architecture: AI Playbooks direct the Lit Core, which the CLI ejects into React, Vue, and Svelte" width="860" />
  </picture>
</p>

Your design system doesn't fork when your tech stack does. Supports **agent-generated UI workflows directly from Playbooks**.

...

|                                      | AgnosticUI        | Typical component library |
| ------------------------------------ | ----------------- | ------------------------- |
| Source in your repo                  | ✅                | ❌                        |
| Framework agnostic core              | ✅                | ❌                        |
| LLM-readable locally                 | ✅                | ❌                        |
| AI & agent-driven Playbooks included | ✅                | ❌                        |
| Multiple theme skins                 | ✅                | Limited                   |
| Zero runtime dependency              | ✅ after ejection | ❌                        |

---

## AI Playbooks: AI-Prompt-Driven UI Components

Playbooks (Login Form, Onboarding Wizard, Discovery Dashboard, Support Center, Data Grid, Blog / Article Reader, Landing / Marketing Page) demonstrate **modular, prompt-driven UI components**. Each Playbook can be used in **agent systems**, for **context-aware applications**, or to create **generative UI patterns**.

| Playbook                                                                      | What it builds                                                                                                                                                 |
| ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Login Form](https://agnosticui.com/playbooks/login.html)                     | Responsive login: mobile, floating card, two-column desktop; works with AI prompt-driven generation                                                            |
| [Onboarding Wizard](https://agnosticui.com/playbooks/onboarding.html)         | Multi-step flow with progress, validation, and skip logic; supports agent-assisted workflows                                                                   |
| [Discovery Dashboard](https://agnosticui.com/playbooks/dashboard.html)        | Dashboard shell with header, sidebar, and data regions — ideal for agent-generated interfaces                                                                  |
| [Support Center](https://agnosticui.com/playbooks/support.html)               | Help center with search, categories, and article layout; integrates with prompt-driven workflows                                                               |
| [Data Grid](https://www.agnosticui.com/playbooks/grid.html)                   | Responsive, interactive data grid with sorting, filtering, and multiple view modes; compatible with agent-driven and context-aware interfaces                  |
| [Blog / Article Reader](https://www.agnosticui.com/playbooks/blog.html)       | Typography-first editorial layout with scroll-aware components and in-article search highlighting; theme switcher, dark/light mode, React/Vue/Lit demos        |
| [Landing / Marketing Page](https://www.agnosticui.com/playbooks/landing.html) | Polished product marketing page with hero, features, testimonials, pricing, and FAQ; animated components, theme switcher, dark/light mode, React/Vue/Lit demos |

Each Playbook on the docs site includes live StackBlitz examples for React, Vue, and Lit, and ships with:

- **`PROMPT-3-FRAMEWORKS.md`**: one prompt to generate the pattern across all three frameworks
- **Skin switcher** to preview your theme tokens instantly

**Fully prompt-ready for agent-driven UI generation**. Drop a Playbook prompt into Cursor, Claude Code, or Copilot and watch it assemble `Input`, `Button`, `Card`, and `FormGroup` correctly on the first try — because it has the full recipe, not just a component reference.

The prompts are yours to adapt. Feed o
````
