quality-checks

Files (2)

• SKILL.md
• run-quality-checks.sh · scripts/

SKILL.md (first lines)

# Quality Checks

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

## Quick Start

```bash
~/.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

| File           | Purpose                   | When to Read            |
| -------------- | ------------------------- | ----------------------- |
| `summary.txt`  | One-line status per check | Always (tiny)           |
| `failures.txt` | Extracted error details   | Only if failed          |
| `<check>.log`  | Full output               | Only for deep debugging |

## Usage Patterns

### Check current directory

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

### Check specific repo

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

### Custom output location

```bash
~/.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"

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

### Cache issues with oxlint/eslint

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

From DrJKL/ticket-to-pr-pipeline, MIT.

More from DrJKL/ticket-to-pr-pipeline