---
name: "lefthook-fast-git-hooks-manager"
description: "Execute parallel, fast Git hooks across monorepos and polyglot codebases using Lefthook."
metadata:
  author: "Evil Martians"
  version: "1.0.0"
  runtime_compatibility:
    - "codex"
    - "claude-code"
    - "cursor"
    - "windsurf"
triggers:
  - "configure lefthook.yml"
  - "parallel git hooks lefthook"
  - "staged_files filter lefthook"
permissions:
  fs_read: true
  fs_write: "workspace"
  shell_exec: false
  net_access: false
---

# Lefthook Ultra-Fast Polyglot Git Hooks Manager

Configures Evil Martians Lefthook: defining lefthook.yml, running commands and scripts in parallel, file glob filtering ({staged_files}), pre-push and commit-msg hooks, and skipping hooks in CI environments.

## When to Invoke
Invoke this skill whenever you need to:
- configure lefthook.yml
- parallel git hooks lefthook
- staged_files filter lefthook

## Execution SOP & Rules
1. Install lefthook via npm, brew, or binary and run lefthook install.
2. Define lefthook.yml specifying pre-commit commands with parallel: true.
3. Use glob patterns: glob: '*.{js,ts,jsx,tsx}' and run: npx biome check {staged_files}.
4. Test hooks manually: lefthook run pre-commit.

## Verification Checklist
- Run local linting, syntax validation, and type-checks before reporting completion.
- Ensure all created or modified files adhere to workspace boundaries and avoid uncommitted secrets.
- Verify tests or build commands exit cleanly with return code 0.