team-visual-a11y

Audit rendered pages for color contrast, typography, and keyboard focus behavior.

1|Updated May 12, 2026
One-click install
npx skills add https://github.com/tcytan/tecton --skill team-visual-a11y
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: team-visual-a11y
Source: https://github.com/tcytan/tecton/tree/main/.claude/skills/team-visual-a11y
Command: npx skills add https://github.com/tcytan/tecton --skill team-visual-a11y

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams systematically identify and remediate visual accessibility issues by running parallel visual audits and then planning and implementing fixes.

Core Features & Use Cases

  • Deep visual accessibility QA: Performs rendered-level audits for color contrast (OKLCH), typography readability, and focus management.
  • Parallelized pipeline: Runs three auditors concurrently, then synthesizes results into a prioritized remediation plan.
  • Full audit + fix + re-audit: In full mode, implements fixes (including OKLCH color corrections, focus-visible styles, ARIA improvements, skip links, and reduced-motion) and verifies with re-audits.
  • Standards-based verification: Checks against WCAG-related targets (e.g., AA/AAA) with OKLCH contrast and focus indicator rules.

Quick Start

Run the Skill with the request “Do a full visual accessibility audit and fix pass for https://example.com targeting WCAG AA.”

Frequently Asked Questions about team-visual-a11y

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a rendered visual accessibility audit for WCAG AA compliance?

Run a rendered visual accessibility audit by executing the Skill with your target URL and WCAG level. It performs parallel checks for OKLCH color contrast, typography readability, and keyboard focus behavior, then synthesizes a prioritized remediation plan mapped to WCAG criteria.

Can I automatically fix color contrast and keyboard focus issues and then re-audit?

Yes, full audit mode applies fixes for OKLCH color corrections, focus-visible styles, ARIA improvements, and skip links. It then validates convergence by running a re-audit to verify that visual accessibility issues are fully remediated.

What is OKLCH contrast checking and when do I need it for visual accessibility?

OKLCH contrast checking evaluates rendered color combinations for WCAG compliance using the OKLCH color space. You need it during visual accessibility QA to accurately measure and correct perceived lightness differences between text and background elements.

Does this visual accessibility audit work for both single pages and full-site scopes?

Yes, the visual accessibility audit supports both single-page and full-site scopes. It uses a team-worker architecture to coordinate parallel auditor tasks, persisting session state under the workflow directory for either assessment type.

What is the best way to remediate typography readability and focus management issues?

The best way to remediate typography and focus issues is using a parallelized pipeline that audits rendered pages, synthesizes results into a prioritized plan, and applies fixes like focus-visible styles and reduced-motion settings before verifying convergence.

What limitations exist when running audit-only assessments without applying fixes?

Audit-only assessments identify visual accessibility issues and generate a remediation plan but do not apply OKLCH color corrections, ARIA improvements, or skip links, nor do they perform the re-audit verification needed to confirm fixes.