skills.rest
dimagi-internal
dimagi-internalOFFICIAL
Explore all skills by this author →
GitHub

synthetic-narrative-plan-qa

Validate synthetic narrative plan YAML manifests with static Zod-based checks.

1|2|Updated Apr 1, 2026
Search Tags:#auto-fix#structural-checks#synthetic-data#zod-validation#ace-lifecycle#connect-labs#manifest-qa
One-click install
npx skills add https://github.com/dimagi-internal/ace --skill synthetic-narrative-plan-qa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: synthetic-narrative-plan-qa
Source: https://github.com/dimagi-internal/ace/tree/main/skills/synthetic-narrative-plan-qa
Command: npx skills add https://github.com/dimagi-internal/ace --skill synthetic-narrative-plan-qa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the slow, costly failures that occur when malformed synthetic narrative plan manifests are sent to the Connect Labs MCP for processing. It runs fast static validation checks locally first, catching structural issues before they burn a full labs dispatch round-trip, saving time and compute resources.

Core Features & Use Cases

  • 9 Static Zod-Based Checks: Validates YAML parsing, required top-level keys, FLW persona shape and valid archetypes, beneficiary cohort structure and valid field distribution tags, KPI field path resolvability against deliver-app summaries, anomaly traceability, coaching arc cross-references with personas, random seed presence, and timeline date consistency.
  • Structured Auto-Fix Hints: Returns clear, actionable fix suggestions for each failed check, allowing the ACE orchestrator to automatically regenerate the manifest without manual intervention.
  • Use Case: When generating synthetic data for a Connect opportunity in Phase 7 of the ACE lifecycle, run this QA step immediately after creating the synthetic-narrative-plan.yaml manifest to catch structural errors like missing required keys, invalid progression values, or mismatched field distributions before submitting the manifest to the labs generator.

Quick Start

Run the synthetic-narrative-plan-qa skill on the generated 7-synthetic/synthetic-narrative-plan.yaml manifest to validate its structure and receive auto-fix hints for any detected issues.

Frequently Asked Questions about synthetic-narrative-plan-qa

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

FAQPage Schema
How do I validate a synthetic narrative plan YAML manifest before submission?▼

To validate a synthetic narrative plan YAML manifest, run static structural checks using Zod schemas to catch malformed content like missing required keys or invalid progression values before dispatching to the Connect Labs MCP.

What structural checks prevent malformed synthetic data manifests from failing?▼

Structural checks for malformed synthetic data manifests include verifying YAML parsing, required top-level keys, FLW persona archetypes, beneficiary cohort field distributions, KPI field path resolvability, anomaly traceability, coaching arc cross-references, random seed presence, and timeline date consistency.

Can I automatically fix YAML schema errors in synthetic narrative plans?▼

Yes, you can automatically fix YAML schema errors by returning structured auto-fix hints for each failed structural check, enabling the ACE orchestrator to regenerate the manifest without manual intervention.

When should I run static validation on synthetic narrative plan manifests?▼

Run static validation on synthetic narrative plan manifests immediately after creating the YAML file in Phase 7 of the ACE lifecycle, ensuring schema alignment with upstream Pydantic contracts before submitting to the labs generator.

Why does my synthetic data generation fail during Connect Labs dispatch?▼

Synthetic data generation fails during Connect Labs dispatch when malformed manifests are sent without prior static validation, wasting compute resources on full labs round-trips that could be caught locally first.

Does Zod validation work with Pydantic contracts for ACE lifecycle workflows?▼

Yes, Zod validation works with Pydantic contracts by validating the manifest schema alignment locally in ACE lifecycle Phase 7 workflows, ensuring the synthetic narrative plan satisfies upstream structural requirements before labs processing.

Related Skills

Explore More Product & Management Skills→
dimagi-internaldimagi-internal
1

synthetic-narrative-plan-eval

Grade paired synthetic-narrative-plan.md and .yaml files against PDD anchors.

Official
Advanced
dimagi-internaldimagi-internal
1

synthetic-data-generate

Generate synthetic frontline worker, visit, and payment datasets for ACE Connect demos.

Official
Advanced
dimagi-internaldimagi-internal
1

synthetic-walkthrough-spec-qa

Validate walkthrough spec YAMLs with seven static structural contract checks.

Official
Intermediate
Endor-Solutions-ArchitectureEndor-Solutions-Architecture
2

endor-fix

Automate vulnerability remediation and propose safe upgrade paths in Endor Labs MCP projects.

Official
Advanced