terrylica

full-workflow

Full workflow - record + backup + convert + analyze. TRIGGERS - full workflow, complete recording, end-to-end.

terrylica 61 9 Updated 5mo ago

Resources

1
GitHub

Install

npx skillscat add terrylica/cc-skills/full-workflow

Install via the SkillsCat registry.

About this skill

The skill automates an end‑to‑end asciinema recording workflow, handling capture, optional backup, conversion, and analysis based on specified arguments. It eliminates manual steps for recording and post‑processing, allowing agents to generate and analyze sessions. It is appropriate when a complete, configurable recording pipeline is needed without separate manual commands.

SKILL.md

/asciinema-tools:full-workflow

Complete end-to-end workflow: record, backup, convert, and analyze.

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.

Arguments

Argument Description
-t, --title Recording title
-q, --quick Quick analysis after recording
-f, --full Full analysis after recording
-d, --domains Domains for analysis
--no-backup Skip streaming backup
--no-analyze Skip analysis (just record + convert)

Execution

Chains multiple skills: record -> backup -> convert -> analyze

Skip Logic

  • If -t provided -> use title directly
  • If -q or -f provided -> skip workflow configuration
  • If --no-backup -> skip backup step
  • If --no-analyze -> skip analysis step

Workflow

  1. Config: AskUserQuestion for workflow options
  2. Record: Invoke asciinema-recorder
  3. Backup: Invoke asciinema-streaming-backup (if enabled)
  4. Convert: Invoke asciinema-converter
  5. Analyze: Invoke asciinema-analyzer (if enabled)
  6. Report: Display summary

Example Usage

# Quick workflow with title
/asciinema-tools:full-workflow -t "Feature dev" -q

# Full analysis on trading domain
/asciinema-tools:full-workflow -f -d trading,ml

# Record only, analyze later
/asciinema-tools:full-workflow --no-analyze

Troubleshooting

Issue Cause Solution
Recording not found No active asciinema session Run /asciinema-tools:record first
Backup skipped Daemon not running Run /asciinema-tools:daemon-start
Convert fails Invalid .cast format Check asciinema version with asciinema -V
Analysis times out Large recording file Use --no-analyze and run separately
Permission denied Output dir not writable Check 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.