Agent skill

Demo Rehearsal

by MAGA2010 in MAGA2010/hackathon-run

Runs the team through a timed mock demo with a stopwatch, scores each segment for over/under-time, and emits a per-segment fix list.

MITAuto-check passed

Install Demo Rehearsal

skills CLI
$ npx skills add MAGA2010/hackathon-run --skill demo-rehearsal -a claude-code

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

GitHub CLI
$ gh skill install MAGA2010/hackathon-run demo-rehearsal --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/MAGA2010/hackathon-run.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/demo-rehearsal .claude/skills/demo-rehearsal && 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-rehearsal
GitHub stars
411
Token cost
~986 tokens
SKILL.md length
393 words
Files
2 (incl. scripts)
Skills in repo
15
Repo updated
First seen
Licence
MIT

At a glance

Runs the team through a timed mock demo with a stopwatch, scores each segment for over/under-time, and emits a per-segment fix list.

  • Works in 5 steps: Announce the run → Time each segment → Score → …
  • SKILL.md covers Input contract, Execution, Helper and Output contract, plus 3 more sections
  • Runs Python scripts from its folder

What it does

Demo Rehearsal is an agent skill from MAGA2010/hackathon-run. Runs the team through a timed mock demo with a stopwatch, scores each segment for over/under-time, and emits a per-segment fix list. Use in the final 2 hours before the live demo.

Its SKILL.md is about 990 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/rehearse.py`).

The licence is MIT.

Example prompts

  • “/demo-rehearsal”

Requirements

  • Python 3

Workflow steps

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

  1. Announce the run
  2. Time each segment
  3. Score
  4. Classify
  5. Emit fix list

What it can do on your machine

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

    Ships 1 file in scripts/ (Python), which the agent can run.

    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 Rehearsal loads about 986 tokens when it runs. Until then it costs about 49 tokens; SKILL.md has 393 words of instructions outside code blocks.

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

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); the scripts in this folder are not scanned.

SKILL.md

The full file from MAGA2010/hackathon-run at commit de3bcfb, republished under its MIT licence (© MAGA2010). 393 words, ~986 tokens.

Download SKILL.mdSave it as .claude/skills/demo-rehearsal/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
demo-rehearsal
description
Runs the team through a timed mock demo with a stopwatch, scores each segment for over/under-time, and emits a per-segment fix list. Use in the final 2 hours before the live demo.
when_to_use
Trigger when the user says "let's rehearse", "practice the demo", "timing run", or 2 hours before the live slot. Do not invoke on day 1; the demo path is not…
version
1.0
category
demoing
tags
["mock-demo", "stopwatch", "timing"]
dependencies
["demo-coach"]
side_effects
["rehearsal"]
triggers
["rehearse", "practice the demo", "timed run", "mock demo", "run through"]

demo-rehearsal

The first time the team sees the timer is on stage, the run is bad. The rehearsal exists so the second time — also on stage — is the good one. This skill structures the rehearsal into scored segments.

Input contract

Required:

  • demo_path: ordered list of steps from .hackathon/state/plan.json
  • time_remaining_minutes: minutes until the live slot (>= 30)

Optional:

  • target_total_seconds: budget for the whole demo (default 180 = 3 min)
  • per_step_seconds: per-step budget override (default: scale target by step count)
  • audience_count: integer (affects pause tolerance)
  • run_number: integer, increments each rehearsal (default 1)

Execution

1. Announce the run

Print one line: "Rehearsal #N — total budget Xs — start NOW."

2. Time each segment

For each step in demo_path:

  • Print [step N/MAX] action at t=0.
  • Caller types done when the step finishes; record actual_seconds.
  • Compute delta = actual_seconds - per_step_seconds.
3. Score

score = max(0, 10 - |delta| * 2) — symmetric penalty around the budget. Below 6 = "rushed" or "dragged"; below 3 = "rewrite this step".

4. Classify

For each step:

ScoreClassAction
8+on-timeno change
5-7drifttrim a sentence OR add a breath
<5brokenrewrite the step, not just trim
5. Emit fix list

Output one bullet per broken step with:

  • What to cut (1 sentence)
  • What to keep (1 sentence)
  • The new budget (seconds)

Helper

The skill ships scripts/rehearse.py which drives the timed rehearsal: it reads plan.json, prompts the operator between segments, scores each one against the budget, classifies it as on-time/drift/broken, and writes .hackathon/state/rehearsal.json plus .hackathon/artifacts/rehearsal-log.md. Run it with:

python3 skills/demo-rehearsal/scripts/rehearse.py \ --cwd .hackathon \ --target-total-seconds 180 \ --dry-run # use --dry-run for non-interactive smoke testing

Show full SKILL.md (137 more words)Show less

Output contract

  • .hackathon/state/rehearsal.json (matches rehearsal.schema.json)
  • .hackathon/artifacts/rehearsal-log.md — timestamped transcript

In v1.6, rehearsal.json also emits:

  • finished_at, total_seconds, and within_budget
  • verdict: all-green, mixed, or rewrite-needed
  • risks: the drift/broken steps that recovery-runbook can read directly

Acceptance criteria

  • Every step in demo_path has a recorded actual_seconds.
  • Total run time is within target_total_seconds +/- 15%.
  • At least one step scored below 8 OR an explicit note "all-green".
  • Fix list has one bullet per broken step, with cut / keep / new-budget.
  • No step runs more than 2x its per_step_seconds (refuse; suggest pivot).

Failure modes

  • time_remaining_minutes < 30 -> refuse; suggest recovery-runbook instead.
  • demo_path empty -> refuse; run scope-knife first.
  • Run #1 with score >= 9 on every step -> warn "suspicious; likely skipped steps".
  • Network failure during live-timer lookup -> fall back to caller-reported seconds.

Trigger phrases (for agent intent matching)

  • "let's rehearse"
  • "practice the demo"
  • "timing run"
  • "mock demo"
  • "stopwatch run"

© MAGA2010, 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 1 other file (scripts) in skills/demo-rehearsal of MAGA2010/hackathon-run.

  • SKILL.md
  • scripts/rehearse.py

Open the folder on GitHubat commit de3bcfb

Compare with similar skills

Demo Rehearsal 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 Rehearsal compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Demo Rehearsal this skillMAGA2010/hackathon-run411—~986Automated safety check: PassMIT
Claw Scoreopenclaw/openclaw392k—~2.5kAutomated safety check: PassMIT
Time Trackingsickn33/agentic-awesome-skills47k1 repos~3.8kAutomated safety check: PassMIT
Time Ledgersickn33/agentic-awesome-skills47k1 repos~1.8kAutomated safety check: PassMIT
Harness Scoreruvnet/ruflo74k—~605Automated safety check: NotesMIT
Timely AutomationComposioHQ/awesome-claude-skills77k3 repos~727Automated safety check: PassNone

Similar skills

  • Claw Score

    openclaw/openclaw

    Audit or refresh OpenClaw maturity scorecard docs from root taxonomy, maturity scores, and QA evidence artifacts without using maintainer discrawl data or committed inventory reports.

    392k GitHub stars~2.5k tokensUpdated today
    Auto-check passed
  • Time Tracking

    sickn33/agentic-awesome-skills

    Time entry register: employee, project, client, task, hours, billable flag, rate and amount, invoice and approver.

    47k GitHub starsUsed in 1 repo~3.8k tokens
    Productivity & AutomationAuto-check passed
  • Time Ledger

    sickn33/agentic-awesome-skills

    Natural-language time tracking: parse what the user says they did into Activity/Minutes/Date rows in their own Notion database — asking instead of guessing when unsure.

    47k GitHub starsUsed in 1 repo~1.8k tokens
    Productivity & AutomationAuto-check passed
  • Harness Score

    ruvnet/ruflo

    5-dimension harness readiness scorecard from metaharness score {path}.

    74k GitHub stars~605 tokensUpdated yesterday
    DevelopmentAuto-check: notes
  • Timely Automation

    ComposioHQ/awesome-claude-skills

    Automate Timely tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~727 tokens
    Productivity & AutomationAuto-check passed
  • Docs Demo

    remotion-dev/remotion

    Official

    Add an interactive demo to the Remotion documentation. An agent skill from remotion-dev/remotion.

    63k GitHub stars~548 tokensUpdated yesterday
    Media & CreativeAuto-check passed

More from MAGA2010/hackathon-run

All 15 skills in this repo
  • Decision Log

    MAGA2010/hackathon-run

    Writes every KEEP/CUT/DEFER/PIVOT scope decision into an append-only team log with rationale, author, and timestamp.

    411 GitHub stars~847 tokensUpdated 3 days ago
    Auto-check passed
  • Demo Coach

    MAGA2010/hackathon-run

    Drafts a 30, 60, or 90-second pitch script for the demo, structured as opening, pain, product, action, result, close.

    411 GitHub stars~895 tokensUpdated 3 days ago
    Auto-check passed
  • Judge Sim

    MAGA2010/hackathon-run

    Scores a hackathon project 0 to 5 across seven judging dimensions and produces a prioritized fix list for the last hour.

    411 GitHub stars~970 tokensUpdated 3 days ago
    Auto-check passed
  • Scope Knife

    MAGA2010/hackathon-run

    Forces a KEEP, CUT, or DEFER decision on every feature when scope is too large, no MVP consensus exists, or time is running out.

    411 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed
  • Time Box

    MAGA2010/hackathon-run

    Allocates time across the hackathon lifecycle (idea - scope - build - verify - demo - ship) and warns before each deadline slips.

    411 GitHub stars~1.3k tokensUpdated 3 days ago
    Auto-check passed
  • Fast Verify

    MAGA2010/hackathon-run

    Verifies the demo path runs end-to-end by executing each step in order, recording the actual outcome, and stopping at the first failure with a diagnostic.

    411 GitHub stars~893 tokensUpdated 3 days ago
    Auto-check passed

Questions about Demo Rehearsal

What does Demo Rehearsal do?

Runs the team through a timed mock demo with a stopwatch, scores each segment for over/under-time, and emits a per-segment fix list. Demo Rehearsal is an agent skill from MAGA2010/hackathon-run. Runs the team through a timed mock demo with a stopwatch, scores each segment for over/under-time, and emits a per-segment fix list.

How do I install Demo Rehearsal in Claude Code?

Run `npx skills add MAGA2010/hackathon-run --skill demo-rehearsal -a claude-code`. Or copy the skill folder (skills/demo-rehearsal in MAGA2010/hackathon-run) into .claude/skills/demo-rehearsal in your project. Claude Code loads it when a task matches its description.

How do I install Demo Rehearsal in Codex?

Run `npx skills add MAGA2010/hackathon-run --skill demo-rehearsal -a codex`. Or copy the skill folder (skills/demo-rehearsal in MAGA2010/hackathon-run) into .agents/skills/demo-rehearsal in your project. Codex loads it when a task matches its description.

Can I use Demo Rehearsal 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 MAGA2010/hackathon-run --skill demo-rehearsal -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-rehearsal, .gemini/skills/demo-rehearsal, .github/skills/demo-rehearsal and .opencode/skills/demo-rehearsal in your project.

What does Demo Rehearsal need to run?

Going by SKILL.md and its folder, Demo Rehearsal needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Demo Rehearsal 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 Rehearsal 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Demo Rehearsal use?

Demo Rehearsal 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 Demo Rehearsal use?

About 986 tokens (SKILL.md is roughly 3.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 Rehearsal?

Skills that share tags, products or a category with Demo Rehearsal: Claw Score (openclaw/openclaw, 392k stars), Time Tracking (sickn33/agentic-awesome-skills, 47k stars), Time Ledger (sickn33/agentic-awesome-skills, 47k stars) and Harness Score (ruvnet/ruflo, 74k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Demo Rehearsal?

MAGA2010 (a GitHub user) maintains it in MAGA2010/hackathon-run, which has 411 GitHub stars. The repository holds 15 skills in this directory. The repository was last updated on October 7, 2026.

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