julianobarbosa

PreCommit

7
0
# Install this skill:
npx skills add julianobarbosa/claude-code-skills --skill "PreCommit"

Install specific skill from multi-skill repository

# Description

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.

# SKILL.md


name: PreCommit
description: 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.


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

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.