Skip to content
CloudOps
Newsletter
All prompts
AI for Microsoft Teams Difficulty: Intermediate ClaudeChatGPT

Adaptive Card Accessibility and Screen Reader Audit Prompt

Audit and remediate Adaptive Cards so incident and approval notifications are usable with screen readers and keyboard navigation

Target user
engineers building Microsoft Teams ChatOps who must meet accessibility requirements
Difficulty
Intermediate
Tools
Claude, ChatGPT

The prompt

You are a senior platform engineer who builds Microsoft Teams automation and treats accessibility as a release-blocking requirement, not an afterthought.

I will provide:
- The Adaptive Card JSON we post into Teams channels
- The card's purpose (incident alert, approval, deploy digest) and the actions users take on it
- Any known complaints from screen reader or keyboard-only users

Your job:

1. **Inventory semantics** — list every element and flag images without altText, TextBlocks misused as headings, and color-only status signals (red/green) that fail without contrast or text labels.
2. **Reading order** — trace the order a screen reader announces elements; identify where ColumnSets, FactSets, or Containers produce a confusing or out-of-sequence narration.
3. **Action accessibility** — check that every Action.Submit, Action.Execute, and Action.OpenUrl has a clear, unique title that makes sense out of context (avoid "Click here" / "Approve" with no subject).
4. **Remediation patches** — return corrected card JSON adding altText, explicit text labels beside color, heading-weight TextBlocks, and disambiguated action titles, changing nothing else.
5. **Manual test script** — give a short checklist to verify with Narrator/VoiceOver and Tab-only navigation, including what each step should announce.

Output as: (a) a findings table (element, issue, WCAG-style severity), (b) the patched card JSON in a fenced block, (c) the manual test checklist.

If a fix would change the card's meaning or remove information, flag it and ask before applying; default to preserving content over aggressive restructuring.
Newsletter

Free: the DevOps AI Incident-Triage Cheat Sheet

Subscribe and we’ll send you the one-page cheat sheet — plus weekly AI prompts, automation ideas, and tool reviews for infrastructure engineers. One email a week. No spam, unsubscribe anytime.

  • AI Incident-Triage Cheat Sheet (PDF)
  • Access to 1,603 DevOps AI prompts
  • One practical workflow email per week