Agent skill

Demo With Narration

by lexler in lexler/skill-factory

Demos working software: first proves every claimed behavior by exercising the real artifact, then replays the proof as a slow, voice-narrated walkthrough.

Apache-2.0Auto-check passedMedia & Creative

Install Demo With Narration

skills CLI
$ npx skills add lexler/skill-factory --skill demo-with-narration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install lexler/skill-factory demo-with-narration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/lexler/skill-factory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/output_skills/practices/demo-with-narration .claude/skills/demo-with-narration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
demo-with-narration
GitHub stars
239
Token cost
~715 tokens
SKILL.md length
428 words
Files
1
Skills in repo
25
Repo updated
First seen
Licence
Apache-2.0

At a glance

Demos working software: first proves every claimed behavior by exercising the real artifact, then replays the proof as a slow, voice-narrated walkthrough.

  • Works in 2 steps: Self-demo → Narrated walkthrough
  • The user asks for a demo
  • SKILL.md covers Stage 1: Self-demo, Stage 2: Narrated walkthrough and Desktop-automation safety
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Demo With Narration is an agent skill from lexler/skill-factory. Demos working software: first proves every claimed behavior by exercising the real artifact, then replays the proof as a slow, voice-narrated walkthrough. Use when the user asks for a demo or to be shown that something works.

Its SKILL.md is about 720 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Text to speech and voice. The licence is Apache-2.0.

When your agent uses it

  • The user asks for a demo
  • Be shown that something works

Example prompts

  • “Use the demo-with-narration skill to demo working software: first proves every claimed behavior by exercising the real artifact, then replays the…”
  • “/demo-with-narration”

Workflow steps

2 steps, taken from the step headings in SKILL.md.

  1. Self-demo
  2. Narrated walkthrough

What it can do on your machine

Read from SKILL.md and the folder at commit e262032. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Demo With Narration loads about 715 tokens when it runs. Until then it costs about 61 tokens; SKILL.md has 428 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~715

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from lexler/skill-factory at commit e262032, republished under its Apache-2.0 licence (© lexler). 428 words, ~715 tokens.

Download SKILL.mdSave it as .claude/skills/demo-with-narration/SKILL.md (or your agent's skills folder).
name
demo-with-narration
description
Demos working software: first proves every claimed behavior by exercising the real artifact, then replays the proof as a slow, voice-narrated walkthrough. Use when the user asks for a demo or to be shown that something works.

Demo With Narration

STARTER_CHARACTER = 🎬

A demo is a proof performed twice: once fast and private to convince yourself, once slow and narrated to convince the person watching.

Stage 1: Self-demo

Exercise the real artifact the way its consumer will — the built binary, the running app. A green test suite is the starting point, not the proof.

  • Check every behavior you intend to claim: the happy path, each refusal path with its exact stderr reason and exit code, every way the session can end.
  • Probe at least one path beyond the obvious ones (quit from the menu, not just close the window) — the extra path is where green-suite bugs hide.
  • A detached GUI launch loses its exit status: wrap the launch in a subshell that writes $? to a file, read the file after the window closes.
  • Confirm a window really rendered with a screenshot; drive close and quit through accessibility clicks.

Done when every behavior you will claim in the walkthrough has been observed working, and any bug found is fixed and re-proven.

Stage 2: Narrated walkthrough

Replay the proof slowly. The person asked to follow along, so pace for their eyes and ears.

  • Announce each step by voice (speak) before acting: what is about to happen, what to watch for. Pause a beat so the voice finishes before the action starts.
  • One step per command, numbered. Each step proves exactly one claim.
  • When something appears on screen, say how long it will stay and leave it there — ten seconds for a window is enough to actually look at it.
  • After each step, one or two sentences of text recapping what was just proven.
  • Order the steps as an argument: the input artifact first, then the refusal paths with their exit codes, then the happy path, then every way the session can end.
  • Include at least one step that can only pass if the whole pipeline works — a validation error from the deepest layer surfacing at the outermost one — rather than only surface behaviors.
Show full SKILL.md (95 more words)Show less

Done when every step was announced before it ran, each claim from the self-demo appeared in exactly one step, and a final recap lists every step.

Desktop-automation safety

A System Events keystroke lands on the frontmost application, whatever process the tell block names.

  • Click the specific button or menu item through accessibility instead of synthesizing keystrokes.
  • When a keystroke is unavoidable: bring the target frontmost, read back which app is actually frontmost, and type only if it matches the target.
  • After any slip, list the open windows and confirm nothing else was harmed before continuing.

© lexler, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in output_skills/practices/demo-with-narration of lexler/skill-factory.

Open the folder on GitHubat commit e262032

Compare with similar skills

Demo With Narration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Demo With Narration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Demo With Narration this skilllexler/skill-factory239—~715Automated safety check: PassApache-2.0
MoneyPrinterTurbo Video Generatorharry0703/MoneyPrinterTurbo130k—~2.1kAutomated safety check: WarnMIT
HyperFrames Media Useheygen-com/hyperframes60k—~2.4kAutomated safety check: PassApache-2.0
Openspec OnboardSAP/e-mobility-charging-stations-simulator22725 repos~3.5kAutomated safety check: PassMIT
Blog AudioAgriciDaniel/claude-blog2.3k1 repos~2.2kAutomated safety check: NotesMIT
Musictadaspetra/loop2962 repos~827Automated safety check: PassMIT

Similar skills

  • MoneyPrinterTurbo Video Generator

    harry0703/MoneyPrinterTurbo

    Installs and runs MoneyPrinterTurbo to turn a topic or script into a finished short video with voice-over, subtitles, stock footage and music.

    130k GitHub stars~2.1k tokensUpdated yesterday
    Media & CreativeAuto-check: warnings
  • HyperFrames Media Use

    heygen-com/hyperframes

    Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.

    60k GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Openspec Onboard

    SAP/e-mobility-charging-stations-simulator

    Official

    Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.

    227 GitHub starsUsed in 25 repos~3.5k tokens
    Media & CreativeAuto-check passed
  • Blog Audio

    AgriciDaniel/claude-blog

    Generate audio narration of blog posts using Google Gemini TTS.

    2.3k GitHub starsUsed in 1 repo~2.2k tokens
    Media & CreativeAuto-check: notes
  • Music

    tadaspetra/loop

    Generate music using ElevenLabs Music API. An agent skill from tadaspetra/loop.

    296 GitHub starsUsed in 2 repos~827 tokens
    Media & CreativeAuto-check passed
  • Create News Video

    hoquanghai/Auto-Create-Video

    Tạo video tin tức ngắn 9:16 (~60s) từ URL bài báo hoặc file .txt tiếng Việt.

    319 GitHub starsUsed in 1 repo~3.7k tokens
    Media & CreativeAuto-check passed

More from lexler/skill-factory

All 25 skills in this repo
  • C4 Architecture Diagrams

    lexler/skill-factory

    Creates C4 model diagrams at every zoom level, from system landscape to code, in ASCII, Mermaid or Structurizr, for designing or documenting software architecture.

    239 GitHub stars~2.3k tokensUpdated yesterday
    Auto-check passed
  • Launching Agent Teams

    lexler/skill-factory

    Plans and launches Claude Code agent teams with distinct roles, right-sized tasks and detailed spawn prompts, and says when subagents or worktrees fit better.

    239 GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Claude Code Statusline Writer

    lexler/skill-factory

    Guides writing and debugging Claude Code status line scripts that read session JSON from stdin and print one line of text.

    239 GitHub stars~872 tokensUpdated yesterday
    Auto-check passed
  • Catalog of obstacles, anti-patterns and patterns for working with AI coding agents, covering context management and reliability, from a published patterns collection.

    239 GitHub stars~1.5k tokensUpdated yesterday
    Auto-check passed
  • Approval Testing Toolkit

    lexler/skill-factory

    Writes snapshot-style approval tests in Python, JavaScript, TypeScript or Java, comparing output against an approved file instead of writing individual assertions.

    239 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed
  • Hotspots

    lexler/skill-factory

    Find where a codebase actually costs time by mining its git history (Tornhill hotspot analysis).

    239 GitHub stars~1.2k tokensUpdated yesterday
    Auto-check passed

Questions about Demo With Narration

What does Demo With Narration do?

Demos working software: first proves every claimed behavior by exercising the real artifact, then replays the proof as a slow, voice-narrated walkthrough. Demo With Narration is an agent skill from lexler/skill-factory. Demos working software: first proves every claimed behavior by exercising the real artifact, then replays the proof as a slow, voice-narrated walkthrough.

When should I use Demo With Narration?

Demo With Narration fits situations like: the user asks for a demo; be shown that something works.

How do I install Demo With Narration in Claude Code?

Run `npx skills add lexler/skill-factory --skill demo-with-narration -a claude-code`. Or copy the skill folder (output_skills/practices/demo-with-narration in lexler/skill-factory) into .claude/skills/demo-with-narration in your project. Claude Code loads it when a task matches its description.

How do I install Demo With Narration in Codex?

Run `npx skills add lexler/skill-factory --skill demo-with-narration -a codex`. Or copy the skill folder (output_skills/practices/demo-with-narration in lexler/skill-factory) into .agents/skills/demo-with-narration in your project. Codex loads it when a task matches its description.

Can I use Demo With Narration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add lexler/skill-factory --skill demo-with-narration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/demo-with-narration, .gemini/skills/demo-with-narration, .github/skills/demo-with-narration and .opencode/skills/demo-with-narration in your project.

What does Demo With Narration need to run?

SKILL.md names no scripts, command-line tools or credentials: Demo With Narration is instructions for the agent only.

Does Demo With Narration access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Demo With Narration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Demo With Narration use?

Demo With Narration is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Demo With Narration use?

About 715 tokens (SKILL.md is roughly 2.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Demo With Narration?

Skills that share tags, products or a category with Demo With Narration: MoneyPrinterTurbo Video Generator (harry0703/MoneyPrinterTurbo, 130k stars), HyperFrames Media Use (heygen-com/hyperframes, 60k stars), Openspec Onboard (SAP/e-mobility-charging-stations-simulator, 227 stars) and Blog Audio (AgriciDaniel/claude-blog, 2.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Demo With Narration?

lexler (a GitHub user) maintains it in lexler/skill-factory, which has 239 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 10, 2026.

Source: lexler/skill-factory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.