record-demo

Agent Skills › slackapi/slack-cli › record-demo

record-demo

GitHub

使用 VHS 录制终端演示并生成 GIF。自动检查依赖、创建 .tape 文件、执行录制并打开结果目录，适用于 CLI 功能展示和文档制作。

.claude/skills/record-demo/SKILL.md slackapi/slack-cli

Trigger Scenarios

录制终端演示生成 CLI 使用 GIF

Install

npx skills add slackapi/slack-cli --skill record-demo -g -y

More Options

Non-standard path

npx skills add https://github.com/slackapi/slack-cli/tree/main/.claude/skills/record-demo -g -y

Use without installing

npx skills use slackapi/slack-cli@record-demo

指定 Agent (Claude Code)

npx skills add slackapi/slack-cli --skill record-demo -a claude-code -g -y

安装 repo 全部 skill

npx skills add slackapi/slack-cli --all -g -y

预览 repo 内 skill

npx skills add slackapi/slack-cli --list

SKILL.md

Frontmatter

{
    "name": "record-demo",
    "description": "Record terminal demos as GIFs using VHS tape files. Use when asked to record a demo, create a terminal recording, or generate a GIF of CLI usage.",
    "argument-hint": "<description>"
}

Record a demo of $ARGUMENTS using VHS.

Check VHS is installed: Run which vhs. If not found, tell the user to install it with brew install vhs.

Create a .tape file in demos/ (create the directory if needed). Use this template:

# Demo: <description>
Output demos/<name>.gif    # Always use .gif format

Set Shell "zsh"
Set FontSize 16
Set Width 1200
Set Height 600
Set Theme "Catppuccin Mocha"
Set TypingSpeed 75ms
Set Padding 20

Type "<command>"
Sleep 500ms
Enter
Sleep 3s

VHS Tape DSL reference: For the full command reference, see vhs-reference.md.
Tips for good demos:
- Add Sleep after commands to let output render and be readable
- Use Hide/Show to run setup commands invisibly
- Keep demos short and focused (under 30 seconds)
- Add a Sleep 3s at the end so viewers can see final output
- Always add a Sleep 500ms pause after each Type line (before Enter) to mimic a human pause
- For this project, use ./bin/slack directly as the CLI binary path (do NOT export PATH)
- When demoing from an app directory, use Hide to cd into the app, then use ../bin/slack as the binary path
- Prefer passing app IDs directly (e.g. --app A12345) to avoid interactive prompts when the ID is known
Run the recording: Execute vhs <filename>.tape to generate the output file.
Review: Open the demos/ directory with open demos/ so the user can review the output.