hook-development is agent-read markdown (skill) from lstr-1/skills: 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, `$ORCHESTRATOR_PLUGIN_ROOT` portability, lifecycle limitations, and debugging. Trigger on "add a hook", "validate tool use", "block dangerous commands", "enforce completion", "hook-based automation.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# Hook Development for Claude Code Plugins
> **Port note — `unverified` runtime.** This skill references runtime modules under
> `scripts/lib/*.mjs`. Those modules are NOT present in the source plugin directory `sex/`
> and were NOT ported. Every such reference is `unverified`: the agent MUST probe for the
> module at runtime and continue in degraded mode when it is absent. Do NOT assume the module
> exists. Affected modules in this skill: `scripts/lib/platform.mjs`, `scripts/lib/plugin-root.mjs`.
Adapted from [claude-plugins-official/plugin-dev/skills/hook-development](https://github.com/anthropics/claude-plugins-official/tree/main/plugins/plugin-dev/skills/hook-development). Trimmed to what we actually author (our plugin already has 6 event matchers covering 7 hook handlers — see `hooks/hooks.json`).
## Hook types
### Prompt-based (LLM-driven, for complex reasoning)
```json
{
"type": "prompt",
"prompt": "Evaluate if this tool use is appropriate: $TOOL_INPUT",
"timeout": 30
}
```
Supported events: `Stop`, `SubagentStop`, `UserPromptSubmit`, `PreToolUse`.
Use for: context-aware decisions, flexible evaluation, natural-language reasoning.
…
Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
GET https://markdownregistry.com/api/v1/artifacts/art_mi5xkudsgu7g7ig2
GET https://markdownregistry.com/api/v1/resolve?ref=lstr-1/skills/hook-development
GET https://markdownregistry.com/api/v1/blob/fd7aa8384d35403438a8eb75c169627aff6f4919b51b7a1a368ef887cf5a877e
Your agent 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.
lstr-1/skills · create-skill/SKILL.md · Use when the user wants to create, design, or generate a new AI agent skill (SKILL.md) from a problem description. This…
lstr-1/skills · monitor-startup-dach/SKILL.md · Fetch the top-25 posts from r/StartupDACH/hot.json, classify each into six deterministic German intent clusters…
lstr-1/skills · nlm-meta-study/SKILL.md · Create scientific meta-studies on any topic using Gemini Notebook (NotebookLM). Invoke for systematic reviews…
lstr-1/skills · orchestrator/skills/architecture/SKILL.md · Use when the user asks to improve architecture, find refactoring opportunities, surface deepening opportunities…
lstr-1/skills · orchestrator/skills/autopilot/SKILL.md · Use this skill when running an autonomous session-orchestration loop. Chains session-start → session-plan →…
lstr-1/skills · orchestrator/skills/bootstrap/SKILL.md · Use this skill when scaffolding the minimum repository structure required by orchestrator. Invoked automatically by the…
lstr-1/skills · orchestrator/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…
lstr-1/skills · orchestrator/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…
lstr-1/skills · orchestrator/skills/daily/SKILL.md · Use this skill when creating today's daily note in the Meta-Vault (03-daily/YYYY-MM-DD.md) with valid…
lstr-1/skills · orchestrator/skills/debug/SKILL.md · Use when encountering any bug, test failure, build break, or unexpected behavior — runs a 4-phase systematic debugging…
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…
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…
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",
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…
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…
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",
kanevry/session-orchestrator · skills/hook-development/SKILL.md · Use when creating, modifying, or debugging Claude Code hooks — PreToolUse, PostToolUse, Stop, SubagentStop…
kanevry/session-orchestrator · .agents/skills/hook-development/SKILL.md · Use when creating, modifying, or debugging Claude Code hooks — PreToolUse, PostToolUse, Stop, SubagentStop…
