synthetic-narrative-plan-eval

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of ACE Phase 7 teams releasing synthetic demo narratives that are incoherent, misaligned with project design documents, or fail to resonate with stakeholders, leading to unconvincing product demos that do not effectively showcase opportunity value.

Core Features & Use Cases

  • Multi-Dimension Grading: Evaluates 5 weighted dimensions including PDD anchoring, cast realism, anomaly + coaching coherence, manifest schema validity, and stakeholder narrative quality to holistically assess demo readiness.
  • Hard Guardrails: Enforces blocker and warn triggers for critical failures like invalid field paths, missing coaching arcs, or non-anomaly-aligned KPIs to prevent low-quality demos from progressing to production.
  • Use Case: ACE teams running Stage 4 of Phase 7 Plan B can use this Skill to validate synthetic narrative plan artifacts before generating demo data, ensuring the final demo story is believable, aligned with project goals, and effective for stakeholder presentations.

Quick Start

Invoke the synthetic-narrative-plan-eval skill to grade the synthetic narrative plan for your active ACE opportunity and generate a structured verdict file with scores and gate disposition.

Frequently Asked Questions about synthetic-narrative-plan-eval

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

FAQPage Schema
How do I grade a synthetic narrative plan for realism and validity?

To grade a synthetic narrative plan, evaluate paired markdown and YAML files against project design documents, app deploy summaries, and stakeholder fitness bars. This process generates weighted dimension scores and a structured verdict YAML file.

What is a synthetic narrative evaluation in ACE Phase 7?

Synthetic narrative evaluation in ACE Phase 7 assesses demo readiness by checking narrative coherence, KPI alignment, and character realism. It prevents unconvincing product demos by enforcing quality gates before generating final demo data.

How do you validate a synthetic demo narrative against project design documents?

Validating a synthetic demo narrative involves checking PDD anchoring, cast realism, anomaly coherence, manifest schema validity, and stakeholder narrative quality. This multi-dimension grading ensures the demo story aligns with project goals.

What triggers a hard deduction when evaluating a synthetic narrative plan?

Hard deduct triggers during synthetic narrative evaluation include critical failures like invalid field paths, missing coaching arcs, or non-anomaly-aligned KPIs. These blocker and warn triggers prevent low-quality demos from progressing to production.

Does the synthetic narrative evaluation require any external dependencies?

The synthetic narrative evaluation requires no external dependencies. It operates independently to grade artifacts and output structured verdict YAML files per the lib/verdict-schema.ts specification.

Can I use this evaluation for ACE Phase 7 Plan B workflows?

You can use this evaluation specifically for Stage 4 of ACE Phase 7 Plan B workflows. It validates synthetic narrative plan artifacts before demo data generation to ensure believable stories for stakeholder presentations.