husky-gen_skill

Overview

This skill sets up project-specific Git hooks using Husky with one command and no manual configuration. It analyzes the project to generate pre-commit, pre-push, and commit-msg hooks tuned to your linters, formatters, and test runner. The tool works via npx so you can preview changes with a dry-run before installing. It targets fast, reliable hooks that improve code quality and enforce commit standards.

How this skill works

The generator inspects package.json (or equivalent config) to detect installed linters, formatters, and test scripts. It then writes Husky configuration and creates hooks that run linting on staged files, run tests on push, and validate commit messages for conventional commits. You can run npx ai-husky to install, or npx ai-husky --dry-run to preview proposed hooks.

When to use it

• Bootstrapping a new project with standardized Git hooks
• Adding pre-commit linting and formatting without manual setup
• Enforcing commit message conventions across a team
• Ensuring tests run before changes are pushed
• Quickly adopting Husky in legacy repositories

Best practices

• Lint staged files only to keep pre-commit hooks fast
• Run unit/integration tests on pre-push to avoid broken PRs
• Keep hook commands short and optimized to prevent bypassing
• Allow emergency bypass with --no-verify while tracking misuse
• Preview changes with --dry-run before applying them

Example use cases

• Install Husky hooks in a JavaScript project with ESLint and Prettier using npx ai-husky
• Add a commit-msg hook to enforce conventional commits on an existing repo
• Configure pre-push to run the test suite in CI-like environments
• Run ai-husky --dry-run to review proposed hook scripts before committing changes
• Standardize developer workflow across multiple repositories without manual hook files