video-spec-qa

Validate ace-web video program spec.yaml files with 15 static checks.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires yaml, tsx, and includes scripts (resource) components.

What problem does it solve?

Manual validation of ace-web video program spec.yaml files is time-consuming, inconsistent, and often misses critical structural errors that cause video render failures, invalid content, or wasted production resources.

Core Features & Use Cases

  • 15 Static No-LLM Checks: Runs 15 deterministic checks (YAML parsing, field presence, slug format, placeholder resolution, word budgets, voice compliance, manifest references) in under 50ms with no large language model required.
  • Template-Aware Validation: Automatically applies rules for different video templates (e.g. 60s campaign overview) including required narration beats, per-beat word counts, and impact entry counts, with easy extensibility for new templates.
  • Use Case: When generating video specs via /ace:video-from-program-page or hand-authoring them for ace-web, use this skill to catch all structural issues before rendering, preventing failed builds and ensuring specs meet all requirements for the next evaluation step.

Quick Start

Use the video-spec-qa skill to run all structural checks on the spec.yaml file for your ace-web video program and receive a binary pass/fail verdict with detailed error hints and auto-fix recommendations.

Frequently Asked Questions about video-spec-qa

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

FAQPage Schema
How do I validate an ace-web video spec.yaml file before rendering?

To validate an ace-web video spec.yaml file, run 15 static structural checks on YAML fields, template beats, word budgets, and media references to output a binary pass/fail verdict with auto-fix hints.

Why does my ace-web video spec.yaml fail during the video render stage?

Video spec.yaml files fail during rendering due to structural errors like missing fields, invalid slug formats, or unresolved placeholders. Running a static QA gate catches these issues before they reach the render stage.

Can I validate video narration word budgets and template beats without an LLM?

Yes, you can validate narration word budgets and template beats without an LLM using deterministic static checks. The validation parses YAML structure and verifies per-beat word counts and impact entries automatically.

What is the best way to automate pre-render validation for ace-web video program specs?

The best way to automate pre-render validation is implementing a static QA gate that runs deterministic checks on YAML structure, voice compliance, and manifest references, blocking invalid specs in under 50ms.

Does video spec validation work with hand-authored spec.yaml files or only generated ones?

Video spec validation works with both hand-authored spec.yaml files and files produced by video generation tools. It applies template-aware rules to verify required fields, beats, and media references regardless of authorship.