app-test-cases

Generate Maestro test recipes from PDD journeys for Nova-built CommCare and Connect apps.

1|2|Updated Apr 1, 2026
One-click install
npx skills add https://github.com/dimagi-internal/ace --skill app-test-cases
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: app-test-cases
Source: https://github.com/dimagi-internal/ace/tree/main/skills/app-test-cases
Command: npx skills add https://github.com/dimagi-internal/ace --skill app-test-cases

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the tedious, error-prone manual work of authoring mobile test cases for Nova-built CommCare and Connect apps, ensuring test selectors match the live built app structure instead of outdated pre-build PDD labels.

Core Features & Use Cases

  • Journey-to-Test Binding: Maps Phase 1 PDD user journeys directly to the structure of Nova-built Learn and Deliver apps, ensuring test coverage aligns with original product intent.
  • Live Selector Calibration: Generates Maestro test recipes using real form/field labels from Nova's get_form API and the authoritative mobile atlas, eliminating selector drift from pre-build naming conventions.
  • Smoke & Deep Test Coverage: Automatically generates the two required smoke test recipes (one per Learn and Deliver app) for Phase 6 screenshot capture, and catalogs all deep journeys for on-demand QA deep testing.
  • Use Case: For a Connect opportunity with a Learn training app and a Deliver service visit app, this skill automatically generates the smoke test recipes that walk through the full Learn flow and resume into the Deliver flow, with all selectors calibrated to the live built app.

Quick Start

Run the app-test-cases skill after Nova finishes building the Learn and Deliver apps for your Connect opportunity to generate the required Maestro smoke test recipes and full journey test catalog.

Frequently Asked Questions about app-test-cases

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

FAQPage Schema
How do I generate Maestro test recipes from PDD user journeys for CommCare apps?

To generate Maestro test recipes from PDD user journeys, this Skill binds Phase 1 PDD journeys to the live structure of Nova-built CommCare and Connect apps, creating selector-accurate test recipes calibrated against the authoritative mobile atlas.

Why do my mobile test selectors fail after Nova finishes building CommCare apps?

Mobile test selectors fail due to selector drift from pre-build PDD naming conventions. This Skill calibrates Maestro test recipes using real form and field labels from Nova's get_form API and the live built app structure to eliminate outdated selectors.

Can I automate smoke test generation for both Learn and Deliver app archetypes?

Yes, you can automate smoke test generation for Learn and Deliver archetypes. This Skill automatically generates two required smoke test recipes, one per app, walking through the full Learn flow and resuming into the Deliver flow.

Do I need Nova-built apps to create Maestro test recipes for Connect opportunities?

Yes, you need Nova-built apps. This Skill maps Phase 1 PDD user journeys directly to the structure of Nova-built CommCare and Connect mobile apps, using the live built app structure to ensure accurate selectors for Maestro test recipes.

What's the best way to catalog deep user journeys for on-demand QA deep testing?

The best way to catalog deep user journeys is to bind Phase 1 PDD user journeys to the Nova-built app structure. This Skill catalogs all deep journeys for on-demand QA deep testing and generates smoke recipes for Phase 6 screenshot capture.

When should I run test case generation for Connect opportunity mobile app testing?

You should run test case generation after Nova finishes building the Learn and Deliver apps for your Connect opportunity. This ensures the generated Maestro recipes use live form labels from the built apps, satisfying Phase 6 deep QA validation gates.