project-video

Generate evidence-grounded narrated MP4 walkthroughs or HTML previews from repository analysis.

Updated Aug 1, 2026
One-click install
npx skills add https://github.com/QuyDu/Skills-Orchestrator --skill project-video-quydu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-video
Source: https://github.com/QuyDu/Skills-Orchestrator/tree/main/.github/skills/project-video
Command: npx skills add https://github.com/QuyDu/Skills-Orchestrator --skill project-video-quydu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ffmpeg-static, piper-tts, onnxruntime, numpy, pathvalidate, coloredlogs, humanfriendly, flatbuffers, packaging, protobuf, sympy, mpmath, and includes scripts (resource) components.

What problem does it solve? Creating an accurate, project-specific demo video requires manually verifying facts, writing narration, synthesizing voice audio, and rendering video, which is slow and error-prone. This Skill automates that pipeline from VS Code while ensuring every claim in the narration traces back to verified repository evidence. ## Core Features & Use Cases - Evidence-Grounded Narration: Builds a claims ledger from project-understanding reports so every spoken statement cites a repository file, rejecting unsupported claims. - Multiple Production Paths: Produces a zero-install interactive HTML preview with browser speech, a narrated MP4 using Azure Speech or local Piper TTS, or an executive demo with Azure OpenAI scripting and optional Speech Avatar presenter segments. - Governed Approval Workflow: Requires explicit approvals before contacting Azure services, downloading the pinned Piper runtime, installing the FFmpeg renderer, or replacing existing output. - Use Case: After finishing a new API project, invoke the skill to rescan the repository, generate an eight-scene script, audition Azure neural voices, and render a verified two-minute onboarding MP4 under dist/project-video/. ## Quick Start Ask the agent to run /project-video to analyze the current repository and produce a narrated project walkthrough video.

Frequently Asked Questions about project-video

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

FAQPage Schema
How do I create a narrated video walkthrough of my project?

Invoke /project-video after your project implementation is complete. The skill rescans the repository via project-understanding, builds an evidence-bound plan with six to ten scenes, synthesizes narration with Azure Speech or local Piper, and renders a verified MP4 with local FFmpeg.

Can I generate a project video without Azure services?

Yes. Declining Azure discovery selects the browser-preview path, producing a self-contained interactive HTML walkthrough using browser speech. Alternatively, the local-piper path uses the pinned Piper TTS runtime for offline narration rendered into a portable MP4.

What is the difference between Azure Speech and local Piper narration?

Azure Speech provides more natural neural voices but requires a discovered Speech resource, explicit processing and cost approval. Local Piper is the no-cost offline option using the en_US-ljspeech-high model, with a less natural voice and separate download, GPL license, and provenance approvals.

Why is project-video blocked on a newly provisioned repository?

The skill blocks empty governed baselines because there is no verified implementation evidence to narrate. It requires a complete project-understanding report with real blueprint, source, and test content before drafting any narration.

Does the browser preview produce an MP4 or audio file?

No. The browser preview is an interactive HTML page using browser or OS-controlled speech synthesis, which may involve an online service. It never constitutes rendered audio or portable media; only the FFmpeg pipeline produces a verified MP4.

What approvals are required before rendering the final video?

Separate approvals are required for Azure Speech processing and cost, Azure OpenAI scripting, Avatar generation, Piper downloads and licensing, renderer installation, FFmpeg execution, and replacing existing output. Publication or upload is never performed by this skill.