hook-development SKILL.md skillA

hook-development from kanevry/session-orchestrator is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kanevry/session-orchestrator/hook-development@git:20261101.758cdac

Pins git:20261101.758cdac in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kanevry/session-orchestrator
Path
skills/hook-development/SKILL.md
Versions recorded
9
Latest version
git:20261101.758cdac, committed Nov 1, 2026
First version recorded
Apr 24, 2026
Size
15,975 bytes
Repository stars
53
License
MIT

Use when creating, modifying, or debugging Claude Code hooks — PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification. Covers the plugin `hooks/hooks.json` wrapper format vs. the user `settings.json` direct format, matchers, security patterns, `$CLAUDE_PLUGIN_ROOT` portability, lifecycle limitations, and debugging. Trigger on "add a hook", "validate tool use", "block dangerous commands", "enforce completion", "hook-based automation".

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Hook Development for Claude Code Plugins

Use the [official Claude Code hooks reference](https://code.claude.com/docs/en/hooks) as the source of truth for current events and schemas. This skill keeps only the conventions needed to author this plugin's hooks.

## Hook types used in this plugin

Claude Code also documents `http`, `mcp_tool`, and experimental `agent` handlers. Use those only after checking their current fields and event support in the official reference.

### Prompt-based (LLM-driven, for complex reasoning)

```json
{
  "type": "prompt",
  "prompt": "Evaluate whether this event should proceed: $ARGUMENTS",
  "timeout": 30
}
```

Prompt hooks are supported only on events documented for that handler type. `$ARGUMENTS` contains the hook input JSON.

Use for: context-aware decisions, flexible evaluation, natural-language reasoning.

### Command (deterministic, for fast checks)

```json
{
  "type": "command",
  "command": "${CLAUDE_PLUGIN_ROOT}/hooks/validate.mjs",
  "timeout": 60
}
```

Use for: fast deterministic validations, file-system ops, external tools, performance-critical paths.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kanevry/session-orchestrator/hook-development@sha256:603382151d597960

The line at the top of this page pins the label git:20261101.758cdac, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_q35ltokettbgycxg.svg)](https://markdownregistry.com/a/art_q35ltokettbgycxg)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 9 versions of this file, between Apr 24, 2026 and Nov 1, 2026, about one every 24 days.

versioncommittedcommitsizeaudit
git:20261101.758cdac latest2026-11-01 758cdac 15,975 BA view · diff
git:20261003.c34ec502026-10-03 c34ec50 15,422 BA view · diff
git:20260916.dd05e0f2026-09-16 dd05e0f 15,400 BA view · diff
git:20260915.81c9ffa2026-09-15 81c9ffa 15,128 BA view · diff
git:20260803.d2de3ca2026-08-03 d2de3ca 13,225 BA view · diff
git:20260518.a68e94f2026-05-18 a68e94f 13,225 BA view · diff
git:20260517.a84eba82026-05-17 a84eba8 13,245 BA view · diff
git:20260428.503e15a2026-04-28 503e15a 13,231 BA view · diff
git:20260424.77aa46e2026-04-24 77aa46e 9,697 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (15975 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kanevry/session-orchestrator · 53 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_q35ltokettbgycxg
GET https://markdownregistry.com/api/v1/resolve?ref=kanevry/session-orchestrator/hook-development
GET https://markdownregistry.com/api/v1/blob/603382151d597960d69a2a73df58c5eff5a03a4d02b1aa9bc8d63ce43f9ab3b3

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from kanevry/session-orchestrator

architecture SKILL.md skill
kanevry/session-orchestrator · .agents/skills/architecture/SKILL.md · Use when the user asks to improve architecture, find refactoring opportunities, surface deepening opportunities…
git:20261003.c34ec50 · audit A · 53 stars
autopilot SKILL.md skill
kanevry/session-orchestrator · .agents/skills/autopilot/SKILL.md · Use this skill when running an autonomous session-orchestration loop. Chains session-start → session-plan →…
git:20260919.176b605 · audit A · 53 stars
bootstrap SKILL.md skill
kanevry/session-orchestrator · .agents/skills/bootstrap/SKILL.md · Use this skill when scaffolding the minimum repository structure required by session-orchestrator. Invoked…
git:20260919.176b605 · audit A · 53 stars
brainstorm SKILL.md skill
kanevry/session-orchestrator · .agents/skills/brainstorm/SKILL.md · Use when you have a feature idea but the scope or UX is still ambiguous — runs a lightweight Socratic design dialogue…
git:20260919.176b605 · audit A · 53 stars
claude-md-drift-check SKILL.md skill
kanevry/session-orchestrator · .agents/skills/claude-md-drift-check/SKILL.md · Use when detecting drift between CLAUDE.md (or AGENTS.md, the Codex CLI alias) / _meta narrative and live repository…
git:20261003.c34ec50 · audit A · 53 stars
close SKILL.md skill
kanevry/session-orchestrator · .agents/skills/close/SKILL.md · End session with verification, commits, and documentation
git:20260919.176b605 · audit A · 53 stars
convergence-monitoring SKILL.md skill
kanevry/session-orchestrator · .agents/skills/convergence-monitoring/SKILL.md · Monitor iterative improvement loops for convergence. Three signals — shrinking diff, pass-rate plateau, velocity —…
git:20260919.176b605 · audit A · 53 stars
debug SKILL.md skill
kanevry/session-orchestrator · .agents/skills/debug/SKILL.md · Use when encountering any bug, test failure, build break, or unexpected behavior — runs a 4-phase systematic debugging…
git:20260919.176b605 · audit A · 53 stars
deepen SKILL.md skill
kanevry/session-orchestrator · .agents/skills/deepen/SKILL.md · Make a task deeper, not bigger. Use when the user asks for a deeper or more ambitious version of a task (tiefer, geh…
git:20261027.7eb9aed · audit A · 53 stars
discovery SKILL.md skill
kanevry/session-orchestrator · .agents/skills/discovery/SKILL.md · Use this skill when running systematic quality discovery and issue detection. Runs modular probes adapted to the…
git:20260919.176b605 · audit A · 53 stars
dispatcher SKILL.md skill
kanevry/session-orchestrator · .agents/skills/dispatcher/SKILL.md · Use when you want the orchestrator to pick the next repo to work on across your whole portfolio — it enumerates…
git:20260919.176b605 · audit A · 53 stars
docs-orchestrator SKILL.md skill
kanevry/session-orchestrator · .agents/skills/docs-orchestrator/SKILL.md · Use this skill when orchestrating documentation generation and updates within a session. Maps session scope to…
git:20260919.176b605 · audit A · 53 stars

Every file in kanevry/session-orchestrator

Other files named hook-development

hook-development SKILL.md skill
anthropics/claude-plugins-official · plugins/plugin-dev/skills/hook-development/SKILL.md · This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate…
v0.1.0 · audit A · 46,363 stars
hook-development Cursor rule
vibeeval/vibecosystem · .cursor/rules/hook-development.mdc · Rules for developing vibecosystem TypeScript hooks
git:20260330.cd5da78 · audit A · 539 stars
hook-development SKILL.md skill
nota-america/forgecat-agent-profiles · profiles/anthropics/claude-plugins-official/anthropics_claude-plugins-official_plugin-dev/for-forgecat/platforms/codex/.agents/skills/hook-development/SKILL.md · This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate…
v0.1.0 · audit A · 93 stars
hook-development SKILL.md skill
nota-america/forgecat-agent-profiles · profiles/anthropics/claude-plugins-official/anthropics_claude-plugins-official_plugin-dev/for-codex/.agents/skills/hook-development/SKILL.md · This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate…
v0.1.0 · audit A · 93 stars
hook-development SKILL.md skill
nota-america/forgecat-agent-profiles · profiles/anthropics/claude-plugins-official/anthropics_claude-plugins-official_plugin-dev/for-cursor/.cursor/skills/hook-development/SKILL.md · This skill should be used when the user asks to "create a hook",
v0.1.0 · audit A · 93 stars
hook-development SKILL.md skill
nota-america/forgecat-agent-profiles · profiles/anthropics/claude-plugins-official/anthropics_claude-plugins-official_plugin-dev/for-forgecat/platforms/cursor/.cursor/skills/hook-development/SKILL.md · This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate…
v0.1.0 · audit A · 93 stars
hook-development SKILL.md skill
nota-america/forgecat-agent-profiles · profiles/anthropics/claude-plugins-official/anthropics_claude-plugins-official_plugin-dev/for-forgecat/skills/hook-development/SKILL.md · This skill should be used when the user asks to "create a hook", "add a PreToolUse/PostToolUse/Stop hook", "validate…
v0.1.0 · audit A · 93 stars
hook-development SKILL.md skill
nota-america/forgecat-agent-profiles · profiles/anthropics/claude-plugins-official/anthropics_claude-plugins-official_plugin-dev/for-claude/.claude/skills/hook-development/SKILL.md · This skill should be used when the user asks to "create a hook",
v0.1.0 · audit A · 93 stars

Browse by kind, by grade A, or by owner.