[Anchor-Shi]

Why

The README read like developer docs. #42 and #43 improved the opening text, install commands and capability keywords, but a visitor still saw no pictures of what ChatCut actually produces. Popular agent repositories lead with clear visuals: HyperFrames shows a sharp thumbnail grid where each card links to a live template page. This version opens with ChatCut Skills from chatcut.io/skills, each with a request to paste into your agent, then lets each visitor find the install line for their own agent.

A first draft used six demo GIFs made from website marketing clips. Compressed to about 2 MB each, they looked blurry, and they weren't Skills. They're replaced by the Skill cards below.

What changed

## What you can make: nine Skill cards. Each card is a sharp still with the Skill's name and one line, linking to its page on chatcut.io/skills. A two-column table below gives each Skill a short request to paste into your agent, worded like the plugin pages' use cases. The cards are fixed-width images that wrap: three per row on a computer (both the README view and the repository home page), one per row on a phone.

Anchor picked the lineup. It's three rows: editing, AI generation, then packaging and translation. Names, covers and previews follow the latest admin data (agent_skill, read from production on 2026-11-10), and every still is regenerated from the admin thumbnail or preview video.

Card (admin name)	Link	Request	Still taken from
Speech Cleanup	/skills/speech-cleanup	Clean up my talking-head take	its 1080p preview, 0.6s
Add captions	/skills/add-captions	Add animated captions to my video	its caption-style preview (admin 2026-11-04), 6.5s
Talking-Head Edit Recreation	/skills/recreate-a-video	Recreate this edit with my talking-head footage	its preview, 0.5s
AI Avatar Video	/skills/ai-avatar-video	Turn my photo into a talking presenter video	its preview (…-13-01.mp4), 3.2s
Voice Cloning	/skills/voice-cloning	Clone my voice and read this script	its preview (…-13-06.mp4), 6.8s: "Same voice. New words." with original and cloned waveforms
Viral Video Cloner	/viralvideocloner	Recreate this viral video with my product	its "hero crowd" preview (admin 2026-11-01), 8.35s, mid-wipe so the same pose shows in two looks
Runway Rebel	/skills/mg-packaging-runway-rebel	Package my talking-head video in the Runway Rebel style	its preview, 0.9s: "STOP POSTING 365"
Editorial Explainer	/skills/mg-packaging-editorial-explainer	Package my explainer with news-style motion graphics	its preview, 9.6s
Video Translation	/skills/video-translation	Translate my video into Spanish	its 1080p preview, 12.8s

• Every link points to chatcut.io and carries the README UTM tags.
• Viral Video Cloner links straight to /viralvideocloner, because /skills/viral-video-cloner redirects there with a 302 that drops the query string.
• /skills/ai-avatar-video and /skills/voice-cloning don't have their own pages yet. They redirect (301) to the /skills list and keep the UTM tags, so they'll work without changes once the site adds those pages.
• Removed from the earlier lineup: SaaS Kinetic Type Launch, Claymotion, Sugar Crystal Storm and Long video to shorts, along with their images and request rows.
• None of the new media shows third-party links, logos or brand marks. I checked the cap, headphones and microphones at full resolution.

Media. The nine cards are committed in docs/media/skills/: 800×618 JPGs, about 749 KB in total.

• GitHub's image proxy loads the catalog's CloudFront and S3 covers fine.
• Most of those covers are only 640×360 and a few KB, though, so the cards are made from the preview videos instead.
• The six earlier GIFs are deleted. They're still in this branch's first commit, so please use "Squash and merge" to keep those 12 MB out of main's history.

Hero video (not in this PR yet). A 20.7-second, 800×450, silent demo cut from the latest admin previews of six of these Skills (Speech Cleanup, Add captions, Viral Video Cloner, Editorial Explainer, Video Translation, Talking-Head Edit Recreation) is ready to upload as a GitHub attachment. Uploading needs a GitHub account in the browser; once it has a user-attachments URL, it goes between the opening links and the cards.

Install table (## Install), unchanged from the first draft. One row per host, 11 in all: Codex, ChatGPT, Claude Code, Cursor, Grok Bot, Gemini CLI, Google Antigravity, Kimi Work, WorkBuddy, Doubao Work and Qwen Work. Each row has one prompt or command and links to its chatcut.io guide where one exists. Otherwise it links to the package README. Hosts on the hosted Web plugin are marked (Web).

• Everything from the old Quick install is kept under the table: the installers, the Antigravity Desktop package, the hosted Web plugin commands and the endpoint for other MCP clients.

Layout. The top of the README is centered to line up with the cards: the title, opening sentence, links and badge, the "What you can make" heading and its lead line, and the request table with the line under it. This uses <h1 align="center">, <h2 align="center"> and <div align="center">. Inside the table, cells stay left-aligned so the requests are easy to read. From Install down, the README stays left-aligned as reference docs. The centered headings keep their anchors: clicking the #what-you-can-make link scrolls to the heading.

Header, all centered. The title is now ChatCut AI Video Editor; the README used "ChatCut Agent Plugins" nowhere else. From top to bottom:

• Product Hunt award. The "Add Claude Code plugin manifests for claude plugin install #1 Product of the Day" badge, using the same self-hosted light and dark SVGs as the website footer (chatcut.io/producthunt/badge-{light,dark}.svg, served through GitHub's image proxy). It's wrapped in <picture> so it switches with the theme, and links to the same Product Hunt URL as the footer. Product Hunt shows Cloudflare's bot check to automated clients, so I couldn't open that page here.
• One row of live badges.
  • shields.io style=flat: stars, latest release (v1.11.1) and license (Apache-2.0).
  • Discord members (24,113) for the official server linked in the website footer. Shields' standard Discord badge reads "widget disabled" for this server, so this one is a dynamic badge that reads approximate_member_count from Discord's public invite endpoint.
  • The existing Glama score.
  • skills.sh has no badge. Its 2.7K figure adds up installs across 30 Skills, so I left it out.
• The intro sentence.
• A fuller links row. Website · Skills · Docs · Setup guide · Pricing · Discord · X. All return 200.
• Works with. One small pill per host, each with its app icon and linking to its guide:
  • Codex, ChatGPT, Claude Code, Grok Bot, Google Antigravity and WorkBuddy link to their chatcut.io plugin pages. Their icons are the ones chatcut.io uses. The Grok Bot app icon comes from chatcut-landing#830, which isn't merged yet.
  • Cursor, Gemini CLI, Kimi Work, Doubao Work and Qwen Work link to their package README or install section, on a second row. The chatcut.io Plugin menu doesn't list these hosts. Kimi's icon is the one chatcut.io already uses; the other four come from each product's own site: Cursor's app icon, Gemini's sparkle, Doubao's app icon and Qwen's app icon.
  • Icons that have their own background (Cursor, Kimi, Grok) fill a rounded tile. Transparent marks sit on a white tile with a light border.
  • Each pill is a single image, so a name never splits from its icon when the row wraps on a phone, and the white pills read on both light and dark backgrounds. The 11 pills total 88 KB in docs/media/hosts/.
• The old "ChatGPT and Codex" and "Claude Code" links are now covered by the Works with row.

Link tracking. Every clickable chatcut.io link carries utm_source=github&utm_medium=readme&utm_campaign=agent-plugin: the Skill cards and table, the install table guides, the header links, the Works with pills and the guides further down. That's 43 links across 22 distinct URLs, and all of those URLs return 200 with the parameters. Some things stay untagged on purpose:

• The Product Hunt link keeps the website's own parameters.
• Install prompts (Read ChatCut.io/desktop …), code blocks and image URLs. Agents read the prompt URLs, and some agent web tools can't open URLs with query strings. The capability list is renamed Everything ChatCut can make, so the card grid can use "What you can make", and the "Under the hood…" sentence moves into it. Every other section is unchanged.

Verification

• Branch README on GitHub (blob/claude/readme-demos-20261110/README.md and the branch's repository home page):
  • At 1440 px and 1280 px, the cards sit three per row and the install table fits without scrolling.
  • At phone width (375 px emulation), the cards stack one per row, centered, and the page doesn't scroll sideways. The install table scrolls inside its own box, GitHub's usual treatment of wide tables.
• Every card image is served with 200 image/jpeg, and all nine chatcut.io/skills pages and the host guide links return 200.
• node --test tests/*.test.mjs: 118/118 pass. git diff --check is clean.

🤖 Generated with Claude Code