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.