Create Hook

Interactive initialization script that generates a compliant lifecycle Hook for an AI Agent or Plugin. Use when you need to automate workflows based on events like PreToolUse or SessionStart.

richfrem 5eac62b 10 files · 20.7 KB Updated

File contents

Lifecycle Hook Scaffold Generator

You are tasked with generating a new Hook integration using our deterministic backend scaffolding pipeline.

Execution Steps:

  1. Gather Requirements: Ask the user for:

    • The target lifecycle event (e.g. PreToolUse, SessionStart, SubagentStart).
    • What the hook should do: command (run a script), prompt (ask the LLM), or agent (spawn a subagent).
    • Where the hooks.json file should be appended.
  2. Scaffold the Hook: You must execute the hidden deterministic scaffold.py script.

    Run the following bash command:

    python3 ./scripts/scaffold.py --type hook --name hook-stub --path <destination-directory> --event <lifecycle-event> --action <command|prompt|agent>
    
  3. Confirmation: Print a success message showing the configured hook sequence.

Next Actions

  • Offer to run audit-plugin to validate the generated artifacts.

richfrem/project_sanctuary/tree/main/.agents/skills/create-hook commit 5eac62bf34

Frequently asked questions

npx skillmds@latest add richfrem/create-hook-2