android-compose-quality-gatelisted
Install: claude install-skill zohaibmushwani/agent-skills
# android-compose-quality-gate
A screen that looks right but breaks offline, in Arabic, on a 360 dp phone or after rotation is not finished. This skill is the checklist and the scripts that catch those defects before the user does.
## Use it in three moments
1. **Planning a screen:** decide the five things in `references/per-screen-decisions.md` (back, network class, permissions, scroll-or-fit, motion) *before* building it.
2. **Building:** follow the rules in `references/` for the area you touch (read only that file).
3. **Finishing:** run the scripts, then walk the acceptance checklist below and report each item as pass / fail / not checked. Do not say "done" on a build that was not run.
## Scripts (Python 3, standard library)
- `scripts/compose_lint.py <src-dir>` - heuristic scan of Kotlin sources: hex colours/`Color(0x..)` outside the theme, `Modifier.offset`, `IntrinsicSize.Min`, `Alignment/Arrangement` left/right words and `paddingLeft/Right`, `android.util.Log`, `Text(` without `maxLines` in a bounded component, UI files without `@Preview`, `GlobalScope`, `!!`, swallowed `CancellationException`. Prints `file:line rule message`; exit 1 on errors. It is a smell detector, not a compiler: read each hit.
- `scripts/strings_audit.py <res-dir>` - compares every `values-<locale>/strings.xml` with the default: missing and extra keys, changed placeholders (`%1$s`, `%d`), missing plural quantities for Arabic (zero, one, two, few, many, other), unescaped apostrophes, untranslat