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

asciinema-converter — скилл для Claude Code: .cast в .txt

Скилл asciinema-converter преобразует записи asciinema .cast в чистые .txt для чтения и поиска. Подходит для одиночных и пакетных конвертаций.

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

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

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

Скилл находит запись .cast, уточняет параметры и место сохранения, затем запускает asciinema convert -f txt. Для результата можно добавить индекс временных меток [HH:MM:SS]. Выходной файл очищается от ANSI-кодов и JSON-структуры, поэтому его удобно читать через инструменты Read и Grep.

Пакетный режим включается флагом --batch: скилл обрабатывает все .cast в каталоге и организует выходные файлы. Для выбора источника и каталога назначения используются --source и --output-dir, а уже существующие .txt можно переобработать через --skip-existing=false.

Без установленного asciinema версии 2.4 или новее команда convert не сработает. В скилле также есть проверки формата входного файла, прав на запись и различий команды stat между macOS и Linux.

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

  • преобразовать запись .cast в .txt
  • очистить терминальный вывод от ANSI-кодов
  • подготовить запись для поиска через Read и Grep
  • пакетно обработать .cast в каталоге

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

  • Преобразуй recording.cast в recording.txt и проверь доступность команды asciinema convert.
  • Пакетно обработай все .cast из каталога через --batch, сохрани результат в каталог, который я укажу.
  • Преобразуй запись .cast и добавь индекс временных меток [HH:MM:SS].

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

1Через Skills CLI (Vercel)

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

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

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

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

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

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

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

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

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

Скилл переводит записи asciinema .cast в очищенные .txt, убирает ANSI-коды и JSON-структуру, а затем подготавливает текст для чтения и поиска.

Что нужно для работы asciinema-converter?

Нужен CLI asciinema версии 2.4 или новее. Скилл рассчитан на macOS и Linux.

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

SKILL.md · MIT
---
name: asciinema-converter
description: Convert .cast recordings to .txt for analysis. TRIGGERS - convert cast, cast to txt, strip ANSI, batch convert.
allowed-tools: Read, Bash, Glob, Write, AskUserQuestion
---

# asciinema-converter

Convert asciinema .cast recordings to clean .txt files for Claude Code analysis. Achieves 950:1 compression (3.8GB -> 4MB) by stripping ANSI codes and JSON structure.

> **Platform**: macOS, Linux (requires asciinema CLI v2.4+)

> **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:

- Converting .cast recordings to searchable .txt format
- Preparing recordings for Claude Code Read/Grep tools
- Batch converting multiple recordings
- Reducing storage size of session archives
- Extracting clean text from ANSI-coded terminal output

---

## Why Convert?

| Format | Size (22h session) | Claude Code Compatible | Searchable |
| ------ | ------------------ | ---------------------- | ---------- |
| .cast  | 3.8GB              | No (NDJSON + ANSI)     | Via jq     |
| .txt   | ~4MB               | Yes (clean text)       | Grep/Read  |

**Key benefit**: Claude Code's Read and Grep tools work directly on .txt output.

---

## Requirements

| Component     | Required | Installation             | Notes                 |
| ------------- | -------- | ------------------------ | --------------------- |
| **asciinema** | Yes      | `brew install asciinema` | v2.4+ for convert cmd |

---

## Workflow Overview

**IMPORTANT**: All phases are MANDATORY. Do NOT skip any phase. AskUserQuestion MUST be used at each decision point.

### Single File Mode (Phases 0-6)

| Phase | Purpose                    | Key Action                        |
| ----- | -------------------------- | --------------------------------- |
| 0     | Preflight check            | Verify asciinema CLI v2.4+        |
| 1     | File discovery & selection | AskUserQuestion: file to convert  |
| 2     | Output options             | AskUserQuestion: conversion opts  |
| 3     | Output location            | AskUserQuestion: save destination |
| 4     | Execute conversion         | `asciinema convert -f txt`        |
| 5     | Timestamp index            | Optional `[HH:MM:SS]` index       |
| 6     | Next steps                 | AskUserQuestion: what's next      |

Full implementation details: [Workflow Phases](./references/workflow-phases.md)

### Batch Mode (Phases 7-10)

Activated via `--batch` flag. Converts all .cast files in a directory with organized output.

| Phase | Purpose             | Key Action                               |
| ----- | ------------------- | ---------------------------------------- |
| 7     | Source selection    | AskUserQuestion (skip if `--source`)     |
| 8     | Output organization | AskUserQuestion (skip if `--output-dir`) |
| 9     | Execute batch       | Convert all with progress reporting      |
| 10    | Batch next steps    | AskUserQuestion: what's next             |

Full implementation details: [Batch Workflow](./references/batch-workflow.md)

---

## iTerm2 Filename Format

iTerm2 auto-logged files follow this format:

```
{creationTimeString}.{profileName}.{termid}.{iterm2.pid}.{autoLogId}.cast
```

**Example**: `20260118_232025.Claude Code.w0t1p1.70C05103-2F29-4B42-8067-BE475DB6126A.68721.4013739999.cast`

| Component          | Description                    | Example                              |
| ------------------ | ------------------------------ | ------------------------------------ |
| creationTimeString | YYYYMMDD_HHMMSS                | 20260118_232025                      |
| profileName        | iTerm2 profile (may have dots) | Claude Code                          |
| termid             | Window/tab/pane identifier     | w0t1p1                               |
| iterm2.pid         | iTerm2 process UUID            | 70C05103-2F29-4B42-8067-BE475DB6126A |
| autoLogId          | Session auto-log identifier    | 68721.4013739999                     |

---

## CLI Quick Reference

```bash
# Basic conversion
asciinema convert -f txt recording.cast recording.txt

# Check asciinema version
asciinema --version

# Verify convert command exists
asciinema convert --help
```

---

## Reference Documentation

### Internal References

- [Workflow Phases](./references/workflow-phases.md) - Single file mode phases 0-6 with full scripts
- [Batch Workflow](./references/batch-workflow.md) - Batch mode phases 7-10 with full scripts
- [Task Templates](./references/task-templates.md) - TodoWrite templates for single and batch modes
- [Post-Change Checklist](./references/post-change-checklist.md) - Verification after modifications
- [Anti-Patterns](./references/anti-patterns.md) - Common mistakes to avoid
- [Batch Processing](./references/batch-processing.md) - Patterns for bulk conversion
- [Integration Guide](./references/integration-guide.md) - Chaining with analyze/summarize

### External References

- [asciinema convert command](https://docs.asciinema.org/manual/cli/)
- [asciinema-cast-format skill](../asciinema-cast-format/SKILL.md)

---

## Troubleshooting

| Issue                       | Cause                     | Solution                                       |
| --------------------------- | ------------------------- | ---------------------------------------------- |
| convert command not found   | asciinema too old         | Upgrade: `brew upgrade asciinema` (need v2.4+) |
| asciinema not installed     | Missing CLI               | `brew install asciinema`                       |
| Empty output file           | Corrupted .cast input     | Verify .cast file has valid NDJSON structure   |
| Conversion failed           | Invalid cast format       | Check header line is valid JSON with `jq`      |
| numfmt not found            | macOS missing coreutils   | Use raw byte count or `brew install coreutils` |
| stat syntax error           | Linux vs macOS difference | Script handles both; check stat version        |
| Batch skipping all files    | All .txt already exist    | Use `--skip-existing=false` to reconvert       |
| Permission denied on output | Directory not writable    | Check output directory permissions             |


## Post-Execution Reflection

After this skill completes, check before closing:

1. **Did the command succeed?** — If not, fix the instruction or error table that caused the failure.
2. **Did parameters or output change?** — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
3. **Was a workaround needed?** — If you had to improvise (different flags, extra steps), update this SKILL.md so the next invocation doesn't need the same workaround.

Only update if the issue is real and reproducible — not speculative.

© terrylica · MIT · terrylica/cc-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
pr-demo mikeyobrien Скилл pr-demo записывает терминал через asciinema и превращает запись в GIF или SVG, который можно вставить в описание PR. CX Codex +1 ★ 3 206звёзд репо cli-demo-generator daymade Скилл cli-demo-generator для Claude Code записывает команды в терминале и создаёт анимированный GIF. Демонстрирует CLI-инструмент в README и документации. CX Codex +1 1 000установок spotify-player openclaw Даёт агенту доступ к Spotify через spogo или spotify_player. Управляет воспроизведением, ищет треки и переключает устройства прямо из терминала. CX Codex +1 5 400установок cmux-cli manaflow-ai Скилл cmux-cli для Claude Code подсказывает агенту синтаксис команд cmux и правила безопасной автоматизации окон, панелей и браузерных поверхностей. CX Codex +1 908установок twitter-cli jackwener Скилл twitter-cli для Claude Code, который отдаёт агенту полный набор операций Twitter/X: от ленты и поиска до постов, реплаев и цитирования. Работает и в Codex, Cursor, Copilot, Gemini CLI, OpenCode — везде через один бинарник twitter. CX Codex +1 598установок vhs pproenca Скилл с 47 правилами для .tape-файлов VHS: помогает агенту писать и проверять сценарии записи терминала в GIF и видео. CX Codex +1 337установок

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

Весь набор →
iterm2-layout Скилл iterm2-layout настраивает рабочие вкладки и панели iTerm2 через TOML-конфиг. Помогает агенту прописать пути проектов и включить автопоиск git worktree. CX Codex +1 126установок asciinema-player Скилл asciinema-player для Claude Code и пяти других платформ воспроизводит .cast записи терминала в iTerm2 через отдельное чистое окно. Файлы больше 100 МБ браузерный плеер не тянет — этот скилл открывает их потоком с диска. CX Codex +1 126установок impl-standards Скилл impl-standards для Claude Code задаёт правила обработки ошибок, работы с константами, логирования прогресса и DI. Запускается при упоминании этих тем. CX Codex +1 126установок bootstrap-monorepo Скилл bootstrap-monorepo для развёртывания полиглот-монорепозитория на стеке moon, proto и Bun с типизированным слоем управления на TypeScript. CX Codex +1 126установок multi-agent-performance-profiling Скилл multi-agent-performance-profiling для параллельного профилирования многоуровневых систем. CX Codex +1 126установок clickhouse-cloud-management Скилл clickhouse-cloud-management помогает управлять пользователями и правами доступа в ClickHouse Cloud через SQL-запросы по HTTPS. CX Codex +1 126установок booking-notify Скилл booking-notify отправляет уведомления о новых бронированиях, отменах и переносах через Telegram и Pushover. Синхронизация каждые 6 часов, вебхук для срочных событий. CX Codex +1 125установок implement-plan-preflight Скилл implement-plan-preflight запускает подготовительный этап ITP: создаёт ADR в формате MADR 4.0, спецификацию архитектуры и связывает их перекрёстными ссылками. CX Codex +1 125установок

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

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