К основному содержанию
скилл CX Codex

asciinema-recorder — скилл для Claude Code: запись и установка

Скилл asciinema-recorder для Claude Code готовит команды для записи сессий через asciinema. Команды используют для записи демо, документации и разбора работы в терминале.

MIT 1 установок ★ 3 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add terrylica/cc-skills --skill asciinema-recorder -a claude-code
Открыть на GitHub

Что делает asciinema-recorder

asciinema-recorder проверяет наличие asciinema, спрашивает папку и параметры записи, а затем собирает готовую команду asciinema rec. Имя файла строится из названия рабочего пространства и даты с временем. По умолчанию запись сохраняется в tmp/ проекта; также можно выбрать ~/asciinema/ или свой путь.

Через вопросы можно добавить заголовок, убрать ограничение времени простоя или включить тихий режим. После генерации скилл объясняет, как выйти из текущей сессии, запустить команду, открыть внутри неё claude и завершить запись. Без установленного asciinema CLI запись не запустится; для macOS в инструкции используется brew install asciinema, для Linux — apt или pip.

Какие задачи решает

  • записать сессию Claude Code в терминале
  • собрать имя файла из проекта и даты
  • сохранить запись в tmp/ или другой папке
  • добавить заголовок и параметры пауз
  • подготовить запись для демо или разбора

Примеры запросов агенту

  • Запиши текущую сессию Claude Code через asciinema.
  • Подготовь команду для записи в ~/asciinema/ с заголовком и без ограничения времени простоя.
  • Сделай запись этой рабочей папки в tmp/ и включи тихий режим.

Как установить asciinema-recorder

1Через Skills CLI (Vercel)

npx skills add terrylica/cc-skills --skill asciinema-recorder -a claude-code

2Вручную: положить файлы

~/.claude/skills/asciinema-recorder/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/asciinema-recorder/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об asciinema-recorder

Как установить asciinema-recorder в Claude Code?

Выполните npx skills add terrylica/cc-skills --skill asciinema-recorder -a claude-code, затем проверьте файл ~/.claude/skills/asciinema-recorder/SKILL.md.

Что делает asciinema-recorder?

Скилл проверяет asciinema, собирает параметры записи и генерирует готовую команду с путём, названием рабочего пространства и датой. Он также объясняет порядок запуска и завершения записи Claude Code.

Что нужно для работы asciinema-recorder на macOS и Linux?

Нужен установленный asciinema CLI. Для macOS инструкция использует brew install asciinema, для Linux доступны sudo apt install asciinema и pip install asciinema.

Исходный текст

SKILL.md · MIT
---
name: asciinema-recorder
description: Record Claude Code sessions with asciinema. TRIGGERS - record session, asciinema record, capture terminal, demo recording.
allowed-tools: Read, Bash, Glob, AskUserQuestion
---

# asciinema-recorder

Generate ready-to-copy commands for recording Claude Code sessions with asciinema. Dynamically creates filenames based on workspace and datetime.

> **Platform**: macOS, Linux (requires asciinema CLI)

> **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues.

## When to Use This Skill

Use this skill when:

- Starting a new terminal recording session
- Creating demos or documentation recordings
- Capturing Claude Code sessions for review or sharing
- Generating workspace-specific recording filenames

---

## Why This Skill?

This skill generates ready-to-copy recording commands with:

- Dynamic workspace-based filename
- Datetime stamp for uniqueness
- Saves to project's tmp/ folder (gitignored)

---

## Requirements

| Component         | Required | Installation             |
| ----------------- | -------- | ------------------------ |
| **asciinema CLI** | Yes      | `brew install asciinema` |

---

## Workflow Phases

### Phase 0: Preflight Check

**Purpose**: Verify asciinema is installed.

```bash
# Check asciinema CLI
which asciinema && asciinema --version
```

If asciinema is NOT installed, use AskUserQuestion:

- question: "asciinema not found. How would you like to proceed?"
  header: "Setup"
  multiSelect: false
  options:
  - label: "Install asciinema (Recommended)"
    description: "Run: brew install asciinema (macOS) or apt install asciinema (Linux)"
  - label: "Show manual instructions"
    description: "Display installation commands for all platforms"
  - label: "Cancel"
    description: "Exit without recording"

Based on selection:

- **"Install asciinema"** → Run appropriate install command based on OS:

  ```bash
  # macOS
  brew install asciinema

  # Linux (apt)
  sudo apt install asciinema

  # Linux (pip)
  pip install asciinema
  ```

  Then proceed to Phase 1.0.

- **"Show manual instructions"** → Display the commands above, then exit skill.

- **"Cancel"** → Exit skill without action.

---

### Phase 1.0: Recording Location

**Purpose**: Let user choose where to save the recording.

Use AskUserQuestion:

- question: "Where should the recording be saved?"
  header: "Location"
  multiSelect: false
  options:
  - label: "$PWD/tmp/ (Recommended)"
    description: "Project tmp directory (gitignored)"
  - label: "~/asciinema/"
    description: "Global recordings directory"
  - label: "Custom path"
    description: "Specify your own directory"

Based on selection:

- **"$PWD/tmp/"** → Set `OUTPUT_DIR="$PWD/tmp"`
- **"~/asciinema/"** → Set `OUTPUT_DIR="$HOME/asciinema"` and create if missing: `mkdir -p ~/asciinema`
- **"Custom path"** → Use user's "Other" input as `OUTPUT_DIR`

---

### Phase 1.1: Recording Options

**Purpose**: Let user configure recording behavior.

Use AskUserQuestion:

- question: "Which recording options would you like?"
  header: "Options"
  multiSelect: true
  options:
  - label: "Add title/description"
    description: "Include session title in recording metadata (-t flag)"
  - label: "Disable idle time limit"
    description: "Keep full pauses instead of 2s max (--idle-time-limit 0)"
  - label: "Quiet mode"
    description: "Suppress asciinema status messages (-q flag)"

Based on selections, build command flags:

- **"Add title"** → Continue to title selection question, add `-t "title"` flag
- **"Disable idle time limit"** → Add `--idle-time-limit 0` flag
- **"Quiet mode"** → Add `-q` flag

**If "Add title" was selected**, follow up with:

- question: "Enter a title for this recording:"
  header: "Title"
  multiSelect: false
  options:
  - label: "Use workspace name"
    description: "Title: ${WORKSPACE}"
  - label: "Use workspace + datetime"
    description: "Title: ${WORKSPACE} ${DATETIME}"
  - label: "Custom title"
    description: "Enter your own title"

Based on title selection:

- **"Use workspace name"** → Set `TITLE="${WORKSPACE}"`
- **"Use workspace + datetime"** → Set `TITLE="${WORKSPACE} ${DATETIME}"`
- **"Custom title"** → Use user's "Other" input as `TITLE`

---

### Phase 1.2: Detect Context & Generate Command

**Purpose**: Generate a copy-paste ready recording command.

#### Step 1.2.1: Detect Workspace

Extract workspace name from `$PWD`:

```bash
/usr/bin/env bash << 'SKILL_SCRIPT_EOF'
WORKSPACE=$(basename "$PWD")
echo "Workspace: $WORKSPACE"
SKILL_SCRIPT_EOF
```

#### Step 1.2.2: Generate Datetime

```bash
/usr/bin/env bash << 'SKILL_SCRIPT_EOF_2'
DATETIME=$(date +%Y-%m-%d_%H-%M)
echo "Datetime: $DATETIME"
SKILL_SCRIPT_EOF_2
```

#### Step 1.2.3: Ensure Output Directory Exists

Create the output directory selected in Phase 1.0:

```bash
mkdir -p "${OUTPUT_DIR}"
```

#### Step 1.2.4: Construct Command

Build the recording command using:

- `OUTPUT_DIR` from Phase 1.0 (location selection)
- Flags from Phase 1.1 (options selection)
- `TITLE` if "Add title" was selected

```bash
# Base command
CMD="asciinema rec"

# Add flags from Phase 1.1 options
# (Claude builds this based on user selections)

# Final command format:
asciinema rec ${FLAGS} "${OUTPUT_DIR}/${WORKSPACE}_${DATETIME}.cast"
```

**Example outputs:**

```bash
# Default (no options selected):
asciinema rec /home/user/projects/my-app/tmp/my-app_2025-12-21_14-30.cast

# With title + quiet mode:
asciinema rec -t "my-app Demo" -q /home/user/projects/my-app/tmp/my-app_2025-12-21_14-30.cast

# With all options:
asciinema rec -t "my-app 2025-12-21 14:30" -q --idle-time-limit 0 ~/asciinema/my-app_2025-12-21_14-30.cast
```

---

### Phase 2: User Guidance

**Purpose**: Explain the recording workflow step-by-step.

Present these instructions:

```markdown
## Recording Instructions

1. **Exit Claude Code** - Type `exit` or press `Ctrl+D`
2. **Copy the command** shown above
3. **Paste and run** in your terminal (starts a recorded shell)
4. **Run `claude`** to start Claude Code inside the recording
5. Work normally - everything is captured
6. **Exit Claude Code** - Type `exit` or press `Ctrl+D`
7. **Exit the recording shell** - Type `exit` or press `Ctrl+D` again

Your recording will be saved to:
`$PWD/tmp/{workspace}_{datetime}.cast`
```

---

### Phase 3: Additional Info

**Purpose**: Provide helpful tips for after recording.

```markdown
## Tips

- **Environment variable**: `ASCIINEMA_REC=1` is set during recording
- **Playback**: Use `asciinema-player` skill or `asciinema play file.cast`
- **Upload (optional)**: `asciinema upload file.cast` (requires account)
- **Markers**: Add `asciinema marker` during recording for navigation points
```

---

## TodoWrite Task Templates

### Template: Record Claude Code Session

```
1. [Preflight] Check asciinema CLI installed
2. [Preflight] Offer installation if missing
3. [Context] Detect current workspace from $PWD
4. [Context] Generate datetime slug
5. [Context] Ensure tmp/ directory exists
6. [Command] Construct full recording command
7. [Guidance] Display step-by-step instructions
8. [Guidance] Show additional tips (playback, upload)
9. Verify against Skill Quality Checklist
```

---

## Post-Change Checklist

After modifying this skill:

1. [ ] Command generation still uses `$PWD` (no hardcoded paths)
2. [ ] Guidance steps remain clear and platform-agnostic
3. [ ] TodoWrite template matches actual workflow
4. [ ] README.md entry remains accurate
5. [ ] Validate with quick_validate.py

---

## CLI Options Reference

| Option | Flag | Description                         |
| ------ | ---- | ----------------------------------- |
| Title  | `-t` | Recording title (for asciinema.org) |
| Quiet  | `-q` | Suppress status messages            |
| Append | `-a` | Append to existing recording        |

---

## Troubleshooting

### "Cannot record from within Claude Code"

**Cause**: asciinema must wrap the program, not be started from inside.

**Fix**: Exit Claude Code first, then run the generated command.

### "Recording file too large"

**Cause**: Long sessions produce large files.

**Fix**:

- Use `asciinema upload` to store online instead of locally
- Split long sessions into smaller recordings

### "Playback shows garbled output"

**Cause**: Terminal size mismatch.

**Fix**: Use `-r` flag during playback to resize terminal.

---

## Reference Documentation

- [asciinema CLI Documentation](https://docs.asciinema.org/manual/cli/)
- [asciinema Markers](https://docs.asciinema.org/manual/cli/markers/)


## Post-Execution Reflection

After this skill completes, reflect before closing the task:

0. **Locate yourself.** — Find this SKILL.md's canonical path before editing.
1. **What failed?** — Fix the instruction that caused it.
2. **What worked better than expected?** — Promote to recommended practice.
3. **What drifted?** — Fix any script, reference, or dependency that no longer matches reality.
4. **Log it.** — Evolution-log entry with trigger, fix, and evidence.

Do NOT defer. The next invocation inherits whatever you leave behind.

© terrylica · MIT · terrylica/cc-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
pr-demo mikeyobrien Скилл pr-demo записывает терминал через asciinema и превращает запись в GIF или SVG, который можно вставить в описание PR. CX Codex +1 ★ 3 206звёзд репо brain — the recorder mordechaipotash brain — the recorder — MCP-сервер для Claude Code записывает сессии Claude, Codex и Pi до очистки и позволяет искать их по проверяемым ссылкам на файл, строки и sha256. CX Codex +1 ★ 82звёзд репо demo-recorder sammcj Скилл demo-recorder записывает скриптовые видеодемо веб-приложений через headless Chromium в 3K 60fps и накладывает озвучку через Cloney. CX Codex +1 ★ 173звёзд репо mcp-cli официальный github Скилл mcp-cli учит агента ходить к MCP-серверам из терминала: список серверов, схемы инструментов, вызов с JSON-аргументами. CX Codex +1 9 650установок crypto-report aahl Скилл crypto-report для Claude Code запускает скрипты с Binance AI-отчётами и новостями блокчейна. Попросите получить отчёт по BTC или обновить новостную ленту. CX Codex +1 3 500установок Audition SFKislev Скилл Audition для Claude Code управляет Adobe Audition через локальный мост Flue. Он включается, когда нужно проверить открытую сессию или внести ограниченные правки. CX Codex +1 1 700установок

Из того же набора79

Весь набор →
bot-process-control Скилл bot-process-control регламентирует мониторинг процессов Gmail Commander и защищает от запуска конфликтующих локальных поллеров Telegram на рабочей станции. CX Codex +1 117установок interactive-bot Скилл interactive-bot объясняет устройство Telegram-бота Gmail Commander: слэш-команды для почты, ИИ-роутинг свободного текста через MCP, сессии compose/reply. CX Codex +1 114установок symmetric-dogfooding Скилл symmetric-dogfooding организует двустороннее интеграционное тестирование между двумя репозиториями перед релизом без использования моков. CX Codex +1 112установок calcom-access Скилл calcom-access для Claude Code и пяти других платформ даёт агенту доступ к Cal.com API для работы с бронированиями, типами событий, расписаниями и доступностью слотов. Ключ API берётся из 1Password через CALCOM_OP_UUID. CX Codex +1 107установок claude-code-proxy-patterns Скилл claude-code-proxy-patterns описывает схемы прокси для маршрутизации моделей Claude Code к разным провайдерам. Пригодится при настройке OAuth и разборе ошибок авторизации. CX Codex +1 106установок summarize Скилл summarize разбирает многогигабайтные текстовые файлы и записи сессий пошагово, не загружая их целиком в контекст. Помогает понять, что произошло в длинной сессии разработки, когда файл слишком большой для обычного чтения. CX Codex +1 103установок booking-config Скилл booking-config для Claude Code настраивает типы встреч, расписания доступности и вебхуки Cal.com через интерфейс агента. Редактирует страницы бронирования без веб-панели. CX Codex +1 103установок health Скилл health для Claude Code проверяет состояние Cal.com Commander. Запускает диагностику CLI, настроек, процессов бота и синхронизации, заданий launchd, circuit breaker и журналов аудита. CX Codex +1 100установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой