CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

codex-hooks-builder

Scaffold hook packs, validate hooks.json schema, verify hook script permissions, migrate hook configuration, and troubleshoot Codex hook execution errors. Use when creating, auditing, upgrading, or validating Codex hook packs, hooks.json files, hook scripts, SubagentStart/SubagentStop lifecycle hooks, PreToolUse/PostToolUse/PreCompact hooks, Stop claim checks, or repo-local/user-level .codex hook installs.

Quality

90%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

81%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a dense, well-structured operational guide with executable discovery and validation commands, a fail-fast workflow with explicit feedback loops, and genuine one-level-deep references. Weaknesses are redundancy across the Constraints/Execution Boundaries/Gotchas/Anti-Patterns sections, abstract middle workflow steps, and one reference path that does not resolve within the skill bundle.

Suggestions

Consolidate the overlapping guidance repeated across Constraints, Execution Boundaries, Gotchas, and Anti-Patterns (stale runtime cards and projected-hook editing each appear twice) into a single section to reclaim tokens without losing content.

Make workflow steps 5–7 actionable: replace abstract directives like 'define the runtime card path, task-envelope source, artifact receipt schema … before implementation' with a minimal inline skeleton or a per-step pointer into references/hook-examples.md.

Fix or qualify the 'Infrastructure/references/deferred-skill-context/agent-ops-codex-hooks-builder/' path — either bundle the legacy material under references/ or state explicitly that it lives outside the skill — so every reference resolves within the skill bundle.

DimensionReasoningScore

Conciseness

Dense imperative lists with no teaching of concepts Claude already knows, but there is repetition across sections: stale runtime cards appear in both Gotchas ("Stale runtime cards must be refreshed or marked stale") and Anti-Patterns ("stale runtime cards … as acceptable evidence"), and projected-home-directory hook editing appears in both Execution Boundaries and Anti-Patterns. Mostly efficient with trimmable redundancy, so anchor 4 rather than 5; there is no padded or over-explained content that would justify 3.

4 / 5

Actionability

Includes copy-paste-ready discovery commands ("rg -n \"SessionStart|SubagentStart|…\" .codex codex hooks ."), a complete hooks.json example, and concrete validation commands ("jq empty <hooks.json>", "find <hook-dir> -type f -perm -111"). However, workflow steps 5–7 are abstract directives ("Model supported events", "define the runtime card path, task-envelope source … before implementation") and several commands use unfilled placeholders, so anchor 4 (minor gaps) rather than 5 (fully executable across common cases).

4 / 5

Workflow Clarity

An 8-step numbered workflow with an explicit validation step ("Validate config, script permissions, effective hook listing, and scaffold tests; fix the first failed gate before continuing"), a dedicated Validation section with exact commands, an explicit fail-fast feedback loop ("stop at first failed gate; do not proceed until it is fixed and rerun"), and a Failure Mode section with a revert-and-rerun recovery loop. This matches the top anchor: clear sequence, explicit validation, feedback loops for error recovery.

5 / 5

Progressive Disclosure

references/hook-examples.md and references/discovery-interview.md exist, are substantive, are one level deep, and are clearly signaled with purpose and trigger conditions ("Read references/discovery-interview.md when the request is underspecified"), and the References section names each file with its purpose. The gap: "Infrastructure/references/deferred-skill-context/agent-ops-codex-hooks-builder/" does not resolve inside the skill's bundle (references/ is the only bundled directory), so one reference is effectively dangling, keeping this at anchor 4 rather than 5.

4 / 5

Total

17

/

20

Passed

Description

96%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is near-exemplary: five concrete capability verbs, comprehensive natural trigger terms including file names and hook event names, and an explicit 'Use when' clause with concrete triggers. Its only weakness is that several trigger terms are shared with generic agent-hook skills, creating minor overlap risk with closely related skills.

DimensionReasoningScore

Specificity

Five concrete, specific actions with concrete objects: "Scaffold hook packs, validate hooks.json schema, verify hook script permissions, migrate hook configuration, and troubleshoot Codex hook execution errors". Coverage spans create, audit, upgrade, validate, migrate, and troubleshoot, so it fits the 'comprehensive coverage' anchor rather than the 'minor gaps' anchor below it.

5 / 5

Completeness

Clearly answers both: what ("Scaffold hook packs, validate hooks.json schema, verify hook script permissions, migrate hook configuration, and troubleshoot Codex hook execution errors") and when ("Use when creating, auditing, upgrading, or validating Codex hook packs, hooks.json files, hook scripts…") with concrete trigger phrases, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Comprehensive natural terms including file names, event names, and install paths: "Codex hook packs", "hooks.json files", "hook scripts", "SubagentStart/SubagentStop lifecycle hooks", "PreToolUse/PostToolUse/PreCompact hooks", "Stop claim checks", "repo-local/user-level .codex hook installs". A user needing this skill would naturally say these phrases.

5 / 5

Distinctiveness Conflict Risk

The niche is clearly Codex hook packs, but generic agent-hook terminology ("hooks.json", "PreToolUse/PostToolUse/PreCompact hooks", "Stop") overlaps with closely related hook skills (e.g., Claude Code hooks), creating minor wrong-skill trigger risk. It is mostly distinct rather than having a fully clear niche, so anchor 4 fits better than 5; it is far too pinned to Codex to fall to 3.

4 / 5

Total

19

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

jscraik/Agent-Skills

Path

Skills/agent-ops/codex-hooks-builder/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.