TechDemoDirector

Code walk-through presentation scripting

File:line references. Speaker notes. One markdown artifact.

View on GitHub How It Works

Six-Step Workflow

1 Understand the subject

2 Explore the codebase

3 Build the narrative arc

4 Assign time budgets

5 Write OPEN + SAY pairs

6 Add quick reference

What It Produces

OPEN Directives

Each talking point opens a specific file at a specific line range. No fumbling for the right spot during a live demo.

SAY Blocks

Full sentences the speaker reads aloud. Not bullet points — complete thoughts paced for delivery.

Narrative Arcs

Four pre-built patterns (linear, layered, problem-solution, before-after) or define your own.

Time Budgets

Per-section time targets with trim/protect guidance so the talk fits the slot.

Quick Start

One-Line Install

bash

$ bash <(curl -fsSL https://barretts.github.io/TechDemoDirector/install.sh)

powershell

PS> irm https://barretts.github.io/TechDemoDirector/install.ps1 | iex

From Source

$ git clone https://github.com/barretts/TechDemoDirector.git
$ cd TechDemoDirector
$ bash install.sh --all    # or .\install.ps1 -All on Windows
--> Installing skills for all detected tools...
==> Done.

Architecture

Skills (what to do)          CLI Companion (tools to do it with)
  skill/skills/*.md            src/cli/commands/*.ts
  skill/fragments/*.md         src/core/*.ts
          |                            |
          v                            v
  compiled/ (7 IDE formats)    dist/ (npm link -> global CLI)
          |                            |
          +---------> Agent <----------+

Ecosystem

Part of the Agentic Skill Mill family.

Agentic Skill Mill

The parent project — fragment-composed skills compiled to 7 IDE targets with a companion CLI.

GitHub

AgentThreader

Manifest-driven agentic CLI orchestration with structured contracts, resumable state, and self-healing.

GitHub

AgentHistoric

Mixture-of-Experts persona prompt system with philosophical grounding.

GitHub