メニュー
Create or revise native Codex hooks.json events and command handlers with strict inputs, timeouts, portability, and failure behavior. Use when automating lifecycle checks around Codex sessions or tool calls.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Start here for the nddev-builder toolkit. Indexes the Codex artifact families and the creator, checker, reviewer, and workflow skill that owns each, points at the single reference for schemas and current (Beta, experimental, or under-development) surfaces, and routes the task to the right skill. Use first whenever building, checking, reviewing, or releasing a Codex artifact, or when unsure which builder skill applies.
A guided first run of the nddev-builder toolkit — from zero to a working, checked Codex artifact in ordered steps. Use when new to nddev-builder, onboarding, or unsure which builder skill to start with.
Create or revise a Codex marketplace catalog with valid plugin sources, categories, installation policy, and authentication policy. Use when publishing local or remote plugin collections.
Check a managed Codex requirements.toml layer for supported keys, permission-profile consistency, and a valid lower-layer default. Use before delivering managed /etc/codex or MDM requirements.
Create a managed Codex requirements.toml layer that constrains permission profiles and other admin policy. Use when authoring the /etc/codex or MDM-delivered managed requirements a lower config layer must satisfy.
Install and iterate on a Codex plugin locally in developer mode: the install, reinstall, and cachebuster test loop for a plugin under development, run against an isolated install and never live state. Use when running or iterating on a plugin, its skills, MCP, hooks, or bundled app locally.
| name | codex-hook-creator |
| description | Create or revise native Codex hooks.json events and command handlers with strict inputs, timeouts, portability, and failure behavior. Use when automating lifecycle checks around Codex sessions or tool calls. |
Resolve every ../../scripts and ../../references path relative to this SKILL.md directory, never the caller working directory.
Create the smallest hook that enforces a real lifecycle invariant without competing with another owner.
Define the event, matcher, input contract, intended side effect, timeout, and failure policy.
Read ../../references/codex-artifact-contracts.md for supported hook events and schema.
Choose the active-config or plugin-default surface. For a plugin, create the handler first, then generate the interoperable default with a stable PLUGIN_ROOT reference:
python3 ../../scripts/create_codex_artifact.py hook --help
python3 ../../scripts/create_codex_artifact.py hook --output hooks --name lifecycle-hooks --description "Run bounded lifecycle checks" --command 'sh ${PLUGIN_ROOT}/hooks/session-start.sh'
Implement handlers as separate deterministic scripts when logic exceeds a simple command.
Resolve plugin-local files through PLUGIN_ROOT. For project hooks, resolve from the Git root because commands execute from the session CWD. Quote arguments, bound execution time, and write diagnostics to stderr.
Never embed secrets or silently swallow failures. Ensure only one hook owns an ordered lifecycle such as Stop.
Validate:
python3 ../../scripts/check_codex_artifact.py hook hooks/hooks.json
Exercise valid input, malformed input, handler failure, and timeout in an isolated environment.