微信扫一扫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