Skip to content

docs: show the demo at the top of the README - #36

Merged
akf66 merged 1 commit into
mainfrom
akf66/readme-demo
Aug 26, 2026
Merged

docs: show the demo at the top of the README#36
akf66 merged 1 commit into
mainfrom
akf66/readme-demo

Conversation

@akf66

@akf66 akf66 commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

97s of recording at , so it reads in half a minute: npx installs the skill, then an agent is asked to set the repo up — once in Action mode, once in App mode, ending on the GitHub App page.

It opens on the language picker, which is where the four-language support shows itself:

Language / 语言 / 言語 / 언어
  ❯ English
    简体中文
    日本語
    한국어

GIF for the embed, MP4 alongside

GitHub renders video uploaded through the web UI, but not an MP4 referenced from a repo path in markdown — it renders as a dead link. So the inline embed is an <img> to a GIF, which is the only version that actually plays for a reader landing on the repo. The MP4 is committed too and linked underneath for full speed and full fidelity.

Sizing

Size Verdict
900px / 12fps 2.7 MB ✅ text legible — checked a frame, not assumed
800px / 12fps 2.2 MB smaller lines start to soften
720px / 10fps 1.8 MB too soft, and text is the entire content here

Plus docs/demo.mp4 at 896 KB.

docs/ stays out of the npm tarball — files is bin/, skills/, NOTICE — so this adds nothing to install size. Verified against npm pack --dry-run.

The caption says 3×

A sped-up demo that doesn't admit it sets a first impression the product can't meet. One line of <sub> costs nothing.

411 tests still passing; no code touched.

97s of recording at 3×, so it reads in half a minute: npx installs the
skill, then an agent is asked to set the repo up — once in Action mode,
once in App mode, ending on the GitHub App page.

GIF, not MP4, for the inline embed. GitHub renders video uploaded through
the web UI but not an MP4 referenced from a repo path in markdown, so an
`<img>` to a GIF is the only version that actually plays for a reader. The
MP4 is committed too and linked underneath for anyone who wants full speed
and full fidelity.

900px at 12fps, 128 colours: 2.7 MB, and the terminal text stays legible at
that width — checked, not assumed. 720px got it to 1.8 MB but softened the
smaller lines, which is the whole content here.

The caption says it is 3×. A sped-up demo that does not admit it sets a
first impression the product cannot meet.

docs/ stays out of the npm tarball — `files` is bin/, skills/, NOTICE — so
this adds nothing to install size.
@akf66
akf66 merged commit 2323afb into main Aug 26, 2026
2 checks passed
@akf66
akf66 deleted the akf66/readme-demo branch August 26, 2026 09:00
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.

1 participant