richfrem

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 4 Updated 3mo ago

Resources

2
GitHub

Install

npx skillscat add richfrem/project-sanctuary/create-hook

Install via the SkillsCat registry.

SKILL.md

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 ~~agent-scaffolders-root/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.