About backup
A skill for configuring and managing streaming backups of asciinema recordings to a GitHub orphan branch. It supports setup, status checks, stopping backups, and reviewing recent backup commits.
Key features
- 01Configure and start backup automation
- 02Check active backups and last sync
- 03Stop backup for the current session
- 04Review recent backup commits
- 05Set repository and sync interval
Use cases
- 01Starting streaming backups to a GitHub repository
- 02Checking whether backups are syncing
- 03Disabling a session's backup
- 04Reviewing recent backup history
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/backupin Claude Code to confirm it loaded.
Bundled filesreferences/evolution-log.md
Details
From the project README/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.