Skip to main content
affpapa.org
RU EN
skill CX Codex

hook-setup — Claude Code skill: configure monitoring hooks

Checks and installs CCAM monitoring hooks for Claude Code and Codex. Use it when adding a provider, repairing hooks, or verifying an installation.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill hook-setup -a claude-code
Open on GitHub

What hook-setup does

The skill starts with ccam hooks status and reports missing hooks and entries that would be replaced. It waits for confirmation before running ccam hooks install <selected-or-missing-providers> --yes. Choose claude, codex, or both according to the requested scope and the status report.

After installation, it checks the status again. It then asks you to start a real provider session and verify that CCAM receives a new event. The installer replaces CCAM-owned entries while keeping other user hooks intact. Hook execution must stay non-blocking and fail-safe.

For Claude Code, install the skill with npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill hook-setup -a claude-code; its file is at ~/.claude/skills/hook-setup/SKILL.md. No installation runs before confirmation.

What it helps with

  • check which CCAM hooks are installed
  • add monitoring hooks for a chosen provider
  • restore missing provider hooks
  • verify that unrelated user hooks remain intact
  • check whether a new session event reaches CCAM

Example prompts for the agent

  • Check CCAM hook status and show me what would be added or replaced.
  • Set up CCAM hooks for Codex, show the proposed changes, and wait for my approval.
  • Verify the CCAM installation and help me check for an event from a new session.

How to install hook-setup

1Skills CLI (Vercel)

npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill hook-setup -a claude-code

2Manually: put the files in place

~/.claude/skills/hook-setup/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/hook-setup/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about hook-setup

How do I install hook-setup in Claude Code?

Run npx skills add hoangsonww/Claude-Code-Agent-Monitor --skill hook-setup -a claude-code. The skill file is at ~/.claude/skills/hook-setup/SKILL.md.

What does hook-setup do?

It checks CCAM hook status, reports missing or replaceable entries, and installs the selected provider hooks after approval. It then checks status again and guides you through verifying an event from a real session.

Does hook-setup preserve other user hooks?

Yes. The installer replaces CCAM-owned entries and leaves unrelated hooks intact. Hook execution must remain non-blocking and fail-safe.

Source text

SKILL.md · MIT 
---
name: hook-setup
description: >
  Inspect and install CCAM monitoring hooks for Claude Code and Codex. Use when
  onboarding a provider, repairing missing hooks, checking which provider is
  active, or validating that installation preserved unrelated user hooks.
---

# Hook Setup

1. Inspect current state: `ccam hooks status`.
2. Show which provider hooks are missing or will be replaced.
3. Install only after confirmation:

```bash
ccam hooks install <selected-or-missing-providers> --yes
```

Replace the placeholder with `claude`, `codex`, or `claude codex` based on the
user's selected scope and the missing providers reported by `ccam hooks status`.

4. Read back `ccam hooks status`.
5. Start a real provider session and verify a new session/event reaches CCAM.

Installers replace only CCAM-owned entries and preserve unrelated hooks.
Hook execution must remain fail-safe and non-blocking.

© hoangsonww · MIT · hoangsonww/Claude-Code-Agent-Monitor

Similar skills

SKILL.md skills catalog →
find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. CX Codex +1 4,000,000installs frontend-design official anthropics This skill guides intentional visual design for new interfaces and redesigns. Use it when a generic generated UI is not enough. 1,025,790installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. 1,424,476installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. 1,219,756installs improve-codebase-architecture Matt Pocock This skill scans a codebase for architectural friction, then builds a visual HTML report with refactoring candidates. Use it before a deeper architecture review. 1,163,035installs design-taste-frontend Leonxlnx This skill directs the design of public pages and work screens, then checks the result in a browser through screenshots. Use it when an interface feels generic or unfinished. CX Codex +1 678,700installs

From the same set60

sprint-summary Summarizes Claude Code sprint activity using Agent Monitor data: session costs, model breakdown, project groupings, and velocity metrics. CX Codex +1 ★ 1,121repo stars monthly-review Builds a monthly retrospective from Agent Monitor data, comparing sessions, costs, tokens, and project activity. Use it to review the month and plan the next one. CX Codex +1 ★ 1,121repo stars daily-standup Turns your recent Claude sessions into a standup report: work done per project, errors hit, what it cost. CX Codex +1 ★ 1,121repo stars mcp-server Configures, builds, and runs the CCAM MCP server across Claude Code and other hosts. Useful when choosing transport modes or locking down mutation policies. CX Codex +1 ★ 1,121repo stars history-portability Pulls in Claude or Claude history and shifts whole CCAM datasets between machines. Useful when you switch laptops or need a restore. CX Codex +1 ★ 1,121repo stars config-explorer Inspects and edits Claude Code and Codex settings through CCAM with timestamped backups. Useful for auditing hooks, memory, rules, and MCP servers. CX Codex +1 ★ 1,121repo stars webhook-management Configure CCAM webhook targets, connect them to alert rules, and inspect delivery records. Use the skill when managing notification endpoints from the CLI. CX Codex +1 ★ 1,121repo stars remote-collection A skill that walks the agent through CCAM remote data sources: connect machines over SSH and pull Claude and Codex history. Useful when sessions live beyond your laptop. CX Codex +1 ★ 1,121repo stars

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor