/asciinema-tools:backup
Configure and manage streaming backup to GitHub 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 |
|---|---|
install | Configure and start backup automation |
status | Show active backups and last sync |
stop | Disable backup for current session |
history | View recent backup commits |
-r, --repo | GitHub repository (e.g., owner/repo) |
-i, --interval | Sync interval (e.g., 30s, 5m) |
--chunk | Split at idle time |
--meta | Include session metadata |
Execution
Invoke the asciinema-streaming-backup skill with user-selected options.
Skip Logic
- If action provided -> skip Phase 1 (action selection)
- If
-rand-iprovided -> skip Phase 2-3 (config and repo)
Workflow
- Preflight: Check gh CLI and fswatch
- Action: AskUserQuestion for action type
- Config: AskUserQuestion for backup settings
- Repo: AskUserQuestion for repository selection
- Execute: Run selected action
Examples
# Check current backup status
/asciinema-tools:backup status
# Configure and start backup automation
/asciinema-tools:backup install
# View recent backup history
/asciinema-tools:backup history
# Stop backup for current session
/asciinema-tools:backup stop
Troubleshooting
| Issue | Cause | Solution |
|---|---|---|
| gh not found | gh CLI not installed | brew install gh |
| fswatch not found | fswatch not installed | brew install fswatch |
| Auth error | GitHub token invalid/expired | Run gh auth login |
| Orphan branch error | Branch not initialized | Run /asciinema-tools:daemon-setup |
| No recordings found | No active .cast files | Start a recording first |
Post-Execution Reflection
After this skill completes, check before closing:
- Did the command succeed? — If not, fix the instruction or error table that caused the failure.
- Did parameters or output change? — If the underlying tool's interface drifted, update Usage examples and Parameters table to match.
- 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.