Task Orchestrator Hooks Builder

Generate bash hook scripts for Task Orchestrator cascade events.

Updated Dec 22, 2025
One-click install
npx skills add https://github.com/Angriff36/task-orchestrator --skill task-orchestrator-hooks-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Task Orchestrator Hooks Builder
Source: https://github.com/Angriff36/task-orchestrator/tree/main/claude-plugins/task-orchestrator/skills/task-orchestrator-hooks-builder
Command: npx skills add https://github.com/Angriff36/task-orchestrator --skill task-orchestrator-hooks-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides users to design and implement hooks that respond to Task Orchestrator cascade events, enabling automation and integration with MCP clients like Claude Code, Cursor, Windsurf, and more.

Core Features & Use Cases

  • Hook Design: Interview questions to determine trigger events, matchers, and actions.
  • Script Generation: Produce robust bash scripts with defensive checks.
  • Config Integration: Update settings to register new hooks.
  • Testing & Troubleshooting: Provide test inputs and debugging steps.

Quick Start

  1. Identify an event to trigger (PostToolUse, SubagentStop, or PreToolUse).
  2. Implement a basic hook script under example-hooks (e.g., cascade-auto-progress.sh).
  3. Add a configuration entry to the settings file (settings.local.json) to enable the hook.

Frequently Asked Questions about Task Orchestrator Hooks Builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Task Orchestrator cascade events with hooks?

Automate cascade events by creating bash hook scripts that trigger on PostToolUse, SubagentStop, or PreToolUse events. The Skill guides you through interview-based requirement gathering, script generation with defensive checks, and registration in .claude/settings.local.json to enable hooks across MCP clients like Claude Code, Cursor, and Windsurf.

What MCP clients support Task Orchestrator hooks?

Task Orchestrator hooks work with Claude Code, Claude Desktop, Cursor, Windsurf, and other MCP clients. Hooks integrate directly into these environments by registering in .claude/settings.local.json and execute bash scripts that parse JSON with jq and access filesystem paths via $CLAUDE_PROJECT_DIR.

How do I create a bash hook script for cascade integration?

Create a bash hook script under example-hooks directory with defensive checks and jq-based JSON parsing. Register it in settings.local.json with a trigger event (PostToolUse, SubagentStop, or PreToolUse), matchers, and action configuration. The Skill provides templates and testing workflows to validate blocking and non-blocking decisions with telemetry logging.

Can I use hooks to add telemetry and audit logging to workflows?

Yes. Hook scripts support both blocking and non-blocking decisions with built-in telemetry and audit-trail logging. Parse cascade event JSON, apply matchers, and execute actions that log workflow state, decisions, and outcomes for compliance and debugging across MCP client environments.

What should I do if a hook isn't triggering or working correctly?

The Skill includes testing and troubleshooting workflows to debug hook execution. Verify event registration in .claude/settings.local.json, test with sample JSON inputs, check bash script syntax and jq expressions, and review audit logs for execution state and errors.

Do I need to know bash and jq to build hooks?

The interview-guided design process helps you specify requirements without prior bash knowledge, but implementing robust hooks requires basic bash syntax and jq for JSON parsing. The Skill generates script templates with defensive checks to reduce complexity and supports non-blocking decision logic for simpler automation.

Related Skills