Skip to content

lidge-jun/codexclaw / plugins/codexclaw/skills/dev-frontend

cxc-dev-frontend

Unverified

Use for frontend code and UI fixes. Triggers: CSS, responsive, animation, React, Vue, Svelte, Tailwind, redesign, anti-slop, 프론트엔드, UI 작업, 반응형, 디자인 수정.

FileKindSize
SKILL.mdskill md4.1 KB
agents/openai.yamlconfig169 B
examples/README.mdmarkdown2.6 KB
references/core/a11y-patterns.mdmarkdown5.9 KB
references/core/aesthetics.mdmarkdown16.9 KB
references/core/anti-slop-enforcement.mdmarkdown6.1 KB
references/core/anti-slop.mdmarkdown27.1 KB
references/core/asset-requirements.mdmarkdown24.3 KB
references/core/backend-contracts.mdmarkdown1.9 KB
references/core/brand-asset-sourcing.mdmarkdown4.0 KB
references/core/color-system.mdmarkdown5.7 KB
references/core/consistency-locks.mdmarkdown850 B
references/core/content-surface-pipeline.mdmarkdown7.2 KB
references/core/crud-ui.mdmarkdown2.5 KB
references/core/design-intake.mdmarkdown4.4 KB
references/core/dropdown-layer.mdmarkdown5.8 KB
references/core/i18n-global.mdmarkdown3.1 KB
references/core/implementation.mdmarkdown4.1 KB
references/core/iterative-design.mdmarkdown4.4 KB
references/core/korea-2026.mdmarkdown8.8 KB
references/core/layout-discipline.mdmarkdown10.6 KB
references/core/liquid-glass.mdmarkdown8.5 KB
references/core/logo-sections.mdmarkdown5.5 KB
references/core/mobile-ux.mdmarkdown6.1 KB
references/core/motion.mdmarkdown41.4 KB
references/core/performance-budget.mdmarkdown4.4 KB
references/core/platform-runtime.mdmarkdown5.0 KB
references/core/preflight-full.mdmarkdown4.0 KB
references/core/product-density.mdmarkdown1.9 KB
references/core/prototype-variants.mdmarkdown2.2 KB
references/core/reference-capture.mdmarkdown5.5 KB
references/core/render-grounding.mdmarkdown494 B
references/core/responsive-viewport.mdmarkdown5.4 KB
references/core/role-boundaries.mdmarkdown1.3 KB
references/core/routing-defaults.mdmarkdown943 B
references/core/section-level-sourcing.mdmarkdown8.7 KB
references/core/seo-baseline.mdmarkdown4.4 KB
references/core/soft-3d-asset-gates.mdmarkdown2.1 KB
references/core/theme-switching.mdmarkdown2.1 KB
references/core/token-source-divergence.mdmarkdown5.2 KB
references/core/top-bar.mdmarkdown5.5 KB
references/core/topic-index.mdmarkdown7.6 KB
references/core/typography-wrapping.mdmarkdown9.3 KB
references/core/ux-writing-ko.mdmarkdown2.3 KB
references/core/visual-audit-loop.mdmarkdown5.8 KB
references/core/visual-verification.mdmarkdown7.5 KB
references/core/wcag22-aa.mdmarkdown12.6 KB
references/stack-index.mdmarkdown1.3 KB
references/stacks/astro.mdmarkdown8.1 KB
references/stacks/mobile-native.mdmarkdown10.9 KB
references/stacks/nextjs.mdmarkdown5.7 KB
references/stacks/react.mdmarkdown8.6 KB
references/stacks/svelte.mdmarkdown8.4 KB
references/stacks/vanilla.mdmarkdown5.1 KB
scripts/README.mdmarkdown1.7 KB
scripts/bundle-artifact.shexecutablescript1.5 KB
scripts/init-artifact.shexecutablescript6.8 KB
scripts/shadcn-components.tar.gzbinary19.5 KB

references/core/a11y-patterns.md

View on GitHub
# Accessibility Deep Patterns

Extends the baseline a11y rules in SKILL.md with ARIA authoring patterns, focus management, and screen reader testing.

## ARIA Widget Patterns

Note: a project may unify ALL dropdown-like surfaces under one visual skin
(`dropdown-layer.md` FE-DROPDOWN-LAYER-01), but the ARIA pattern is still
chosen per BEHAVIOR — menu vs listbox/select vs combobox vs dialog. One skin
never means one blanket component.

### Dialog (Modal)

```html
<div role="dialog" aria-modal="true" aria-labelledby="dialog-title">
  <h2 id="dialog-title">Title</h2>
</div>
```

- Trap focus inside (Tab cycles through focusable elements)
- ESC closes, returns focus to trigger element
- `aria-modal="true"` tells screen readers to ignore background

### Tabs

```html
<div role="tablist" aria-label="Settings">
  <button role="tab" id="tab-1" aria-selected="true" aria-controls="panel-1">General</button>
  <button role="tab" id="tab-2" aria-selected="false" aria-controls="panel-2">Advanced</button>
</div>
<div role="tabpanel" id="panel-1" aria-labelledby="tab-1">...</div>
```

- Arrow keys between tabs, Tab into panel content
- Home/End move to first/last tab

### Disclosure (Accordion)

```html
<button aria-expanded="false" aria-controls="content-1">Section</button>
<div id="content-1" hidden>...</div>
```

### Combobox (Autocomplete)

```html
<input role="combobox" aria-expanded="false" aria-controls="listbox-1" aria-autocomplete="list">
<ul role="listbox" id="listbox-1">
  <li role="option">Option 1</li>
</ul>
```

- Arrow keys navigate, `aria-activedescendant` tracks current
- Enter selects, ESC closes

### Toast / Live Region

```html
<div role="status" aria-live="polite" aria-atomic="true"></div>
```

- `polite`: announced after current speech
- `assertive`: interrupts — errors/critical alerts only

## Focus Management

### SPA Route Changes

- Move focus to `<main>` or new page `<h1>`
- Announce route via `aria-live` region
- Never leave focus on a destroyed element

### Dynamic Content

- Content loads: do NOT move focus unless user-initiated
- Content removed: move focus to nearest logical parent
- `tabindex="-1"` for programmatic focus targets

### Focus Order

- Tab order follows visual order (never `tabindex > 0`)
- `tabindex="0"` for custom interactive elements
- Never make non-interactive elements focusable without a role

## Keyboard Navigation

| Pattern | Keys | Behavior |
|---------|------|----------|
| Menu bar | Arrow L/R menus, Arrow D opens, ESC closes | WAI-ARIA menu |
| Grid | Arrow keys cell-to-cell, Enter activates | WAI-ARIA grid |
| Tree view | Arrow U/D siblings, R expand, L collapse | WAI-ARIA tree |
| Carousel | Arrow L/R slides, Tab to controls | Must have pause |
| Command palette | Type to filter, Arrow navigate, Enter select | Combobox variant |

## Unusual Navigation (FE-A11Y-UNUSUAL-NAV-01, STRICT)

There is no accessibility exemption for unusual navigation. Visual hiding,
miniaturized edge controls, hover discovery, counters, and viewport-locked
canvases are allowed only when the same route remains operable and orienting
without the visual effect. SiteInspire unusual-layout winners are evidence for
the visual system, not permission to remove the accessible path.

- Expose semantic `nav`, `main`, and relevant region landmarks.
- Provide a keyboard-visible alternative for every hidden or hover-revealed control.
- Give pointer controls a 44×44px conservative target baseline.
- Expose progress, current item, or route status as text to assistive technology.
- Provide a reduced-motion route that does not depend on spatial animation.
- Keep core content reachable through a non-canvas, non-precision-scroll path.

## Screen Reader Testing

### Quick Test (Every Component)

1. Tab through: can you reach every interactive element?
2. Keyboard only: can you complete the task?
3. Focus indicator visible on every interactive element?
4. Every image/icon has appropriate alt text?

### Full Test (Before Release)

1. macOS VoiceOver (Cmd+F5) + Safari
2. Read page linearly — content order makes sense?
3. Navigate by headings (VO+Cmd+H) — logical outline?
4. Navigate by landmarks (VO+Cmd+L) — main, nav, footer present?
5. Interact with every widget — roles and states announced?
6. Error messages announced when they appear?
7. `prefers-reduced-motion` disables non-essential animation?

### Automated (CI)

- axe-core with the WCAG 2.2 tags in [WCAG 2.2 AA](wcag22-aa.md#automated-pass); a Lighthouse accessibility score is smoke only, never a conformance result
- jest-axe / vitest-axe for component testing
- Pa11y for page-level scanning

## Color & Visual

- Never use color alone to convey meaning
- 3:1 contrast for component boundaries and states needed to identify them, and for meaningful graphics (1.4.11)
- Support `forced-colors` (Windows High Contrast)
- Support `prefers-contrast: more`

## Pre-flight

- [ ] Every modal traps focus and returns focus on close
- [ ] Tab order matches visual order
- [ ] Live regions for dynamic status messages
- [ ] Keyboard reaches every interactive element
- [ ] VoiceOver heading navigation produces logical outline
- [ ] Color is never the sole state indicator

---

## Heading Level Continuity (FE-HEADING-LEVELS-01, DEFAULT)

Source: impeccable detector catalog (skipped heading levels rule).

Do not skip heading levels: `h1` -> `h3` without an `h2` is a semantic error
that breaks screen reader navigation and document outline.

Rules:
- Every page has exactly one `h1`.
- Heading levels increase by one: `h1` -> `h2` -> `h3`. Never skip.
- Heading levels may decrease by any amount (closing a subsection).
- Visual size is independent of semantic level — use CSS, not heading tags, for size.
- Components that render headings should accept a `level` prop or use `aria-level`
  to maintain correct nesting in any context.

Verification: run `document.querySelectorAll('h1,h2,h3,h4,h5,h6')` and check
that levels increase by at most 1. Automated: axe-core `heading-order` rule.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 321kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 197kUpdated Claude CodeCodexVerifiedInstall