Skip to content

Conversation

@dangelov-qa
Copy link

…refined data and examples

Pull Request Checklist

  • I have read and followed the CONTRIBUTING.md guidelines.
  • My contribution adds a new instruction, prompt, or chat mode file in the correct directory.
  • The file follows the required naming convention.
  • The content is clearly structured and follows the example format.
  • I have tested my instructions, prompt, or chat mode with GitHub Copilot.
  • I have run node update-readme.js and verified that README.md is up to date.

Description

This PR updates and significantly expands the awesome-copilot/chatmodes/accessibility.chatmode.md chat mode to function as a comprehensive “Accessibility Expert” mode aligned to WCAG 2.1/2.2 and optimized for Copilot usage.

Highlights:

Structured like the reference format with sections for Your Expertise, Approach, Guidelines, Checklists, Common Scenarios, Response Style, Advanced Capabilities, Testing Commands, and Best Practices.
WCAG 2.2 additions (focus visibility, target size, drag alternatives, consistent help, accessible authentication, redundant entry).

Copilot-specific enhancements:

  • Operating rules, a11y pre-checks, and a diff review flow.
  • PR review comment template and CI example (axe/pa11y) with local server spin-up and wait.
  • Prompt starters and anti-patterns to avoid.

Framework adapters:

  • React, Angular, Vue (focus/announcements).
  • React Native (accessibilityRole/Label/Hint + announcements).
  • Next.js (App/Pages Router route announcers with aria-live).
  • Angular CDK (FocusMonitor, LiveAnnouncer).

Testing commands and examples:

  • @axe-core/cli, pa11y, and Lighthouse CI snippets.
  • Localhost examples switched to http://localhost:3000 for consistency.
  • Designer/Developer/QA checklists refined to include colorblind-safe palette guidance.

Usage notes:

Use this chat mode in Copilot to review diffs for keyboard/focus, generate accessible component code, and produce a11y test steps.
Prompt starters included for quick, repeatable workflows.


Type of Contribution

  • New instruction file.
  • New prompt file.
  • New chat mode file.
  • Other (please specify): Re-write of an existing chat mode file for greater capabilities.

By submitting this pull request, I confirm that my contribution abides by the Code of Conduct and will be licensed under the MIT License.

Copy link
Contributor

@aaronpowell aaronpowell left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please run the update process to update the readme

@dangelov-qa dangelov-qa force-pushed the feature/accessibility-expert-chat-mode branch from 52d4111 to 4231aab Compare October 30, 2025 06:20
allcontributors bot and others added 4 commits October 30, 2025 09:37
* update README.md

* update .all-contributorsrc

---------

Co-authored-by: allcontributors[bot] <46447321+allcontributors[bot]@users.noreply.github.com>
- Replace 'codebase' with 'search/codebase'
- Replace 'searchResults' with 'search/searchResults'
- Replace 'terminalLastCommand' with 'runCommands/terminalLastCommand'
- Replace 'terminalSelection' with 'runCommands/terminalSelection'

Updated files:
- 13 chatmode files in chatmodes/
- 41 prompt files in prompts/

This update aligns with VS Code's latest tool naming conventions that organize tools into logical namespaces.
@dangelov-qa
Copy link
Author

@aaronpowell I've updated the readme. Would you like me to create a clean one, or will this do the trick? Thank you in advance!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants