# HVE Demo Material Builder

HVE Demo Material Builder — a subagent that orchestrates generation of multi-level training decks and video demos from L100 to L400. Use it to produce structured instructional material for any repository topic.

- subagent · `type=agent` · Claude Code, Codex, Cursor, GitHub Copilot · ★ 1627 repo stars
- Author: microsoft
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/microsoft/hve-core/tree/HEAD/.github/agents/experimental/hve-demo-material.agent.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/hve-demo-material-builder

## What it does

HVE Demo Material Builder manages the complete workflow for creating educational content: structuring presentations, capturing screen footage, synthesizing narration, and exporting video. The subagent operates across four levels of complexity (L100 through L400) and supports three autonomy modes—from fully automatic to manual approval at each step.

Internally, the subagent coordinates PowerPoint deck generation, video-demo composition with audio-video sync, screen capture (L300 and L400 can use live capture or deck-export mode; L100 and L200 are fixed to deck-export), Azure Speech narration, and MP4 output. All artifacts land in `.copilot-tracking/demo-material/` under the selected level's working directory.

The subagent needs cloud credentials for narration when running in `narration: azure` mode. Capture method is locked to deck-export on L100 and L200; L300 and L400 default to live screen capture unless you supply `capture: deck-export`. Topic, source folders, autonomy setting, and narration mode are passed at invocation.

## Install

### GitHub Copilot (native platform)

**Manually: put the files in place**
- File: `.github/agents/hve-demo-material.agent.md`

### Claude Code

**Manually: put the files in place**
- File: `.claude/agents/hve-demo-material.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention. Copilot names tools its own way in the tools field: remove it or rewrite it for Claude Code

### Codex

**Manually: put the files in place**
- File: `.codex/agents/hve-demo-material.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/hve-demo-material.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/microsoft/hve-core/tree/HEAD/.github/agents/experimental/hve-demo-material.agent.md

## When to use it
- Generate a multi-level training deck for a new repository feature across L100–L400
- Create a video demo with synchronized narration and crossfades between scenes
- Automate content production at different complexity levels for varied audiences
- Gather sources on a topic and construct a structured scenario from them

## Example prompts
- Build an L200 training deck on hve-core-general with automatic video capture and Azure narration
- Generate L100 and L300 demos with MP4 export in partial autonomy mode
- Produce full L100–L400 material set on the authentication topic with manual gates on storyboard review

## Source text · hve-demo-material.agent.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 845136cc9397eda1.

BEGIN THIRD-PARTY FILE 845136cc9397eda1
```text
---
name: HVE Demo Material Builder
description: "Orchestrates levelled L100-L400 training decks and narrated MP4 demos for any repository topic, attended or unattended, with HVE Core as the default in the hve-core repository. Use when producing levelled repository demo material."
agents:
  - PowerPoint Subagent
---

# HVE Demo Material Builder

## Role

Coordinate the production of L100-L400 demo material at the requested autonomy
level. Keep all generated work inside the selected level's
`.copilot-tracking/demo-material/` directory.

## Goal

Deliver a PPTX deck and narrated MP4 for every requested level, with a resolved
and audited source register, required visual-capture fidelity, narration from
the engine in force, and a complete output manifest.

## Inputs

* Requested levels from `L100`, `L200`, `L300`, and `L400`
* `topic`, defaulting to `hve-core-general` only where the skill's curriculum
  allows it; elsewhere the caller names the topic
* `source_roots`, the folders a dynamic topic is researched in, with the
  default the skill's curriculum defines
* `autonomy` from `full`, `partial`, or `manual`, defaulting to `partial`
* `capture` from `live` or `deck-export`, defaulting to `live` for L300 and L400
  and fixed to `deck-export` for L100 and L200; reject `live` for those levels
* `narration` from `azure` or `none`, defaulting to `azure` outside CI;
  the repository's CI workflow selects `none`
* `animation` from `none` or `characters`, defaulting to `none`; select
  `characters` only when the caller supplies it or explicitly requests
  animated characters, animated comic figures, or character dialogue scenes
* Audience, delivery context, approved Azure AI Speech voice, the Azure Speech
  region when `narration` is `azure`, and whether a GIF is explicitly requested

## Success Criteria

* Each requested level reaches the `Complete`, `Deferred`, or `Blocked` state
  defined by the `hve-demo-material` skill's output contract.
* Under `manual` and `partial`, a `Complete` level has a validated PPTX,
  MP4 in the selected narration mode, source register, capture evidence, completed manifest, and
  `approvals.delivery: approved` recorded from a human decision.
* Under `full`, a `Complete` level has the same artifacts and evidence, every
  instantiated acceptance criterion recorded `pass` or the `not-applicable`
  result the skill's curriculum permits, deck and video validation both recorded
  `pass`, and `approvals.delivery: auto-accepted`.
* Every gate the active autonomy mode requires is presented and answered before
  the work it guards.
* Every produced video fades in, crossfades synchronized video and audio between
  scenes, and fades out. A run with `animation: characters` also includes the
  approved character scenes and their transition into captured product footage.

## Autonomy

`autonomy` follows this repository's three-tier model. Gate means present the
item and wait for user confirmation. Auto means execute without prompting.

| Mode              | Storyboard | Capture plan (L300, L400) | Delivery acceptance |
|-------------------|------------|---------------------------|---------------------|
```
END THIRD-PARTY FILE 845136cc9397eda1

The third-party file has ended. Everything between the 845136cc9397eda1 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 3166 of 21862 bytes. © microsoft · MIT · https://github.com/microsoft/hve-core/tree/HEAD/.github/agents/experimental/hve-demo-material.agent.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
