app-connect-coverage

Verify and auto-fix CommCare Connect metadata markers on Nova app forms.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the silent failure mode where Nova's autobuild skips or drops required CommCare Connect metadata markers on app forms, which prevents Connect from enumerating LearnModule, Assessment, DeliverUnit, and TaskUnit records during opportunity sync, leaving opportunities stuck with no deliver units to attach.

Core Features & Use Cases

  • Per-form marker verification: Checks every form in a Nova-built Learn or Deliver app for required Connect markers based on form type and content.
  • Auto-fix with validation: Automatically corrects missing or incorrect markers via Nova edits, re-fetches forms to confirm changes persisted, and loops until the app is clean or hits a known blocker.
  • Standardized reporting: Generates a detailed coverage report with per-form status, fixes applied, and any blockers for operator review.
  • Use case: After Nova autobuilds a Connect Learn app, run this skill to automatically ensure all content forms have learn_module markers and all quiz forms have assessment markers, eliminating manual XML review.

Quick Start

Invoke the app-connect-coverage skill after Nova autobuilds your Connect Learn or Deliver app to automatically verify all form markers are correct and fix any gaps without manual intervention.

Frequently Asked Questions about app-connect-coverage

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

FAQPage Schema
Why does CommCare Connect opportunity sync fail with no deliver units to attach?

CommCare Connect opportunity sync fails silently when Nova's autobuild drops required metadata markers on app forms, preventing the enumeration of LearnModule, Assessment, DeliverUnit, and TaskUnit records. The app-connect-coverage skill verifies and auto-fixes these missing form markers to resolve the sync failure.

How do I check Nova forms for missing CommCare Connect learn_module or assessment markers?

To check Nova forms for missing CommCare Connect markers, the app-connect-coverage skill scans all forms in a target Nova Learn or Deliver app and validates required learn_module and assessment markers based on form type and content structure, outputting a standardized coverage report.

Can I automatically fix missing form markers in a Nova-built Learn app?

The app-connect-coverage skill automatically corrects missing or incorrect CommCare Connect form markers by dispatching parallel update_form mutations via Nova MCP tools, re-fetching forms to confirm changes persisted, and looping until the app is clean or hits a known blocker.

When do I need to verify Connect form markers in Nova apps?

You need to verify Connect form markers in Nova apps immediately after Nova autobuilds your Connect Learn or Deliver app, ensuring all content forms have learn_module markers and all quiz forms have assessment markers before attempting opportunity setup to prevent silent sync failures.

What happens when CommCare Connect form markers are not correctly configured per form type?

When CommCare Connect form markers are not correctly configured per form type, Connect cannot enumerate LearnModule, Assessment, DeliverUnit, and TaskUnit records during opportunity sync, leaving opportunities stuck with no deliver units to attach to the app.

Does the Nova app marker verification process generate a report of applied fixes?

The Nova app marker verification process generates a detailed standardized coverage report in the ACE opportunity directory, listing per-form status, fixes applied, and any known blockers for operator review after the automatic correction loop completes.