Skip to content

jupes/agent-forge-harness / .claude/skills/setup-pre-commit

setup-pre-commit

Unverified

Configure repository-local Husky and lint-staged hooks. Use when adding staged formatting or commit-time checks to a repository.

setup-pre-commit

Inspect the target repository and configure the requested pre-commit checks. A request to install the setup authorizes routine file and dependency edits; an advice-only request ends with recommendations.

What this configures

  • Husky v9+ with a .husky/pre-commit hook
  • lint-staged running Prettier on staged files
  • Prettier defaults only when no Prettier config exists
  • Optional typecheck and test commands only when the target package.json already defines those scripts
  • Verification commands and a real commit smoke test when the user is ready to commit setup changes

1. Preflight the target repo

Work from the target repo root, then inspect existing package and config state before proposing commands:

git status --short
node -e "const fs=require('fs'); const p=JSON.parse(fs.readFileSync('package.json','utf8')); process.stdout.write(JSON.stringify({packageManager:p.packageManager||null,scripts:p.scripts||{}}, null, 2)+'\n');"
node -e "const fs=require('fs'); const files=['bun.lock','bun.lockb','pnpm-lock.yaml','yarn.lock','package-lock.json','.lintstagedrc','.lintstagedrc.json','.lintstagedrc.js','lint-staged.config.js','.prettierrc','.prettierrc.json','.prettierrc.js','prettier.config.js','prettier.config.cjs','prettier.config.mjs']; process.stdout.write(files.filter((f)=>fs.existsSync(f)).join('\n')+'\n');"

Preserve unrelated changes. Resolve the package manager and existing hook intent from repo guidance and CI; ask only when conflicting evidence prevents a safe configuration.

2. Detect the package manager

Prefer the packageManager field in package.json, then lockfiles:

SignalPackage manager
packageManager starts with bun or bun.lock / bun.lockb existsBun
packageManager starts with pnpm or pnpm-lock.yaml existspnpm
packageManager starts with yarn or yarn.lock existsYarn
packageManager starts with npm or package-lock.json existsnpm

If there is no clear signal, default to npm only after telling the user that no lockfile or package-manager pin was found.

3. Install dev dependencies

Use exactly one command for the detected package manager:

Package managerCommand
Bunbun add --dev husky lint-staged prettier
pnpmpnpm add --save-dev husky lint-staged prettier
Yarnyarn add --dev husky lint-staged prettier --non-interactive
npmnpm install --save-dev husky lint-staged prettier --yes

Do not run these commands while porting this skill. Run them only when applying the skill to a target repo with user approval.

4. Initialize Husky

After dependencies are installed, initialize Husky with the detected package manager:

Package managerCommand
Bunbunx --bun husky init
pnpmpnpm exec husky init
Yarnyarn exec husky init
npmnpx --yes husky init

Husky v9+ creates .husky/pre-commit and usually adds prepare: "husky" to package.json. Preserve an existing prepare script by combining commands only if the user approves the exact package script change.

5. Compose .husky/pre-commit

The hook must run lint-staged first, then only the package scripts that already exist. Do not add failing placeholder lines for missing scripts.

Package managerlint-staged lineExisting typecheck scriptExisting test script
Bunbunx --bun lint-stagedbun run typecheckbun run test
pnpmpnpm exec lint-stagedpnpm run typecheckpnpm run test
Yarnyarn exec lint-stagedyarn run typecheckyarn run test
npmnpx --no-install lint-stagednpm run typechecknpm run test

Example for a Bun repo that has both scripts:

set -e
bunx --bun lint-staged
bun run typecheck
bun run test

If the repo lacks typecheck or test, omit that line and tell the user which check was skipped.

6. Configure lint-staged and Prettier

Respect existing config:

  1. If a lint-staged config already exists, update it only after confirming it should run Prettier on staged files.
  2. If no lint-staged config exists, add one config location that matches repo style. Prefer an existing package.json config style if the repo already keeps tool config there; otherwise use .lintstagedrc.json.
  3. Use this minimal lint-staged config:
{
  "*": "prettier --ignore-unknown --write"
}
  1. If any Prettier config exists, do not overwrite it.
  2. If no Prettier config exists, propose these defaults:
{
  "useTabs": false,
  "tabWidth": 2,
  "printWidth": 80,
  "singleQuote": false,
  "trailingComma": "es5",
  "semi": true,
  "arrowParens": "always"
}

prettier --ignore-unknown lets staged binary or unsupported files pass without parse failures.

7. Verify

Run only commands that match the detected package manager and existing scripts:

git status --short
  • Confirm .husky/pre-commit exists and contains the selected lint-staged line.
  • Confirm package.json has a valid Husky prepare script without clobbering previous behavior.
  • Confirm lint-staged config exists and Prettier config is preserved or created intentionally.
  • Run the selected lint-staged command with staged setup files.
  • Run the selected typecheck/test commands only if those scripts exist.

8. Smoke test with a real commit

When the user is ready to commit the setup, use the normal commit as the smoke test:

git add package.json .husky/pre-commit .lintstagedrc.json .prettierrc
git commit -m "chore: add pre-commit checks"

Adjust the git add paths to the files actually changed. Do not create an empty or throwaway commit just to test the hook, and do not run a commit smoke test unless the user explicitly wants the setup committed.

receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementationStars: 318kUpdated Claude CodeCodexUnverifiedInstall
requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirementsStars: 318kUpdated Claude CodeCodexUnverifiedInstall
using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallbackStars: 318kUpdated Claude CodeCodexUnverifiedInstall
verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions alwaysStars: 318kUpdated Claude CodeCodexUnverifiedInstall