--- name: mattpocock-setup-pre-commit description: "Set up Husky and lint-staged." license: MIT metadata: source: mattpocock/skills source-commit: 4ae2317ddb22b046e26455e4f9c9b3aaaf62212d upstream-name: setup-pre-commit upstream-status: published adaptation: namespaced-port --- ## Skillz integration This is Matt Pocock's version. Skill references use the `mattpocock-` prefix. Read a referenced skill's `SKILL.md` through the host's skill loader or file tools. Map AskUserQuestion to the host's question tool and shell examples to its shell. Use delegation only when available and permitted by the active instructions; otherwise perform the same work sequentially and report that limit. The user's scope and repository rules govern setup, file writes, tracker changes, messages, schedules, publishing, merging, and cleanup. A skill invocation alone does not broaden the user's request. Preserve existing work and configuration. Verify provider examples against current primary documentation before use. Reuse existing hooks and formatters. Merge package scripts and staged-file rules without replacing unrelated checks. Use the repository's package manager and scope staging to this task. # Setup Pre-Commit Hooks ## What This Sets Up - **Husky** pre-commit hook - **lint-staged** running Prettier on all staged files - **Prettier** config (if missing) - **typecheck** and **test** scripts in the pre-commit hook ## Steps ### 1. Detect package manager Check for `package-lock.json` (npm), `pnpm-lock.yaml` (pnpm), `yarn.lock` (yarn), `bun.lockb` (bun). Use whichever is present. Default to npm if unclear. ### 2. Install dependencies Install as devDependencies: ``` husky lint-staged prettier ``` ### 3. Initialize Husky ```bash npx husky init ``` This creates `.husky/` dir and adds `prepare: "husky"` to package.json. ### 4. Create `.husky/pre-commit` Write this file (no shebang needed for Husky v9+): ``` npx lint-staged npm run typecheck npm run test ``` **Adapt**: Replace `npm` with detected package manager. If repo has no `typecheck` or `test` script in package.json, omit those lines and tell the user. ### 5. Create `.lintstagedrc` ```json { "*": "prettier --ignore-unknown --write" } ``` ### 6. Create `.prettierrc` (if missing) Only create if no Prettier config exists. Use these defaults: ```json { "useTabs": false, "tabWidth": 2, "printWidth": 80, "singleQuote": false, "trailingComma": "es5", "semi": true, "arrowParens": "always" } ``` ### 7. Verify - [ ] `.husky/pre-commit` exists and is executable - [ ] `.lintstagedrc` exists - [ ] `prepare` script in package.json is `"husky"` - [ ] `prettier` config exists - [ ] Run `npx lint-staged` to verify it works ### 8. Commit Stage all changed/created files and commit with message: `Add pre-commit hooks (husky + lint-staged + prettier)` This will run through the new pre-commit hooks: a good smoke test that everything works. ## Notes - Husky v9+ doesn't need shebangs in hook files - `prettier --ignore-unknown` skips files Prettier can't parse (images, etc.) - The pre-commit runs lint-staged first (fast, staged-only), then full typecheck and tests