skills.rest
benoberkfell
benoberkfellCOMMUNITY
Explore all skills by this author →
GitHub

android-a11y-troubleshooting

Diagnose and fix Jetpack Compose TalkBack issues with semantics and traversal best practices.

Updated Aug 27, 2026
Search Tags:#accessibility#troubleshooting#android#compose#semantics#talkback
One-click install
npx skills add https://github.com/benoberkfell/claude-plugins --skill android-a11y-troubleshooting
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: android-a11y-troubleshooting
Source: https://github.com/benoberkfell/claude-plugins/tree/main/plugins/android-a11y/skills/android-a11y-troubleshooting
Command: npx skills add https://github.com/benoberkfell/claude-plugins --skill android-a11y-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Compose accessibility debugging and fixes for TalkBack issues in Jetpack Compose apps, helping ensure UI content is read correctly and elements are reachable.

Core Features & Use Cases

  • Semantic annotations and proper semantics modifiers to expose content descriptions and roles
  • Traversal order and grouping guidance to ensure TalkBack order matches visual layout
  • Live region and state announcements to communicate dynamic updates
  • Debugging tools and references like semantic tree inspection and layout inspector for faster troubleshooting

Quick Start

Open a Compose project and follow the troubleshooting guide to implement the recommended accessibility fixes for TalkBack issues.

Frequently Asked Questions about android-a11y-troubleshooting

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

FAQPage Schema
How do I fix TalkBack not reading UI content correctly in Jetpack Compose?▼

Fix TalkBack content reading issues by applying Compose semantics modifiers to expose proper content descriptions and roles, ensuring screen readers accurately announce your UI elements.

How do I change the TalkBack traversal order to match my visual layout in Compose?▼

Adjust TalkBack traversal order by applying the traversalIndex modifier and mergeDescendants behavior to group elements, ensuring the reading sequence matches your visual layout.

How do I make TalkBack announce state changes in a Jetpack Compose app?▼

Trigger TalkBack announcements for dynamic updates by applying the liveRegion semantics modifier to your Compose UI, which automatically communicates state changes to the user.

How do I inspect the semantics tree to debug Compose accessibility issues?▼

Debug Compose accessibility issues by using the layout inspector to inspect the semantics tree, allowing you to verify content descriptions, roles, and element reachability.

What's the best way to make Compose elements reachable for screen readers?▼

Ensure Compose elements are reachable by applying accessible actions and proper semantics annotations, exposing interactive components correctly to TalkBack navigation.

When should I use mergeDescendants in Compose semantics for TalkBack?▼

Use mergeDescendants when you need to group multiple Compose UI elements into a single TalkBack announcement, preventing fragmented reading of related content.

Related Skills

Explore More Software Engineering Skills→
soham2008xyzsoham2008xyz

Expo UI Jetpack Compose

Build Jetpack Compose UI screens in Expo apps using @expo/ui/jetpack-compose.

Community
Intermediate
thinhtt264thinhtt264

android-accessibility

Audit Jetpack Compose UI for Android accessibility issues via prompt-driven checklists.

Community
Basic
devanfer02devanfer02

android-accessibility

Identifies Android Jetpack Compose accessibility issues including content descriptions, touch targets, color contrast, focus management, and semantic structuring.

Community
Advanced
yash-gargyash-garg

migrate-xml-views-to-jetpack-compose

Convert Android XML View layouts into Jetpack Compose components.

Community
Advanced