hook-development

Create Codex plugin hooks for event-driven automation using JSON.

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/billydeeii136/black-opps-claude-skill --skill hook-development-billydeeii136
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hook-development
Source: https://github.com/billydeeii136/black-opps-claude-skill/tree/main/agent-skills/plugin-dev/skills/hook-development
Command: npx skills add https://github.com/billydeeii136/black-opps-claude-skill --skill hook-development-billydeeii136

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Codex, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill simplifies the creation and implementation of Codex plugin hooks, providing a comprehensive framework for advanced automation.

Core Features & Use Cases

  • Event-Driven Automation: Execute scripts in response to Codex events like tool use, session start, and user prompts.
  • Prompt-Based Validation: Leverage LLM-driven decision making for context-aware validation and feedback.
  • Command Hooks: Execute bash commands for deterministic checks and integrations.
  • Use Case: Enhance your Claude Code workflow by creating a PreToolUse hook to validate file write operations and a SessionStart hook to load project context.

Quick Start

Implement a PreToolUse hook to validate file write operations by providing the command: ```bash hook-development create PreToolUse --prompt "Check if this file write is safe: $TOOL_INPUT.file_path" --timeout 30

Frequently Asked Questions about hook-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create Codex plugin hooks for event-driven automation?

You can create Codex plugin hooks by providing a command specifying the event type, prompt, and timeout, such as generating a PreToolUse hook with a validation prompt to check file write operations before execution.

What is a PreToolUse hook and how does it validate file write operations?

A PreToolUse hook is an event-driven automation script that intercepts tool use events in Codex, leveraging LLM-driven decision making to validate actions like file writes based on context-aware prompts before they execute.

Do I need scripting skills and Codex API knowledge to implement event-driven hooks?

Yes, implementing Codex hooks requires understanding the Codex hooks API and scripting skills to define JSON inputs, bash command hooks, and prompt-based validation for event-driven operations.

Can I execute bash commands for deterministic checks using Codex hooks?

Yes, Codex hooks support command hooks that execute bash commands for deterministic checks and integrations, complementing prompt-based validation by providing exact, non-LLM-driven automation responses.

How does a SessionStart hook load project context in Codex?

A SessionStart hook loads project context by executing event-driven scripts triggered during session initialization, automatically injecting necessary environmental data and configuration into the Codex workflow.

What are the limitations of using prompt-based validation in Codex hooks?

Prompt-based validation in Codex hooks depends on LLM-driven decision making which introduces non-deterministic outcomes and requires timeout configurations, meaning it may not suit deterministic checks where exact bash commands are necessary.