pdd-to-learn-app

Generate CommCare Learn training apps from Product Design Documents.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the tedious, error-prone manual work of building CommCare Learn (training) apps from Product Design Documents (PDDs) for Connect opportunities, ensuring consistent app structure and mandatory Connect configuration without hours of manual form building.

Core Features & Use Cases

  • Archetype-aware app generation: Builds correct Learn apps for all PDD archetypes, including standard atomic-visit training apps, minimal focus-group sentinel readiness checks, and per-stage Learn apps for multi-stage opportunities.
  • Built-in Connect compliance: Enforces critical CommCare Connect rules including correct module/assessment slug formatting, percentage-based scoring, no case blocks in Learn forms, and required app naming conventions.
  • Post-build verification: Includes automated field count checks and pre-deploy validation to catch missing fields or configuration gaps before the app is released to field workers.
  • Use Case: For a new Connect opportunity with a finalized PDD, use this skill to generate a fully configured, deployable Learn app in minutes instead of hours of manual work, with guaranteed compliance with Connect's requirements.

Quick Start

Use the pdd-to-learn-app skill to generate a CommCare Learn training app for your current Connect opportunity's PDD.

Frequently Asked Questions about pdd-to-learn-app

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

FAQPage Schema
How do I automate CommCare Learn training app generation from a PDD?

Automate CommCare Learn training app generation by using a skill that reads your Product Design Document and outputs a fully configured, deployable app. It eliminates manual form building and configuration errors for Connect opportunities.

What CommCare Connect configuration constraints are enforced during app generation?

CommCare Connect configuration constraints enforced include correct module and assessment slug formatting, percentage-based scoring, and no case blocks in Learn forms. The generated app must match these mandatory rules before deployment.

Can I generate Learn apps for different Connect opportunity archetypes like focus-group sentinel?

Yes, you can generate Learn apps for all Connect opportunity archetypes including atomic-visit training, minimal focus-group sentinel readiness checks, and multi-stage per-stage Learn apps within the ACE lifecycle workflow.

Does the app build process include verification before deployment to field workers?

Yes, the app build process includes post-build field verification with automated field count checks and pre-deploy validation. This catches missing fields or configuration gaps before releasing the app to field workers.

What is the best way to avoid manual configuration errors when building CommCare Learn apps?

The best way to avoid manual configuration errors is automating the build from a finalized PDD. This enforces mandatory Connect constraints and includes post-build verification to ensure the generated app matches the PDD specification.