invalid-hook-command

Detect invalid AGH hook commands during session.post_create registration.

182|8|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/compozy/agh --skill invalid-hook-command
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: invalid-hook-command
Source: https://github.com/compozy/agh/tree/main/internal/skills/testdata/loader/invalid-hook-command
Command: npx skills add https://github.com/compozy/agh --skill invalid-hook-command

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you detect and debug a misconfiguration where an AGH hook is registered with an invalid or unsupported hook command, preventing agent session lifecycle events from being handled correctly.

Core Features & Use Cases

  • Hook validation via registration attempt: Ensures the hook configuration includes a valid command for the targeted event such as session.post_create.
  • Agent lifecycle troubleshooting: Useful when sessions are created but expected post-create automation does not run due to a bad hook command.
  • Test/loader scenario: Designed for loader/registration tests that verify error handling when required hook command fields are missing or incorrect.

Quick Start

Ask an AI to verify the hook registration for the session.post_create event and confirm that the configured hook command is valid and supported.

Frequently Asked Questions about invalid-hook-command

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

FAQPage Schema
Why does my agent session.post_create hook not run after session creation?

Your session.post_create hook fails to run when the AGH hook registration uses a missing or invalid hook command. This Skill detects configuration failures where the hook command field is unsupported or incorrectly specified for the targeted lifecycle event.

How do I validate an agent hook configuration schema for lifecycle events?

You can validate an agent hook configuration by attempting registration to verify the schema includes a supported hook command. This Skill checks whether the loader accepts or correctly rejects the configuration for lifecycle events like session.post_create.

What is an invalid hook command in an agent runtime setup?

An invalid hook command in an agent runtime setup is a missing or unsupported command configured for a session lifecycle event. This Skill identifies these misconfigurations early to prevent post-create automation from failing silently.

Can I test agent hook loader error handling for bad session.post_create commands?

Yes, you can test loader error handling by registering hooks with incorrect or missing command fields. This Skill is designed for loader and registration tests to verify that invalid hook commands are correctly rejected during session.post_create setups.

What happens when a hook configuration schema is missing a required hook command?

When a hook configuration schema omits a required hook command, the runtime loader cannot execute the session lifecycle event handler. This Skill catches the missing command during registration so the agent runtime can correctly reject the invalid setup.