PreCommit

A comprehensive skill for managing pre-commit hooks - the framework for multi-language pre-commit hook management that automates code quality, formatting, linting, and security scanning.

Quick Reference

Command	Description
pre-commit install	Install git hooks
pre-commit run --all-files	Run all hooks on all files
pre-commit autoupdate	Update hooks to latest versions
pre-commit run <hook-id>	Run specific hook

Workflow Routing

Workflow	Trigger	File
Setup	"setup pre-commit", "initialize hooks", "create config"	Workflows/Setup.md
AddHooks	"add hook", "add linting", "add formatter", "add security"	Workflows/AddHooks.md
Troubleshoot	"fix pre-commit", "hook failing", "debug hooks"	Workflows/Troubleshoot.md
CIIntegration	"CI pipeline", "GitHub Actions", "GitLab CI"	Workflows/CIIntegration.md
CustomHook	"create custom hook", "local hook", "write hook"	Workflows/CustomHook.md

Documentation

Document	Purpose
QuickStartGuide.md	Installation and first-time setup
HooksReference.md	Comprehensive hook catalog by language/purpose
ConfigurationGuide.md	Advanced configuration options
SecurityHooks.md	Secret detection and security scanning

Tools

Tool	Purpose
Tools/PreCommitManager.ts	CLI for managing pre-commit configurations
Tools/HookGenerator.ts	Generate .pre-commit-config.yaml templates
Tools/HookValidator.ts	Validate hook configurations

Examples

Example 1: Setup pre-commit for a new project

User: "Setup pre-commit for my Python project"
→ Invokes Setup workflow
→ Creates .pre-commit-config.yaml with Python hooks (black, isort, flake8)
→ Runs pre-commit install

Example 2: Add Terraform hooks

User: "Add Terraform validation hooks"
→ Invokes AddHooks workflow
→ Adds terraform_fmt, terraform_validate, terraform_docs hooks
→ Configures tflint and checkov integration

Example 3: Add security scanning

User: "Add secret detection to pre-commit"
→ Invokes AddHooks workflow
→ Adds gitleaks, detect-secrets, trufflehog hooks
→ Configures appropriate exclusion patterns

Example 4: Debug failing hook

User: "My eslint pre-commit hook is failing"
→ Invokes Troubleshoot workflow
→ Checks hook configuration and dependencies
→ Provides fix recommendations

Supported Hook Categories

• Python: black, isort, flake8, mypy, bandit, pyupgrade
• JavaScript/TypeScript: prettier, eslint, biome
• Infrastructure: terraform, terragrunt, helm, kustomize
• Kubernetes: kubeconform, kubeval, checkov
• Security: gitleaks, detect-secrets, trufflehog, trivy
• General: yamllint, jsonlint, shellcheck, markdownlint