husky-config-gen_skill

Overview

This skill sets up project-specific Git hooks using Husky with minimal friction. It inspects your repository, detects linters, formatters, and test runners, then generates sensible pre-commit, pre-push, and commit-msg hooks. One command installs and configures hooks tailored to your workflow so you get consistent checks without manual wiring.

How this skill works

The tool scans package.json and your codebase to identify installed tools (ESLint, Prettier, Jest, etc.). It then generates Husky configuration and hook scripts that run linting on staged files, run tests on push, and enforce conventional commit messages. Options include a dry-run preview and automatic installation using npx.

When to use it

• Initializing a new repo and wanting automated Git checks
• Adding pre-commit linting or formatting to an existing project
• Enforcing conventional commit messages across a team
• Standardizing pre-push test runs before opening pull requests
• Quickly generating Husky hooks without writing scripts manually

Best practices

• Lint only staged files to keep hooks fast and relevant
• Run tests on push rather than every commit to balance speed and safety
• Keep each hook lightweight so developers don’t bypass checks
• Allow emergency bypass with --no-verify, but document when it’s acceptable
• Use the dry-run option to preview changes before applying them

Example use cases

• Set up pre-commit ESLint and Prettier for a JavaScript project in one command
• Add a pre-push step to run unit tests on CI-like conditions locally
• Enforce conventional commit format with a commit-msg hook to enable changelog automation
• Migrate an older repository to Husky hooks without handcrafting scripts
• Preview the generated hook scripts with --dry-run before committing to the repo