How do I install the Pre Commit Checks skill?

Run npx skillmds@latest add tomevault-io/pre-commit-checks in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Pre Commit Checks safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Pre Commit Checks?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Pre Commit Checks free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Pre Commit Checks?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Pre Commit Checks by tomevault-io — Agent Skill

Name: Pre Commit Checks
Author: tomevault-io

File contents

Pre-Commit Quality Checks

The pre-commit hook uses lint-staged for performance, running checks only on staged files. All must pass for a commit to proceed.

Checks

1. Formatting and Linting (lint-staged)

./node_modules/.bin/lint-staged

Configuration in package.json under "lint-staged":

JS/TS files: prettier --write → eslint --fix
Other files: prettier --write

Runs only on staged files for maximum performance.

2. Type Checking (TypeScript)

npx tsc --noEmit

Runs on the full project (fast enough, ensures project-wide type safety). No auto-fix — type errors must be resolved manually.

3. Unit Tests (Vitest)

./node_modules/.bin/vitest related --run $(git diff --name-only --cached)

Runs tests only for files related to staged changes using Vitest's "related" mode.

Guarantee

If pre-commit passes locally, CI must be green. If this guarantee is ever broken, it is a bug in the pipeline and must be fixed immediately.

Key Benefits

Performance: Only processes staged files for formatting/linting
Stability: Uses local paths (./node_modules/.bin/) instead of npx to avoid $PATH issues
Smart testing: Vitest "related" mode runs only tests affected by your changes
Auto-fix: Prettier and ESLint automatically fix issues when possible

Troubleshooting

lint-staged fails: Check the output for specific Prettier or ESLint errors. Most issues are auto-fixed; remaining issues need manual correction.
TypeScript fails: Read the type error carefully. Do not use // @ts-ignore or any to suppress.
Tests fail: Run npx vitest interactively to debug. The hook only tests files related to your changes.
Hook not running: Ensure .husky/pre-commit is executable: chmod +x .husky/pre-commit
lint-staged not found: Run npm install to install dependencies.

Manual Check Commands

To run checks manually before committing:

# Format all files
npm run format

# Lint all files
npm run lint

# Type check
npm run typecheck

# Run full test suite
npm test

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: pre-commit-checksdescription: Run and troubleshoot the pre-commit hook quality checks. Use when commits fail, when adding new checks, or when verifying code quality locally. Use when this capability is needed.---# Pre-Commit Quality ChecksThe pre-commit hook uses **lint-staged** for performance, running checks only on staged files. All must pass for a commit to proceed.## Checks### 1. Formatting and Linting (lint-staged)```bash./node_modules/.bin/lint-staged```Configuration in `package.json` under `"lint-staged"`:- **JS/TS files**: `prettier --write` → `eslint --fix`- **Other files**: `prettier --write`**Runs only on staged files** for maximum performance.### 2. Type Checking (TypeScript)```bashnpx tsc --noEmit```Runs on the full project (fast enough, ensures project-wide type safety). No auto-fix — type errors must be resolved manually.### 3. Unit Tests (Vitest)```bash./node_modules/.bin/vitest related --run $(git diff --name-only --cached)```Runs tests **only for files related to staged changes** using Vitest's "related" mode.## Guarantee**If pre-commit passes locally, CI must be green.** If this guarantee is ever broken, it is a bug in the pipeline and must be fixed immediately.## Key Benefits- **Performance**: Only processes staged files for formatting/linting- **Stability**: Uses local paths (`./node_modules/.bin/`) instead of `npx` to avoid $PATH issues- **Smart testing**: Vitest "related" mode runs only tests affected by your changes- **Auto-fix**: Prettier and ESLint automatically fix issues when possible## Troubleshooting- **lint-staged fails**: Check the output for specific Prettier or ESLint errors. Most issues are auto-fixed; remaining issues need manual correction.- **TypeScript fails**: Read the type error carefully. Do not use `// @ts-ignore` or `any` to suppress.- **Tests fail**: Run `npx vitest` interactively to debug. The hook only tests files related to your changes.- **Hook not running**: Ensure `.husky/pre-commit` is executable: `chmod +x .husky/pre-commit`- **lint-staged not found**: Run `npm install` to install dependencies.## Manual Check CommandsTo run checks manually before committing:```bash# Format all filesnpm run format# Lint all filesnpm run lint# Type checknpm run typecheck# Run full test suitenpm test```---> Converted and distributed by [TomeVault](https://tomevault.io/claim/kabaka) — claim your Tome and manage your conversions.

Frequently asked questions

Pre Commit Checks