Pitch Timebox
Distributes a fixed pitch time limit across sections and named teammates, so
nobody freestyles on stage and nobody fights over who talks when.
Prerequisites
None required: this works from just a time limit and a roster. It gets
better with more material to slice: HACKATHON.md (from
/hackathon-kickoff) for rubric weights and the urgency hook, and a deck or
narration script (from beautiful-hackathon-slides or the pptx skill) to
cut into sections instead of drafting new copy from scratch.
Inputs to gather
- Total pitch time limit (e.g. "5 min + 2 min Q&A"); ask if unknown, don't
assume a default.
- Team roster: names, and optionally who's strongest at what (demo-driving,
storytelling, technical Q&A).
- Whatever narrative material already exists:
HACKATHON.md (angle +
urgency hook), a deck, or a narration script from beautiful-hackathon-slides.
Reuse and slice this material: do not draft a new script from nothing if
one already exists.
- The rubric weights from
HACKATHON.md, if present, to decide which
sections get more airtime (a criterion worth 40% of the score deserves
more seconds than one worth 10%).
Workflow
- Compute the word budget. ~130–150 spoken words per minute, minus a
~10% buffer for pauses, demo dead air, and applause. A 5-minute slot is
roughly 550–650 usable words, not 750.
- Split sections by rubric weight, defaulting to this shape if weights
are flat or unknown:
- Hook + problem urgency: 15%
- Solution + live demo: 45% (protect this; judges fund what they see work)
- Impact / why now: 20%
- Team + close/ask: 10%
- Buffer for stumbles / questions: 10%
- Assign speakers to contiguous blocks. One person per block minimum;
never split a single sentence across two speakers. Route the demo block
to whoever is most fluent driving the live app, not just whoever coded it.
Every speaker gets an explicit last line that cues the next person by name
or topic. No dead air at handoffs.
- Write the timed script. Output a table:
start–end | speaker | section | word budget | verbatim or bullet script | handoff line. Mark the live
demo block with a fallback instruction (screen-record backup if the live
demo fails).
- Draft Q&A prep. One likely judge question per rubric criterion, with a
one-line answer and who answers it (usually the person who owns that part
of the build). Pull candidate questions from
${CLAUDE_PLUGIN_ROOT}/references/judge-questions.md: pick the ones this
team's weakest criterion invites, not just the easy ones.
- Rehearsal checklist. Run it with a stopwatch at least twice; if any
run goes over by more than 10%, cut content; don't speed up delivery.
Confirm every handoff line lands, confirm the demo fallback plays, confirm
whoever answers Q&A actually knows that answer cold.
Output
Fill in ${CLAUDE_PLUGIN_ROOT}/templates/PITCH.md and write it as PITCH.md
in the repo root: the timing table, speaker assignments, demo fallback, Q&A
prep sheet, and rehearsal checklist, so the team can print or read it one
hour before going on stage.
A fully worked example (fictional 24h hackathon, 4 speakers, 5-minute limit):
${CLAUDE_PLUGIN_ROOT}/examples/ecoeats-24h/PITCH.md. Match its level of
specificity: verbatim opening and closing lines, bullet scripts in the
middle, every handoff named.
1---2name: pitch-timebox3description: Given a pitch time limit, a team roster, and (optionally) an existing deck or narration script, produce a per-section timing table, speaker assignments, a word-count-budgeted script, and a rehearsal checklist. Use once the deck/story exists and the team needs to decide who says what and when.4---56# Pitch Timebox78Distributes a fixed pitch time limit across sections and named teammates, so9nobody freestyles on stage and nobody fights over who talks when.1011## Prerequisites1213None required: this works from just a time limit and a roster. It gets14better with more material to slice: `HACKATHON.md` (from15`/hackathon-kickoff`) for rubric weights and the urgency hook, and a deck or16narration script (from `beautiful-hackathon-slides` or the `pptx` skill) to17cut into sections instead of drafting new copy from scratch.1819## Inputs to gather20211. Total pitch time limit (e.g. "5 min + 2 min Q&A"); ask if unknown, don't22 assume a default.232. Team roster: names, and optionally who's strongest at what (demo-driving,24 storytelling, technical Q&A).253. Whatever narrative material already exists: `HACKATHON.md` (angle +26 urgency hook), a deck, or a narration script from `beautiful-hackathon-slides`.27 Reuse and slice this material: do not draft a new script from nothing if28 one already exists.294. The rubric weights from `HACKATHON.md`, if present, to decide which30 sections get more airtime (a criterion worth 40% of the score deserves31 more seconds than one worth 10%).3233## Workflow34351. **Compute the word budget.** ~130–150 spoken words per minute, minus a36 ~10% buffer for pauses, demo dead air, and applause. A 5-minute slot is37 roughly 550–650 usable words, not 750.382. **Split sections by rubric weight**, defaulting to this shape if weights39 are flat or unknown:40 - Hook + problem urgency: 15%41 - Solution + live demo: 45% (protect this; judges fund what they see work)42 - Impact / why now: 20%43 - Team + close/ask: 10%44 - Buffer for stumbles / questions: 10%453. **Assign speakers to contiguous blocks.** One person per block minimum;46 never split a single sentence across two speakers. Route the demo block47 to whoever is most fluent driving the live app, not just whoever coded it.48 Every speaker gets an explicit last line that cues the next person by name49 or topic. No dead air at handoffs.504. **Write the timed script.** Output a table: `start–end | speaker | section51 | word budget | verbatim or bullet script | handoff line`. Mark the live52 demo block with a fallback instruction (screen-record backup if the live53 demo fails).545. **Draft Q&A prep.** One likely judge question per rubric criterion, with a55 one-line answer and who answers it (usually the person who owns that part56 of the build). Pull candidate questions from57 `${CLAUDE_PLUGIN_ROOT}/references/judge-questions.md`: pick the ones this58 team's weakest criterion invites, not just the easy ones.596. **Rehearsal checklist.** Run it with a stopwatch at least twice; if any60 run goes over by more than 10%, cut content; don't speed up delivery.61 Confirm every handoff line lands, confirm the demo fallback plays, confirm62 whoever answers Q&A actually knows that answer cold.6364## Output6566Fill in `${CLAUDE_PLUGIN_ROOT}/templates/PITCH.md` and write it as `PITCH.md`67in the repo root: the timing table, speaker assignments, demo fallback, Q&A68prep sheet, and rehearsal checklist, so the team can print or read it one69hour before going on stage.7071A fully worked example (fictional 24h hackathon, 4 speakers, 5-minute limit):72`${CLAUDE_PLUGIN_ROOT}/examples/ecoeats-24h/PITCH.md`. Match its level of73specificity: verbatim opening and closing lines, bullet scripts in the74middle, every handoff named.