pre-commit
Pre-commit hooks framework for multi-language code quality automation. USE WHEN setting up pre-commit OR configuring git hooks OR adding linting OR code formatting OR security scanning OR Terraform validation OR Kubernetes manifests OR Helm charts OR Python linting OR JavaScript formatting. Manages .pre-commit-config.yaml, hook installation, and CI integration.
How do I install this agent skill?
npx skills add https://github.com/julianobarbosa/claude-code-skills --skill pre-commitIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides tools and documentation for managing pre-commit hooks. It includes TypeScript scripts for generating, validating, and managing hook configurations. While the skill facilitates the execution of third-party hooks from remote repositories and includes common CI/CD setup patterns like piped shell executions, these are standard practices for the pre-commit ecosystem and target well-known, reputable sources.
- Socketwarn
1 alert: gptAnomaly
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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
Gotchas
- Hook output disappears when run via
git commit -min an editor terminal — stdout/stderr get swallowed by the editor wrapping. Runpre-commit run --all-filesdirectly to see the actual failure message. pre-commit autoupdatebumps to latest tag but doesn't update pinned config in hook repos — a hook that pinsflake8==6.0.0internally keeps that version. Look at each hook'sadditional_dependenciesafter autoupdate.- Hooks only run on staged files by default, so editing a file after
git addand then committing runs the hook against the OLD content. Use--all-filesin CI to catch this. exclude:regex is anchored differently thanfiles:—exclude: tests/does NOT excludetests/foo.pyin some hook versions; useexclude: ^tests/to be safe. Anchor everything.language: systemhooks bypass the pre-commit venv and rely on the user's PATH — works on your machine, fails in CI withcommand not found. Preferlanguage: pythonwithadditional_dependencies.pre-commit installdoesn't install forcommit-msgorpre-pushby default — separate--hook-typecalls needed. Many teams add commit-msg hooks then wonder why they don't fire.- Skipping a hook via
SKIP=hookid git commitis per-shell-invocation, not per-commit — CI runs with a fresh env where SKIP is unset and the hook fires anyway.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/julianobarbosa/claude-code-skills/pre-commit">View pre-commit on skillZs</a>