playbooks

home / skills / openclaw / skills / husky-gen

husky-gen skill

/skills/lxgicstudios/husky-gen

This skill generates and configures git hooks automatically for your project, ensuring fast, reliable pre-commit, pre-push, and commit-msg workflows.

npx playbooks add skill openclaw/skills --skill husky-gen

Review the files below or copy the command above to add this skill to your agents.

Files (12)
SKILL.md
1.8 KB
---
name: husky-gen
description: Set up git hooks tailored to your project. Use when adding pre-commit hooks.
---

# Husky Generator

Git hooks are powerful but setting them up is a pain. This tool analyzes your project and creates the right hooks for your workflow.

**One command. Zero config. Just works.**

## Quick Start

```bash
npx ai-husky
```

## What It Does

- Installs and configures Husky
- Creates pre-commit hooks for linting staged files
- Sets up pre-push hooks for running tests
- Adds commit-msg hook for conventional commits

## Usage Examples

```bash
# Install git hooks
npx ai-husky

# Preview without installing
npx ai-husky --dry-run
```

## Best Practices

- **Lint staged files only** - don't lint the whole codebase
- **Run tests on push** - catch issues before PR
- **Keep hooks fast** - slow hooks get bypassed
- **Make them skippable** - --no-verify for emergencies

## When to Use This

- Setting up a new project with git hooks
- Adding code quality checks to existing project
- Enforcing commit message format
- Standardizing pre-commit workflow

## Part of the LXGIC Dev Toolkit

This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.

**Find more:**
- GitHub: https://github.com/LXGIC-Studios
- Twitter: https://x.com/lxgicstudios
- Substack: https://lxgicstudios.substack.com
- Website: https://lxgic.dev

## Requirements

No install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAI_API_KEY environment variable.

```bash
npx ai-husky --help
```

## How It Works

Analyzes your package.json to determine what linters, formatters, and test runners you use. Then generates appropriate Husky hooks that run the right commands at the right times.

## License

MIT. Free forever. Use it however you want.

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

FAQ

Do I need to install anything to use this skill?

No global install is required; run npx ai-husky. Node.js 18+ is recommended and an OPENAI_API_KEY environment variable may be required for some analysis features.

Can I preview changes before they are applied?

Yes. Use npx ai-husky --dry-run to see the hooks and commands it will add without modifying your repo.

Will it slow down my workflow?

It aims to keep hooks fast by linting staged files and running lightweight checks locally while running heavier test suites on pre-push.