hci-android-native
Applies human-computer interaction and accessibility principles to native Android apps built with Views (XML) or Jetpack Compose. Use whenever the user builds, reviews or fixes Android UI and cares about TalkBack, contentDescription, touch targets of 48dp, text in sp, forms and k
Install
npx skills add https://github.com/MehranQadirian/skills/tree/main/hci/hci-android-native
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install mehranqadirian-skills@llmmart
git clone https://github.com/MehranQadirian/skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole mehranqadirian/skills collection as a plugin from our marketplace. Git is the plain clone.
README
hci-android-native
A Claude skill that applies HCI and accessibility principles to native Android apps, in XML Views and Jetpack Compose.
What it does
- Lints layouts, the manifest and Compose code for missing content descriptions, wrong text units, small targets, physical left and right attributes and missing RTL support
- Gives guidelines for TalkBack semantics, text scaling, feedback, forms, navigation and testing
- Maps each rule to the user impact and the Material convention
Try it
Check this layout XML for accessibility problems.
My Compose screen breaks at the largest font size.
Make my Android app support Persian right-to-left properly.
Install
Claude.ai: zip this folder, then go to Settings > Capabilities > Skills > Upload.
Claude Code:
cp -r hci/hci-android-native ~/.claude/skills/
Structure
hci-android-native/
├── SKILL.md skill instructions for Claude
├── scripts/lint_android_hci.py XML, manifest and Compose linter
└── references/android-guidelines.md guidelines
Skill manifest
hci-android-native
Make an Android app clear, reachable and accessible: names for TalkBack, 48 dp targets, text that scales in sp, Material feedback patterns and correct right-to-left behavior. Builds on hci-foundations.
hci-android-native/
├── SKILL.md
├── scripts/
│ └── lint_android_hci.py layout XML, AndroidManifest.xml and Compose (.kt) checks
└── references/
└── android-guidelines.md semantics, targets, text, feedback, forms, navigation, RTL, testing
When to use
- Building or reviewing layouts and Compose screens
- Fixing TalkBack issues or Accessibility Scanner findings
- Supporting large fonts, large display size, dark theme and Persian or Arabic
- Choosing feedback, error, permission and navigation patterns
Workflow
- Understand the screen: users, key task, form factors, languages, Views or Compose.
- Lint:
python3 scripts/lint_android_hci.py app/src/main(a file or a folder). It reports images withoutcontentDescription, inputs without hints, text sized in dp, tiny text, small clickable elements, physical left and right attributes, missingsupportsRtl, and in Compose:fontSizein dp, small clickable sizes, null descriptions, hardcoded strings and absolute padding. Add--strictto fail on warnings. - Fix in order: errors first (missing names, wrong units), then touch targets and RTL attributes, then forms and feedback, then polish. Use
startandend,spfor text,minimumInteractiveComponentSize()in Compose. - Check against the principles: visibility of status (progress, snackbars), error prevention (input types, undo), consistency with Material (bottom navigation, back behavior), recognition over recall. Cite the heuristic when explaining a change.
- Add checks: enable
AccessibilityChecksin Espresso or add Compose semantics tests, and run Android Lint. - Verify by hand and say what remains: TalkBack through the key task with the screen dimmed, largest font and display size, forced RTL, dark theme, a small phone. A scan cannot judge contrast, focus order or real speech output.
- Report findings, changes and open checks.
Rules
- Every image and icon button has a
contentDescription, or is explicitly decorative - Text is in
sp, layouts indp; never fix text container heights - Touch targets are at least 48 dp with spacing; gestures have alternatives
- Inputs have a visible label or hint, the right
inputTypeand autofill hints - Use
startandend; setsupportsRtl="true"; mirror directional icons only - Use snackbars with Undo instead of confirming every destructive step; keep messages on screen long enough
- Respect system back, window insets, dark theme and reduced animation settings
- Never claim accessibility from a quiet linter
What to report back
| Field | Content |
|---|---|
| Findings | rule, file and line, severity, user impact |
| Changes | what changed and the principle it serves |
| Checks added | Espresso, Compose, Lint |
| Manual checks left | TalkBack, font and display size, RTL, dark theme |
Related skills
hci-foundations: principles and evaluation reportshci-rtl-localization: right-to-left and multilingual detailshci-microcopy: wording for buttons, errors and empty stateshci-usability-testing: validate with real usershci-react-native,hci-flutter,hci-ios-swiftui: other mobile stacks
Files (skills)
-
references
-
android-guidelines.md 4.8 KB
Loading…
-
-
scripts
-
lint_android_hci.py 8.6 KB
Loading…
-
-
README.md 1.1 KB
# hci-android-native A [Claude skill](../../README.md) that applies HCI and accessibility principles to native Android apps, in XML Views and Jetpack Compose. ## What it does - Lints layouts, the manifest and Compose code for missing content descriptions, wrong text units, small targets, physical left and right attributes and missing RTL support - Gives guidelines for TalkBack semantics, text scaling, feedback, forms, navigation and testing - Maps each rule to the user impact and the Material convention ## Try it > Check this layout XML for accessibility problems. > My Compose screen breaks at the largest font size. > Make my Android app support Persian right-to-left properly. ## Install **Claude.ai:** zip this folder, then go to Settings > Capabilities > Skills > Upload. **Claude Code:** ```bash cp -r hci/hci-android-native ~/.claude/skills/ ``` ## Structure ``` hci-android-native/ ├── SKILL.md skill instructions for Claude ├── scripts/lint_android_hci.py XML, manifest and Compose linter └── references/android-guidelines.md guidelines ``` -
SKILL.md 3.9 KB
--- name: hci-android-native description: Applies human-computer interaction and accessibility principles to native Android apps built with Views (XML) or Jetpack Compose. Use whenever the user builds, reviews or fixes Android UI and cares about TalkBack, contentDescription, touch targets of 48dp, text in sp, forms and keyboards, snackbars and feedback, Material design conventions, back navigation, RTL support or large font and display size, even if they only say "improve my Android screen". Lints layouts, manifest and Compose code with a script and fixes issues. --- # hci-android-native Make an Android app clear, reachable and accessible: names for TalkBack, 48 dp targets, text that scales in sp, Material feedback patterns and correct right-to-left behavior. Builds on `hci-foundations`. ``` hci-android-native/ ├── SKILL.md ├── scripts/ │ └── lint_android_hci.py layout XML, AndroidManifest.xml and Compose (.kt) checks └── references/ └── android-guidelines.md semantics, targets, text, feedback, forms, navigation, RTL, testing ``` ## When to use - Building or reviewing layouts and Compose screens - Fixing TalkBack issues or Accessibility Scanner findings - Supporting large fonts, large display size, dark theme and Persian or Arabic - Choosing feedback, error, permission and navigation patterns ## Workflow 1. **Understand the screen**: users, key task, form factors, languages, Views or Compose. 2. **Lint**: `python3 scripts/lint_android_hci.py app/src/main` (a file or a folder). It reports images without `contentDescription`, inputs without hints, text sized in dp, tiny text, small clickable elements, physical left and right attributes, missing `supportsRtl`, and in Compose: `fontSize` in dp, small clickable sizes, null descriptions, hardcoded strings and absolute padding. Add `--strict` to fail on warnings. 3. **Fix in order**: errors first (missing names, wrong units), then touch targets and RTL attributes, then forms and feedback, then polish. Use `start` and `end`, `sp` for text, `minimumInteractiveComponentSize()` in Compose. 4. **Check against the principles**: visibility of status (progress, snackbars), error prevention (input types, undo), consistency with Material (bottom navigation, back behavior), recognition over recall. Cite the heuristic when explaining a change. 5. **Add checks**: enable `AccessibilityChecks` in Espresso or add Compose semantics tests, and run Android Lint. 6. **Verify by hand** and say what remains: TalkBack through the key task with the screen dimmed, largest font and display size, forced RTL, dark theme, a small phone. A scan cannot judge contrast, focus order or real speech output. 7. **Report** findings, changes and open checks. ## Rules - Every image and icon button has a `contentDescription`, or is explicitly decorative - Text is in `sp`, layouts in `dp`; never fix text container heights - Touch targets are at least 48 dp with spacing; gestures have alternatives - Inputs have a visible label or hint, the right `inputType` and autofill hints - Use `start` and `end`; set `supportsRtl="true"`; mirror directional icons only - Use snackbars with Undo instead of confirming every destructive step; keep messages on screen long enough - Respect system back, window insets, dark theme and reduced animation settings - Never claim accessibility from a quiet linter ## What to report back | Field | Content | |-------|---------| | Findings | rule, file and line, severity, user impact | | Changes | what changed and the principle it serves | | Checks added | Espresso, Compose, Lint | | Manual checks left | TalkBack, font and display size, RTL, dark theme | ## Related skills - `hci-foundations`: principles and evaluation reports - `hci-rtl-localization`: right-to-left and multilingual details - `hci-microcopy`: wording for buttons, errors and empty states - `hci-usability-testing`: validate with real users - `hci-react-native`, `hci-flutter`, `hci-ios-swiftui`: other mobile stacks
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.