Skip to content

Three demo videos, surfaced on the org chart page - #34

Merged
cbrock84 merged 1 commit into
mainfrom
claude/demo-videos
Sep 2, 2026
Merged

Three demo videos, surfaced on the org chart page#34
cbrock84 merged 1 commit into
mainfrom
claude/demo-videos

Conversation

@cbrock84

@cbrock84 cbrock84 commented Sep 2, 2026

Copy link
Copy Markdown
Owner

Short clips showing what installing and using this actually looks like, for sharing where a README doesn't travel.

Why terminal-style

They're rendered as a terminal rather than as a reconstruction of the Claude Code web UI. Claude Code is a terminal application, so this represents reality without guessing at product chrome — which is exactly where a mockup gets caught being wrong by people who use the thing daily. Each carries a small "illustrative demo" mark so nobody mistakes them for a capture of a real session.

The three

Clip Length What it shows
headcount-install.mp4 22s Marketplace add, then three departments
headcount-usage.mp4 26s The leaver who still had shared mailbox access
headcount-marketing.mp4 26s Updating an old blog post

Every figure is real, pulled from the tree: 16 departments, 172 skills, 12/8/12 skills for it-operations, security and people. security is flagged reviewer-class at install, which is where that idea lands fastest.

The content is quoted from the skills themselves rather than invented — "an unmonitored identity with a password" from collaboration-platform-administration, "changing it costs equity even when done correctly" from seo-strategy, "kill on sight" from marketing-copywriting.

The marketing one earns its place by being the least obvious: it looks like a content task and is really an SEO one, and it ends with the claim-substantiation hand-off to legal-risk:regulatory-compliance — a boundary most people don't know exists until they've crossed it.

Four things fixed between takes rather than shipped

Typing was too fast and the punchlines didn't hold. Both slowed.

The window sat mostly empty for the first stretch. Rather than relocate the dead space, the window now sizes to its content and grows as output arrives, so there's never a large empty frame. This was the fix for the 12 seconds of whitespace.

The trailing blank after the last block pushed the first skill off screen — which matters because the final frame is the thumbnail. Dropped it, and raised the body cap to account for chip margins my first estimate missed. Verified by reading the actual final frames, not by assuming.

The webfont was fetched over the network, failed through the proxy, and blocked the page. Local families now, so a recording never waits on a font.

On the page

A "Watch it work" strip above the links, with poster images and preload="none" so nothing downloads until a visitor presses play. Verified the rendered DOM carries all three <video> elements and that every referenced file exists on disk.

One consequence worth knowing: the README hero screenshots grew from ~329KB to ~609KB each, because the page is now taller and includes the video posters. Still well within limits, but it is a real size increase to the README's images.

Total added: 2.0MB of video and posters.

Verification

scripts/check-all.sh — all nine checks pass.


🤖 Generated with Claude Code

https://claude.ai/code/session_01FaQP2WCqeFYH7s9pi1CJ5u


Generated by Claude Code

Short screen-style clips showing what installing and using this looks like,
for sharing where a README does not travel.

They are terminal-style rather than a reconstruction of the Claude Code web
UI. Claude Code is a terminal application, so this represents reality
without guessing at product chrome — which is exactly where a mockup gets
caught being wrong. Each carries a small "illustrative demo" mark so nobody
mistakes them for a capture of a real session.

- headcount-install.mp4 (22s) — marketplace add, then three departments.
  Every figure comes from the tree: 16 departments, 172 skills, and 12/8/12
  skills for it-operations, security and people. Security is flagged
  reviewer-class at install, which is where that idea lands fastest.
- headcount-usage.mp4 (26s) — the leaver who still had shared mailbox
  access. Five skills load in the order USE-CASES specifies, then contain,
  sweep, the question you did not ask, and the reviewer-class stop.
- headcount-marketing.mp4 (26s) — updating an old blog post, which looks
  like a content task and is really an SEO one. Lines are drawn from the
  skills themselves: "changing it costs equity even done correctly" from
  seo-strategy, "kill on sight" from marketing-copywriting.

Three things fixed between takes rather than shipped:

Typing was too fast and the punchlines did not hold, so both were slowed.

The response window sat mostly empty for the first stretch of each clip.
Rather than relocate the dead space, the window now sizes to its content
and grows as output arrives, so there is never a large empty frame.

The trailing blank line after the final block pushed the first skill off
screen, which mattered because the last frame is the thumbnail. Dropped it,
and raised the body cap to account for the chip margins the first estimate
missed.

The webfont was also removed: it was fetched over the network, failed
through the proxy, and blocked the page. Local families now, so a recording
never waits on a font.

The page gains a Watch strip above the links, with posters and preload=none
so nothing downloads until a visitor presses play.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01FaQP2WCqeFYH7s9pi1CJ5u
@cbrock84
cbrock84 marked this pull request as ready for review September 2, 2026 20:43
@cbrock84
cbrock84 merged commit dc6a49b into main Sep 2, 2026
1 check passed
@cbrock84
cbrock84 deleted the claude/demo-videos branch September 2, 2026 20:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants