terrylica/cc-skills/finalize
Claude Code and agent skill by terrylica/cc-skills
- community
Checking that the SKILL.md file is still in the repository.
Finalize orphaned recordings - stop processes, compress, push to orphan branch. TRIGGERS - finalize recording, stop asciinema, orphaned recording
Install
npx vskill@latest install terrylica/cc-skills/finalizeSKILL.md
/asciinema-tools:finalize
Finalize orphaned asciinema recordings: stop running processes gracefully, compress, and push to the orphan branch.
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 | |
|---|---|---|
file | Specific .cast file to finalize | |
--all | Finalize all unhandled .cast files | |
--force | Use SIGKILL if graceful stop fails | |
--no-push | Skip pushing to orphan branch (local only) | |
--keep-local | Keep local .cast after compression |
Workflow
- Discovery: Find running asciinema processes and unhandled .cast files
- Selection: AskUserQuestion for which files to process
- Stop: Gracefully stop running processes (SIGTERM → SIGINT → SIGKILL)
- Verify: Check file integrity after stop
- Compress: zstd compress .cast files
- Push: Push to orphan branch (if configured)
- Cleanup: Remove local .cast (optional)
Execution
Phase 1: Discovery
Phase 2: Selection
Phase 3: Stop Running Processes
Pass the PID list to this block, plus --force when the user invoked /asciinema-tools:finalize with --force. The block parses --force out of its own arguments — separate bash heredocs are separate processes, so $FORCE must be resolved in the same block that acts on it (a standalone parse phase would not survive across blocks).
Phase 4: File Integrity Check
Phase 5: Compress
Phase 6: Push to Orphan Branch
Phase 7: Cleanup Confirmation
Example Usage
Troubleshooting
| Issue | Cause | Solution | |
|---|---|---|---|
| Process won't stop | Hung asciinema process | Use --force flag for SIGKILL | |
| File may be truncated | Forced stop interrupted file | Most data preserved, try playing it | |
| zstd not found | zstd not installed | brew install zstd | |
| Push failed | No GitHub token | Set GH_TOKEN or run gh auth login | |
| No orphan branch | Clone not configured | Run /asciinema-tools:bootstrap first | |
| File not found | Wrong path or already moved | Check with /daemon-status |
Related Commands
/asciinema-tools:daemon-status- View status and find unhandled files/asciinema-tools:convert- Convert .cast to .txt for analysis/asciinema-tools:summarize- AI-powered analysis of recordings
Post-Execution Reflection
After this skill completes, reflect before closing the task:
- Locate yourself. — Find this SKILL.md's canonical path before editing.
- What failed? — Fix the instruction that caused it.
- What worked better than expected? — Promote to recommended practice.
- What drifted? — Fix any script, reference, or dependency that no longer matches reality.
- Log it. — Evolution-log entry with trigger, fix, and evidence.
Do NOT defer. The next invocation inherits whatever you leave behind.
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingplugins/asciinema-tools/skills/finalize/SKILL.md
Popularity
- Repository stars
- 62
- Repository forks
- 10
- 7-day trend score
- 21
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/terrylica/cc-skills/finalize)