Quality Checks

Run all quality gates with a single command. Outputs structured results optimized for agent consumption.

Quick Start

~/.claude/skills/quality-checks/scripts/run-quality-checks.sh /path/to/repo

The script handles:

• Node version detection and switching (nvm/fnm)
• Dependency installation if needed
• Running format → lint → typecheck in order
• Structured output to /tmp/quality-checks/

Output Structure

Usage Patterns

Check current directory

~/.claude/skills/quality-checks/scripts/run-quality-checks.sh

Check specific repo

~/.claude/skills/quality-checks/scripts/run-quality-checks.sh ~/repos/my-project

Custom output location

~/.claude/skills/quality-checks/scripts/run-quality-checks.sh ~/repos/my-project /tmp/my-checks

Exit Codes

• 0 - All checks passed
• 1 - One or more checks failed (details in failures.txt)

What It Runs

1. format - pnpm format (oxfmt auto-fix)
2. lint - pnpm lint:fix (oxlint + eslint with fixes)
3. typecheck - pnpm typecheck (vue-tsc)

Environment Handling

The script automatically:

• Detects nvm or fnm and uses .nvmrc version
• Installs Node version if missing
• Runs pnpm install if node_modules outdated
• Works from any directory (runs commands in repo context)

Troubleshooting

"No Node.js found"

Install nvm: curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

"Failed to use Node X"

source ~/.nvm/nvm.sh && nvm install 24

Cache issues with oxlint/eslint

The script runs from the repo directory, so caches work correctly.