hook-validator
Audit pre-commit hook chain for completeness, order-independence, and sequencing. Prevents installer race conditions.
SKILL.mdskills/hook-validator/SKILL.md
GitHubHook 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.