hooks
Install/uninstall hooks for auto-backup on session end. TRIGGERS - hooks, auto backup, session hooks.
How do I install this agent skill?
npx skills add https://github.com/terrylica/cc-skills --skill hooksIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill is designed to manage automation hooks for Claude Code. It allows the agent to install, uninstall, or check the status of a hook in the local settings file that triggers a backup command after tool usage.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- Runlayerwarn
1/2 files flagged
What does this agent skill do?
/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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/terrylica/cc-skills/hooks">View hooks on skillZs</a>