vastai-host-mcp: Skill for Claude Code

---

name: pre-commit description: Guide for using pre-commit hooks to validate code formatting, linting, and security checks before commits. license: MIT

Expert guide for pre-commit framework usage, configuration, and custom hook development. Focus on autonomous validation, diagnostics, and fix workflows.

Core Principles

• Staged files only: Pre-commit runs exclusively on staged (cached) files, not the entire working directory.
• Fast feedback: Catch issues before commit/push to reduce CI failures and review cycles.
• Configuration-driven: Hooks reference external config files (.yamllint, .markdownlint.yaml, etc.) for consistency.
• Idempotent fixes: Many hooks auto-fix issues (e.g., trailing-whitespace, end-of-file-fixer); re-stage and re-run to pass.
• Skip only when necessary: Use --no-verify or SKIP=<hook-id> sparingly; prefer fixing issues over bypassing validation.

Testing Commands

Run all hooks on all files (recommended before committing):

pre-commit run --all-files

Run all hooks on staged files only (default behavior):

pre-commit run

Run specific hook on all files:

pre-commit run <hook-id> --all-files

Run specific hook on staged files:

pre-commit run <hook-id>

Examples for individual linters:

pre-commit run yamllint --all-files          # YAML linting
pre-commit run markdownlint --all-files      # Markdown linting
pre-commit run flake8 --all-files            # Python linting
pre-commit run black --all-files             # Python formatting
pre-commit run ansible-lint --all-files      # Ansible linting
pre-commit run actionlint --all-files        # GitHub Actions workflow linting
pre-commit run gitleaks --all-files          # Secret scanning
pre-commit run detect-secrets --all-files    # Alternative secret detection
pre-commit run trailing-whitespace -a        # Fix trailing spaces (auto-fix)
pre-commit run end-of-file-fixer -a          # Fix EOF newlines (auto-fix)