Agent skill

Pitch Craft Timed Scripts

by ooiyeefei in ooiyeefei/ccc

Writes or fixes spoken scripts that must fit a clock: demo voiceovers, deck narration and pitch speeches, with word budgets, storytelling rules and named trim points.

MITAuto-check passedWriting & Content

Install Pitch Craft Timed Scripts

skills CLI
$ npx skills add ooiyeefei/ccc --skill pitch-craft -a claude-code

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

GitHub CLI
$ gh skill install ooiyeefei/ccc pitch-craft --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/ooiyeefei/ccc.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/pitch-craft .claude/skills/pitch-craft && 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
pitch-craft
GitHub stars
495
Token cost
~1.7k tokens
SKILL.md length
838 words
Files
6 (incl. references)
Skills in repo
22
Repo updated
First seen
Licence
MIT

At a glance

Writes or fixes spoken scripts that must fit a clock: demo voiceovers, deck narration and pitch speeches, with word budgets, storytelling rules and named trim points.

  • Works in 7 steps: Beats before words → Budget the words → Draft with the craft rules → …
  • Writing a voiceover that must match a recorded demo's timestamps
  • SKILL.md covers Steps, Re-syncing an existing script and References
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

This skill produces and repairs scripts that are spoken against a time limit, such as demo-video voiceovers, deck walkthrough narration and live pitch speeches. It treats the clock as a hard limit and the storytelling as the reason a pitch is remembered, and enforces both. It also re-syncs a script after a re-record or a new time slot, and works over scripts that read as robotic or machine-written.

Work starts with beats before words: the agent gets the ordered list of what is on screen or on stage, the fixed windows or total slot, and the claim each beat proves, and a beat with no claim is cut. It then converts seconds into a word ceiling per segment, using about two and a half words per second for voiceover and about two for live speech, and writes that budget at the top of the script.

Drafting follows craft rules from a storytelling reference: a hook before names, an analogy for each abstraction, a throughline that bookends the piece, plain words and numbers repeated where they land. Recorded and live registers are kept apart. A timing check counts words per segment, fixes overruns by cutting rather than rushing, and gives every script one or two named trim points. Written forms, deck HTML and video recording are out of scope.

When your agent uses it

  • Writing a voiceover that must match a recorded demo's timestamps
  • Fitting a live pitch speech into a fixed slot
  • Re-timing a script after re-recording the demo or changing the slot length
  • Fixing a script that sounds robotic or machine-written

Example prompts

  • “Write a pitch script for a five-minute slot, with the demo in the middle.”
  • “Here is my demo recording's milestone timeline. Write the voiceover so each line fits its window.”
  • “Re-time this narration, since the demo got shorter after the re-record.”
  • “This pitch sounds AI-written. Rewrite it so it sounds like a person talking.”

Workflow steps

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

  1. Beats before words
  2. Budget the words
  3. Draft with the craft rules
  4. Timing check
  5. Honesty pass
  6. Human voice - written to be said, not read
  7. Output in the standard formats

What it can do on your machine

Read from SKILL.md and the folder at commit c0fd926. 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

Pitch Craft Timed Scripts loads about 1.7k tokens when it runs, and up to ~5.7k if it reads all its reference files. Until then it costs about 172 tokens; SKILL.md has 838 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~172
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.7k

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 ooiyeefei/ccc at commit c0fd926, republished under its MIT licence (© ooiyeefei). 838 words, ~1,663 tokens.

Download SKILL.mdSave it as .claude/skills/pitch-craft/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
pitch-craft
description
Write or fix any spoken script that has to hit a clock - demo-video voiceovers, deck walkthrough narration, and live pitch speeches. Use whenever the user asks for narration, a voiceover, a timestamp script, a pitch script, a speech that fits N minutes, wants it to "sell like Steve Jobs", or needs an existing script re-synced after a re-record or re-timed to a new slot, or says a script sounds AI-written, robotic, generic, or wants it de-slopped. This is also the engine the demo-video, pitch-deck, and pitch-package skills call for their scripts. Not for - written submission forms or essays (no clock), building deck HTML (pitch-deck), or recording video (demo-video).

Pitch Craft - Timed Spoken Scripts

A timed script is engineering plus theater. The clock is a hard constraint; the storytelling is why anyone remembers you. Every failure mode of a bad script traces to violating one of those two, so this skill enforces both: beats before words, and the craft rules in references/storytelling.md.

Steps

1. Beats before words

Get three things before drafting a single sentence:

  • The beats: what is on screen (or on stage) at each moment, in order. For a demo voiceover these are the recording's milestones - use the sidecar's verified t_video values, never planned holds (see demo-video's Gate 3); for a deck they are the slides; for a live pitch they are slides plus stage moments (team intro, demo break).
  • The clock: either fixed windows from an existing recording (0:16 -> 0:43), or a total slot to budget (a 5-minute pitch).
  • What each beat proves: a beat with no claim behind it gets cut, not narrated.

If the beats don't exist yet, build the beat sheet first and get the user's sign-off. For a demo film that beat sheet is demo-video's storyboard - five columns, journey coverage, Gate 1 approval - not an ad-hoc list. Prose written before beats always runs long and anchors the story to sentences instead of evidence.

2. Budget the words

Read references/timing.md and compute a word ceiling per segment (words = seconds x words-per-second; voiceover ~2.4-2.6 wps, live stage ~2.0-2.2 wps). Write the budget line at the top of the script (e.g. 5:00 slot = ~2:30 spoken + 2:36 demo). If the numbers don't fit before writing, they won't fit after.

3. Draft with the craft rules

Read references/storytelling.md and apply it: hook before names, analogy per abstraction, a throughline that bookends and is re-emphasised where earned (paraphrased, not repeated verbatim), plain words, numbers that land twice. Recorded voiceover and live speech are different registers - never reuse one as the other (see the register section in storytelling.md).

4. Timing check

Count words per segment against its ceiling. Fix overruns by cutting, never by asking the speaker to rush. Every script ships with 1-2 named trim points ("fold #6 into #7, cut #12 to one sentence, saves ~15s") so the speaker can hit the clock live without improvising.

Then run the per-window pacing check in references/timing.md: every segment's words divided by its real window must land in 2.2 - 3.1 w/s. Below that a voice model leaves audible silence; above it the read spills onto the next beat's frames. Check each window - a correct average hides the two segments that break.

5. Honesty pass

Claim only what's wired. Every factual sentence must be verifiable on screen or against the codebase. Over footage this is literal: point at the frame that shows each claim. Claims about agent actions ("it searched", "it remembered", "it chose the cheaper route") need visible evidence in the frame - a tool log, a state panel, a route badge - not just a plausible-looking screen. No frame, no claim (see demo-video/references/storyboard.md). Where on-screen labels differ from reality, use generic phrasing ("a fast model, our strongest model") instead of names that contradict the pixels. Prefer precision rewrites over impressive vagueness ("tracing relationships between accounts, not claiming it's the same banknote"). Judges and buyers probe; one caught overclaim poisons every true claim.

Show full SKILL.md (297 more words)Show less
6. Human voice - written to be said, not read

A script that reads as machine-written loses the room before the content lands. Work references/human-voice.md over every segment: the audible tells, the written-only patterns that do not apply, and the carve-outs for things this skill puts there on purpose (a throughline bookending the script is craft, not a rule-of-three tell).

Two ordering rules, both load-bearing:

  • Run this before the final pacing check. It rewrites, so it moves word counts. Cutting filler usually buys clock, so reach for it before cutting a claim.
  • Re-run the honesty pass afterwards. Rewriting for flow is how a precise claim drifts into a vague or larger one. For a demo voiceover, that means back through the claim-to-frame audit too.

Then read each segment aloud once. These patterns scan smoothly on the page and are obvious in the ear, which is the only place they matter.

7. Output in the standard formats

Recorded (chunked to milestones):

1. 0:00 -> 0:16
An analyst opens a queue of twelve hundred alerts. The rule engine closes
eleven hundred sixty-five under policy, each with a sealed reason.

Live (slide-anchored, with stage cues):

[2:35 - Slide 7 - Proof, then roll the demo]
Most demos ask you to just believe them. We'd rather show you.
(cue: click through slides 8-10 as you say it, then roll the video)
>>> PLAY DEMO VIDEO (~2:10) - this covers slides 8, 9, 10 <<<

The demo-break marker always states what the video covers, so a numbering jump never reads as a gap.

Re-syncing an existing script

When a recording is redone, milestones shift (live backends have latency variance). Map each segment's cue point to the new milestone timestamps and cut prose to the new window - never stretch prose to fill. 1-2 seconds of drift per segment is acceptable. Details in references/timing.md.

References

  • references/storytelling.md - the craft: hook, team intro placement, analogies, throughline, registers, delivery cues, honesty guardrails. Read before drafting.
  • references/timing.md - words-per-second tables, the per-window pacing band, formats, estimation loop, trim points, re-sync procedure. Read before budgeting.
  • references/human-voice.md - the audible AI tells, what does not transfer from prose advice, the carve-outs this skill needs protected, and the tells that only exist in speech. Read before the timing check.

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

Files

SKILL.md and 5 other files (references) in skills/pitch-craft of ooiyeefei/ccc.

  • SKILL.md
  • README.md
  • evals/evals.json
  • references/human-voice.md
  • references/storytelling.md
  • references/timing.md

Open the folder on GitHubat commit c0fd926

Compare with similar skills

Pitch Craft Timed Scripts 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.

Pitch Craft Timed Scripts compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Pitch Craft Timed Scripts this skillooiyeefei/ccc495—~1.7kAutomated safety check: PassMIT
Script Writerailabs-393/ai-labs-claude-skills455—~4kAutomated safety check: PassMIT
Humanized Chinese Writing PolisherEthanYoQ/agent-xiaohongshu-workbench154—~1.1kAutomated safety check: PassMIT
Sun-Style Restrained Narrative WritingKKKKhazix/sun-style-writing403—~1.7kAutomated safety check: PassMIT
Evidence-Grounded Video Writerliuluhaixiu/DaVinci-AutoEdit-Agent484—~711Automated safety check: PassMIT
Seedance Interview1370998960-del/https-github.com-Emily2040-seedance-2.0241—~2.6kAutomated safety check: PassMIT

Similar skills

  • Script Writer

    ailabs-393/ai-labs-claude-skills

    This skill should be used whenever users need YouTube video scripts written.

    455 GitHub stars~4k tokensUpdated 11 mo ago
    Writing & ContentAuto-check passed
  • Humanized Chinese Writing Polisher

    EthanYoQ/agent-xiaohongshu-workbench

    A skill your agent uses when a user asks to polish, rewrite, humanize, de-AI, localize, or oralize Chinese writing, including short-video scripts, articles, social posts, speeches, newsletters, and…

    154 GitHub stars~1.1k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Sun-Style Restrained Narrative Writing

    KKKKhazix/sun-style-writing

    Writes Chinese first-person nonfiction in a restrained plain-description style: short sentences, exact numbers, objects that carry feeling and silence at the peak.

    403 GitHub stars~1.7k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Evidence-Grounded Video Writer

    liuluhaixiu/DaVinci-AutoEdit-Agent

    Writes video scripts, narration, titles and hooks from an approved media review, offers story directions first, and never invents footage, quotes or facts.

    484 GitHub stars~711 tokensUpdated 4 mo ago
    Media & CreativeAuto-check passed
  • Seedance Interview

    1370998960-del/https-github.com-Emily2040-seedance-2.0

    This skill should be used when the user has a vague Seedance 2.0 video idea and asks for creative guidance, story development, scene planning, a director interview, or help turning an undeveloped…

    241 GitHub stars~2.6k tokensUpdated 3 mo ago
    Media & CreativeAuto-check passed
  • 60-Second Cinematic Story Director

    karuvanan/MiniMax-H3-Director-Cut-Studio

    Adapts prose or rough story material into a roughly 60-second MiniMax H3 short with shot planning, Mandarin dialogue and voice-over, and a strong ending.

    132 GitHub stars~1.8k tokensUpdated today
    Media & CreativeAuto-check passed

More from ooiyeefei/ccc

All 22 skills in this repo
  • Turns meeting recordings into notes with a chain of custody from audio to claim, auditing transcripts for gaps and low-confidence numbers and names.

    495 GitHub stars~876 tokensUpdated 2 mo ago
    Auto-check passed
  • Builds marketing and explainer videos in Remotion from rendered scenes, with one real product capture as proof, and cuts them for each platform's formats.

    495 GitHub stars~2.9k tokensUpdated 2 mo ago
    Auto-check passed
  • Records a sharp product demo video by driving the real app with a browser agent, from storyboard to Xvfb capture and a narration script synced to the frames.

    495 GitHub stars~2.8k tokensUpdated 2 mo ago
    Auto-check passed
  • Generates architecture diagrams as .excalidraw files by analyzing a codebase, with optional PNG or SVG export through Playwright.

    495 GitHub stars~2k tokensUpdated 2 mo ago
    Auto-check passed
  • Sets up GA4 on a website and wires one real conversion event end to end, verified in DebugView before any money goes into ads.

    495 GitHub stars~2.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Builds or rewrites SaaS landing pages by researching the real product, positioning it against alternatives and writing buyer-focused copy, then implementing it in the codebase.

    495 GitHub stars~1.8k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Pitch Craft Timed Scripts

What does Pitch Craft Timed Scripts do?

Writes or fixes spoken scripts that must fit a clock: demo voiceovers, deck narration and pitch speeches, with word budgets, storytelling rules and named trim points. This skill produces and repairs scripts that are spoken against a time limit, such as demo-video voiceovers, deck walkthrough narration and live pitch speeches. It treats the clock as a hard limit and the storytelling as the reason a pitch is remembered, and enforces both.

When should I use Pitch Craft Timed Scripts?

Pitch Craft Timed Scripts fits situations like: writing a voiceover that must match a recorded demo's timestamps; fitting a live pitch speech into a fixed slot; re-timing a script after re-recording the demo or changing the slot length; fixing a script that sounds robotic or machine-written.

How do I install Pitch Craft Timed Scripts in Claude Code?

Run `npx skills add ooiyeefei/ccc --skill pitch-craft -a claude-code`. Or copy the skill folder (skills/pitch-craft in ooiyeefei/ccc) into .claude/skills/pitch-craft in your project. Claude Code loads it when a task matches its description.

How do I install Pitch Craft Timed Scripts in Codex?

Run `npx skills add ooiyeefei/ccc --skill pitch-craft -a codex`. Or copy the skill folder (skills/pitch-craft in ooiyeefei/ccc) into .agents/skills/pitch-craft in your project. Codex loads it when a task matches its description.

Can I use Pitch Craft Timed Scripts 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 ooiyeefei/ccc --skill pitch-craft -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/pitch-craft, .gemini/skills/pitch-craft, .github/skills/pitch-craft and .opencode/skills/pitch-craft in your project.

What does Pitch Craft Timed Scripts need to run?

SKILL.md names no scripts, command-line tools or credentials: Pitch Craft Timed Scripts is instructions for the agent only.

Does Pitch Craft Timed Scripts 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 Pitch Craft Timed Scripts 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 Pitch Craft Timed Scripts use?

Pitch Craft Timed Scripts is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Pitch Craft Timed Scripts use?

About 1.7k tokens (SKILL.md is roughly 6.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4k tokens, read only when the agent opens those files.

What are the alternatives to Pitch Craft Timed Scripts?

Skills that share tags, products or a category with Pitch Craft Timed Scripts: Script Writer (ailabs-393/ai-labs-claude-skills, 455 stars), Humanized Chinese Writing Polisher (EthanYoQ/agent-xiaohongshu-workbench, 154 stars), Sun-Style Restrained Narrative Writing (KKKKhazix/sun-style-writing, 403 stars) and Evidence-Grounded Video Writer (liuluhaixiu/DaVinci-AutoEdit-Agent, 484 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Pitch Craft Timed Scripts?

ooiyeefei (a GitHub user) maintains it in ooiyeefei/ccc, which has 495 GitHub stars. The repository holds 22 skills in this directory. The repository was last updated on July 29, 2026.

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