Common Mobile Visual TestingSAFE

A collection of Agent Skills Standard and Best Practice for Programming Languages, Frameworks that help our AI Agent follow best practies on frameworks and programming laguages

The instruction file, verbatim from the audited commit — this is the text the model reads, and the surface the audit's instruction layer examines. Quoted here so you can judge it without cloning anything.

---
name: common-mobile-visual-testing
description: Standardizes mobile UI audits, performance/scroll checks, RTL verification, and state-specific testing on iOS/Android.
metadata:
  triggers:
    keywords:
    - visual test
    - mobile test
    - verify ui
    - dark mode test
    - accessibility audit
    - behavioral test
    - visual regression
    - localization test
---

# 🕵 Mobile Visual & Behavioral Testing

## **Priority: P1 (HIGH)**

> [!IMPORTANT]
> **Tier 2 (Methodology)**: Strategy mobile UI/UX audit.
> **Tier 3 (Domain)**: i18n, A11y (Dynamic Type), Platform (Notch/RTL).

## 🧪 Testing Mindset

Analyze diff + answer:
1.  **Change?** (Affected screen, logic path)
2.  **Break?** (Regression, state transition)
3.  **Visual Audit**: Truncate, align, z-order, color.
4.  **Behavioral Audit**: Tap target, nav, data accuracy.

## 📋 Scenario Matrix

| Change Type | Scenarios to Run |
| :--- | :--- |
| **UI/Styling** | Visual Audit + Dark Mode + QoS Check (CPU/Mem) |
| **Navigation** | User Flow + Deep Link + Z-Order |
| **Lists/Grids** | Scroll Test + Pagination + Empty State |
| **i18n/Locale** | RTL + Truncate + Locale Logic |
| **Accessibility** | Dynamic Type + High Contrast + Permission Reason |

## 🛠️ Core Tool Mapping

| Scenario | Appium Tool |
| :--- | :--- |
| **System Alert** | `appium_alert` (check hierarchy first) |
| **Performance** | `appium_mobile_performance_data` (monitor during flow) |
| **Visual Check** | `appium_screenshot` (base/diff) |
| **Layout Audit** | `appium_get_page_source` (hierarchy/aria) |

## 🚫 Anti-Patterns

- **Ignore QoS**: Apps crash/lag under load. **MUST** check and report **QoS** from `appium_mobile_performance_data` (scroll/video).
- **Blind Tap**: Check state before interact. Use `appium_screenshot`.
- **Alert Paralysis**: Unexpected alert? Use `appium_alert` → `accept`/`dismiss`.
- **Happy-Path Bias**: Never ignore Empty, Loading, or Error state.
- **Deep Link Neglect**: Verify "Cold Start" via deep link.
- **Single-Device Tunnel Vision**: Verify smallest/largest screen size.

## 📁 Evidence

`.appium-mcp/<session>/` holds `<AC|step>-<before|after>.png`, `<label>.source.xml`, `perf.json` (QoS proof), `video.url`. Driver rung and dir go in the walkthrough `driver:` / `evidence_dir:` lines.

## 🔗 References

- **appium-mcp**: [appium-mcp](../../quality-engineering/quality-engineering-appium-mcp/SKILL.md)
- **Driver Ladder**: [driver-ladder](../../quality-engineering/quality-engineering-appium-mcp/references/driver-ladder.md) — local then cloud, BLOCKED rule.
- **Scenario Details**: [scenarios](references/scenarios.md)

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

What the source does

Filesystem

none-observed

Network

none-observed

Shell

none-observed

Dependencies

pinned

Secrets in source

none-found

Findings (0)

No findings outside the package's declared scope.

Gates applied: no_behavioural_pass.