AGENT SKILL

modern-accessible-html-jsx

Write clean, modern, and highly accessible HTML & JSX code, using semantically correct elements and attributes

License 许可
MIT
最近更新
2026-10-23
Stars
★ 1
Forks
0

01 前言 Front Matter

name
modern-accessible-html-jsx
description
Write clean, modern, and highly accessible HTML & JSX code, using semantically correct elements and attributes

03 SKILL.md 正文

Clean & Accessible HTML

We write semantic, accessible, standards-compliant HTML by default. Accessibility is a baseline requirement, not an enhancement.

Semantics First

  • PREFER semantic elements (header, nav, main, section, article, footer)
  • AVOID generic div/span usage when a semantic element exists
  • Use correct heading hierarchy (h1 → h6) without skipping levels

Accessibility

  • ALWAYS ensure interactive elements are keyboard accessible
  • PREFER native HTML elements over ARIA whenever possible
  • DO NOT use ARIA to fix bad HTML semantics
  • Provide accessible names for all interactive controls
    • Labels for inputs
    • aria-label or visible text where required

Forms & Inputs

  • ALWAYS associate labels with form controls
  • PREFER input types (email, url, tel, etc.)
  • Ensure error messages are accessible and announced properly

Images & Media

  • ALWAYS provide meaningful alt text for images
  • Use empty alt="" only for purely decorative images
  • Provide captions (figcaption) where context matters

Landmarks & Structure

  • Use landmark roles implicitly via semantic elements
  • Ensure a single, clear main region
  • Structure content for screen readers, not just visual layout

General Principles

  • HTML is the foundation — do not fight it
  • Accessibility is non-negotiable
  • If it works without CSS or JS, it’s probably correct

04 同仓库更多 Skills

Phenomenon-Studio
Phenomenon-Studio/phenomenon-configs

web-security

Enforce web security and avoid security vulnerabilities.

★ 1
Phenomenon-Studio
Phenomenon-Studio/phenomenon-configs

typescript

Write clean, efficient TypeScript code that follows project conventions and advanced type patterns. Use when writing or reviewing TypeScript code, defining types, creating generics, handling errors, or working with React components, Zod schemas, and TanStack libraries.

★ 1
Phenomenon-Studio
Phenomenon-Studio/phenomenon-configs

tanstack-router

TanStack Router patterns for this repo — file-based routing, auth guards, search params, data loading, TanStack Query integration, navigation, and code splitting. Use when creating routes, adding pages, implementing auth flows, working with search/path params, or integrating loaders with TanStack Query.

★ 1
Phenomenon-Studio
Phenomenon-Studio/phenomenon-configs

tanstack-query

TanStack Query patterns for this repo — queryOptions/mutationOptions factories, query key hierarchies, service layer integration, optimistic updates, Suspense usage, error handling, and TanStack Router data loading. Use when creating queries, mutations, API services, query keys, cache invalidation, optimistic updates, or integrating data fetching with routes.

★ 1
Phenomenon-Studio
Phenomenon-Studio/phenomenon-configs

tanstack-form

Build forms using TanStack Form with the project's useAppForm composition, composable field components, Zod validation schemas, FormFieldWrapper error tracking, and form.AppField vs form.Field patterns. Use when creating new forms, adding form fields, writing form validation, or working with TanStack Form in this project.

★ 1
Phenomenon-Studio
Phenomenon-Studio/phenomenon-configs

react

Build clean, modern React components that apply common best practices and avoid common pitfalls like unnecessary state management or useEffect usage.

★ 1