neura11y

AI-Ready Knowledge Base

Accessibility knowledge,
structured for AI.

neura11y is a structured accessibility knowledge base built for AI context loading and RAG pipelines. 88 markdown files covering WCAG 2.2, WAI-ARIA, seven social platforms, document formats, legal compliance, component patterns, and more — all with YAML frontmatter for clean ingestion.

How to use it View on GitHub (opens in a new tab)
  • 88 markdown files
  • 87 WCAG 2.2 SCs covered
  • 7 social platforms
  • 8 component patterns
01 Process

Four steps to get started

The repo does the heavy lifting once you hand the right files to the model. Keep bundles focused — don't attach everything at once.

  1. STEP 01

    Clone or download the repo

    Put it in the same workspace or project context your AI tool can access — a local folder, a Claude project, or a RAG pipeline.

  2. STEP 02

    Attach the routing files first

    Start every session with AI-USAGE-GUIDE.md and INDEX.md. These tell the AI what's in the repo and how to use it.

  3. STEP 03

    Add a focused task bundle

    Pick files for your specific task from the bundles below. A tight context window beats a large one full of noise.

  4. STEP 04

    Review the AI output

    Treat results as assisted draft work. Verify thresholds, SC numbers, and any platform-specific claims against official sources.

02 Use cases

What you can do with it

Load the relevant files for your task and let the model do the work — grounded in real standards, not general knowledge.

  • Web

    Build or audit a page

    Generate accessible components, review HTML for WCAG 2.2 issues, and get ARIA patterns for modals, tabs, carousels, comboboxes, and more.

  • Documents

    Create accessible documents

    Get step-by-step guidance for Word, PowerPoint, Excel, and PDF. Covers heading structure, alt text, reading order, and plain language.

  • Social media

    Write accessible social posts

    Generate alt text, captions, and accessible copy for Twitter/X, Instagram, LinkedIn, YouTube, TikTok, Facebook, and Mastodon.

  • Compliance

    Navigate legal requirements

    Understand WCAG conformance levels, Section 508, and regional law — US ADA, EU EAA, UK PSBAR, Canada ACA, and Australia DDA.

03 Coverage

What is in the repository

The repo spans standards, applied guidance, prompt templates, and supporting reference material across every major accessibility domain.

  • WCAG Standards

    All 87 WCAG 2.2 SCs with levels, techniques, and common failures. WCAG 2.1, 3.0 overview, and conformance levels.

  • WAI-ARIA

    Complete roles, states, and properties reference. APG keyboard patterns for 15+ components. Common ARIA mistakes guide.

  • Web Domain

    HTML semantics, focus management, forms, images, SPA patterns, color/contrast, keyboard navigation, and 8 component patterns.

  • Social Media

    Platform guides for all 7 major platforms. Alt text principles and examples, caption standards, audio description, hashtag and inclusive language guides.

  • Documents

    Word, PowerPoint, Excel, and PDF accessibility guides. Plain language standards. Federal Plain Language Guidelines adapted for accessibility use.

  • Cognitive

    COGA overview and design patterns. SC 3.3.8 authentication, SC 3.3.7 redundant entry, error patterns. Dyslexia and ADHD guidance.

  • Color & Visual

    Complete WCAG contrast thresholds, common color pairs, tools. Typography accessibility. Color blindness types, design patterns, and testing.

  • Legal

    US ADA / DOJ 2024 rule. EU European Accessibility Act (2019/882). UK PSBAR 2018 and Equality Act. Canada ACA and AODA.

04 Starter prompt

Paste this into Claude Code or Codex

Run it from your repo root. The knowledge files do the heavy lifting.

starter-prompt.txt

Context

You have access to the neura11y accessibility repository.

Instructions

1. Read AI-USAGE-GUIDE.md and INDEX.md to understand the repository structure and guidelines. 2. Identify and load only the tight, focused bundle of files relevant to this exact task. 3. Use strictly those files as your source material. If they do not fully cover the request, state that clearly rather than filling gaps from general knowledge.

Task

Help me create or review an accessible [HTML page / component / Markdown document / social post]. Pay special attention to WCAG compliance for elements like multimedia captions and semantic structure. Ensure the final code or content prioritizes an intuitive, aesthetic flow rather than relying on dry, rigid logic.

Get the repository

Clone or download at github.com/AYJAYY/neura11y/releases (opens in a new tab). Contributions, corrections, and new platform guides are welcome.

Star on GitHub (opens in a new tab)