Cc-skills hooks

Install/uninstall hooks for auto-backup on session end. TRIGGERS - hooks, auto backup, session hooks.

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/hooks" ~/.claude/skills/terrylica-cc-skills-hooks && rm -rf "$T"

manifest: plugins/asciinema-tools/skills/hooks/SKILL.md

source content

/asciinema-tools:hooks

Manage Claude Code hooks for asciinema-tools automation.

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`	Add hooks to settings.json
`uninstall`	Remove asciinema-tools hooks
`status`	Show current hook configuration
`--backup-on-stop`	Auto-backup when session ends
`--convert-on-stop`	Auto-convert on session end
`-y, --yes`	Skip confirmation prompts

Hook Definitions

PostToolUse Hook (backup-on-stop)

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Bash",
        "command": "asciinema-backup-if-active"
      }
    ]
  }
}

Execution

Skip Logic

If action provided -> execute directly
If hook type flags provided -> use specific hooks

Workflow

Status: Read current ~/.claude/settings.json
Action: AskUserQuestion for action type
Hooks: AskUserQuestion for hook selection
Execute: Modify settings.json
Verify: Confirm changes applied

Examples

# Check current hook status
/asciinema-tools:hooks status

# Install auto-backup hook
/asciinema-tools:hooks install --backup-on-stop

# Install without prompts
/asciinema-tools:hooks install -y

# Remove all asciinema hooks
/asciinema-tools:hooks uninstall

Troubleshooting

Issue	Cause	Solution
jq not found	jq not installed	`brew install jq`
Settings file not found	~/.claude/ doesn't exist	Create with `mkdir -p ~/.claude`
Hooks not working	Session not restarted	Restart Claude Code session
Backup not triggering	No active recordings	Start recording first with daemon

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.