Cc-skills backup

Stream-backup active recordings to GitHub. TRIGGERS - backup recording, sync cast, streaming backup.

install
source · Clone the upstream repo
git clone https://github.com/terrylica/cc-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/terrylica/cc-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/asciinema-tools/skills/backup" ~/.claude/skills/terrylica-cc-skills-backup && rm -rf "$T"
manifest: plugins/asciinema-tools/skills/backup/SKILL.md
source content

/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

ArgumentDescription
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
    -r
    and
    -i
    provided -> skip Phase 2-3 (config and repo)

Workflow

  1. Preflight: Check gh CLI and fswatch
  2. Action: AskUserQuestion for action type
  3. Config: AskUserQuestion for backup settings
  4. Repo: AskUserQuestion for repository selection
  5. 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

IssueCauseSolution
gh not foundgh CLI not installed
brew install gh
fswatch not foundfswatch not installed
brew install fswatch
Auth errorGitHub token invalid/expiredRun
gh auth login
Orphan branch errorBranch not initializedRun
/asciinema-tools:daemon-setup
No recordings foundNo active .cast filesStart a recording first

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.