What happens if the command I am recording fails?

If the command returns a non-zero exit code, the skill will fail the recording process and automatically remove the output file to ensure your documentation remains accurate.

Can I record interactive terminal sessions?

No, this skill is optimized for non-interactive command execution. You specify the command to run, and the skill captures the output from start to finish automatically.

What file format does the Record skill produce?

It produces .cast files in the asciinema v3 format, which are lightweight, text-based, and compatible with web-based players and various conversion tools.

How can I convert these recordings into GIFs?

The generated .cast files can be converted into GIFs using tools like 'agg' (asciinema-agg) or into animated SVGs using 'svg-term'.

Does this skill require external dependencies?

Yes, it requires 'asciinema' and 'jq' to be installed on your system. These tools are pre-installed in the Overthink OS environment.

Asciinema Terminal Recorder

Name: Asciinema Terminal Recorder
Author: atrawog

byatrawog

0•

Learning & Documentation

Records terminal command executions into asciinema-compatible .cast files for documentation and demonstrations.

The Record skill provides a streamlined way to capture terminal output by automating the asciinema recording process. It allows users to execute specific commands while automatically handling metadata injection, title assignment, and output directory management. Designed specifically for documentation workflows, the skill ensures high-quality results by validating command success before saving, making it an essential tool for creating technical tutorials, README demos, and reproducible CLI logs.

Key Features

01Automatic JSON metadata and title injection into recording headers

020 GitHub stars

03Non-interactive terminal session recording via asciinema

04Conditional saving that discards recordings if the command fails

05Seamless integration with GIF and SVG conversion workflows

06Support for multi-command sequences using shell operators

Use Cases

01Recording step-by-step technical tutorials for CLI-based tools

02Capturing verified command outputs for bug reports or workflow sharing

03Creating animated terminal demos for software documentation and READMEs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add atrawog/overthink-plugins record

For use in Claude.ai and ChatGPT

Download Skill