gh-infra: Skill for Claude Code

VHS Tape Authoring

Use this skill to create or edit VHS tape files and their supporting setup scripts for gh-infra demos.

When To Use

• Adding a new demo for a gh-infra feature
• Editing an existing tape's scenario or timing
• Setting up mock data for a new demo
• Understanding how mock-gh works

Tape File Structure

Every .tape follows this pattern:

# 1. Output targets
Output demo-<name>.gif
Output demo-<name>.mp4

# 2. Theme and layout
Set Theme { ... }
Set Shell "bash"
Set FontSize 20
Set Width 1400
Set Height 900
Set Padding 20
Set WindowBar ""
Set TypingSpeed 50ms

# 3. Hidden setup
Hide
Type "source /data/setup-<name>.sh"
Enter
Sleep 2s
Type "clear"
Enter
Sleep 500ms
Show

# 4. Visible demo sequence
Sleep 700ms
Type "gh infra ..."
Enter
Sleep 3s
# ... more actions ...
Sleep 2s

Themes

Two themes are available. Copy from an existing tape:

Theme	Based on	Use in
gh-infra-dark	Tokyo Night	All tapes except light variant
gh-infra-light	Tokyo Night Day	demo-light.tape only

VHS Commands Reference

Command	Usage	Notes
Type "text"	Types text into terminal	Respects TypingSpeed
Enter	Press Enter
Escape	Press Escape
Tab	Press Tab
Sleep 1s	Wait	Use ms or s units
Hide / Show	Toggle recording visibility	Setup runs in Hide
Output <file>	Set output file	Always set both .gif and .mp4

Timing Guidelines

Action	Recommended Sleep
After source setup-*.sh	2s
After clear	500ms
Before first command	700ms-1s
After Type before Enter	350ms-500ms
After running gh infra plan/apply	5s-8s (depends on output size)
After confirmation (y + Enter)	5s-6s
End of demo	2s-3s

Setup Script Pattern

Each tape has a corresponding setup-<name>.sh:

#!/usr/bin/env bash
set -euo pipefail

# 1. Install gh-infra binary
cp /data/.gh-infra /usr/local/bin/gh-infra
chmod +x /usr/local/bin/gh-infra

# 2. Create gh wrapper (routes "gh infra" to real binary, rest to mock)
cat > /usr/local/bin/gh << 'WRAPPER'
#!/usr/bin/env bash
if [[ "$1" == "infra" ]]; then
  shift
  exec /usr/local/bin/gh-infra "$@"
fi
exec /data/mock-gh "$@"
WRAPPER
chmod +x /usr/local/bin/gh

# 3. Populate mock data
export MOCK_DIR=/tmp/mock-data
mkdir -p "$MOCK_DIR/<owner>/<repo>"
cat > "$MOCK_DIR/<owner>/<repo>/view.json" << 'JSON'
{ ... }
JSON

# 4. Create demo working directory and manifests
mkdir -p /tmp/demo
cat > /tmp/demo/<manifest>.yaml << 'YAML'
...
YAML

# 5. Set prompt
export PS1='$ '