training-deck-generate

Generate a schema-validated training-deck-spec.yaml from project design documents.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill eliminates the tedious, error-prone manual work of creating training decks for Connect opportunities by replacing the legacy brittle markdown outline format with a machine-parseable, template-driven spec that ensures consistency and prevents broken renders.

Core Features & Use Cases

  • Archetype-aware spec generation: Produces a schema-validated training-deck-spec.yaml tailored to the opportunity's archetype (atomic-visit as default, with future support for focus-group and multi-stage workflows).
  • Automated input aggregation: Pulls content from project design documents, learn/deliver app summaries, screenshot manifests, and shared template bundles to populate all required deck modules.
  • Built-in validation and guardrails: Validates image references, checks for unfilled content tokens, enforces the required 4-pillar Connect lifecycle structure, and generates a detailed verdict to catch errors before rendering. Use case: For example, when completing Phase 6 QA and training for a new Connect opportunity, use this skill to automatically generate a complete training deck spec from existing project artifacts, eliminating hours of manual slide creation and formatting work.

Quick Start

Use the training-deck-generate skill to produce a structured training deck spec for the current Connect opportunity after app screenshot capture has finished.

Frequently Asked Questions about training-deck-generate

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

FAQPage Schema
How do I generate a structured training deck spec from project design documents?

You can generate a structured training deck spec by using a template-driven skill that aggregates project inputs into a machine-parseable training-deck-spec.yaml. This single source of truth ensures consistency and prevents broken Google Slides renders.

How does automated validation prevent broken Google Slides training deck renders?

Automated validation prevents broken renders by checking image references, enforcing the 4-pillar Connect lifecycle structure, and detecting unfilled content tokens. It generates a detailed verdict to catch slide structure errors before rendering.

Do I need app screenshot manifests to generate a QA training deck spec?

Yes, app screenshot manifests are required inputs. The spec generation consumes project design documents, learn and deliver app summaries, screenshot manifests, and shared template bundles to populate all required deck modules.

What is the best way to automate Phase 6 QA training deck creation for Connect opportunities?

The best way to automate Phase 6 QA training deck creation is using a schema-validated, archetype-aware spec generator. It replaces the legacy brittle markdown outline format with a structured yaml file tailored to the opportunity's archetype.

Can I use template-driven spec generation for multi-stage workflow archetypes?

Template-driven spec generation currently defaults to the atomic-visit archetype, with future support planned for focus-group and multi-stage workflows. It applies archetype-aware template selection to produce schema-validated deck content.

Why does my training deck spec fail validation for required module coverage?

Spec validation fails when required module coverage is incomplete or content tokens remain unfilled. The built-in guardrails enforce the required 4-pillar Connect lifecycle structure and validate slide structure to catch these errors before rendering.