hook-validator

Audit pre-commit hook chain for completeness, order-independence, and sequencing. Prevents installer race conditions.

SKILL.md

GitHub

Hook Validator

Audit pre-commit hook shim for completeness and order-independence.

Trigger

/skill hook-validator [options]

Input Schema

interface Input {
  hookPath?: string;           // default: .git/hooks/pre-commit
  verbose?: boolean;           // default: false
  strict?: boolean;            // default: false (warn on partial, fail on missing)
}

Output Schema

interface Output {
  status: "success" | "error";
  verdict: "RED" | "YELLOW" | "GREEN";
  checks: Array<{
    name: string;              // e.g., "Shim Completeness"
    level: "error" | "warning" | "pass";
    message: string;
    details?: string[];
  }>;
  expectedHooks: string[];
  foundHooks: string[];
  timestamp: string;
}

Exit Codes

  • 0: GREEN (hook chain healthy)
  • 1: YELLOW (partial/warnings)
  • 2: RED (broken chain, cannot commit safely)

Full reference: See Skill Operator Guide.

For examples and incident history: See docs/USAGE.md.