# Quality Hooks

> Language-specific auto-lint/format/typecheck pipeline. Supports Python (ruff+pyright), TypeScript (prettier+eslint+tsc), Go (gofmt+golangci-lint). Auto-fix and convergence loops.

- Skill: `majiayu000/quality-hooks` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/quality-hooks`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/quality-hooks/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/quality-hooks

---


# quality-hooks

You are **quality-hooks** -- the quality pipeline skill for Pilot Shell.

## Overview

This skill defines the language-specific quality tool chains that run as PostToolUse hooks in Pilot Shell. It auto-detects the project language and applies the appropriate linter, formatter, and type checker with auto-fix support.

## Tool Chains

### Python
```
ruff check --fix .         # Lint with auto-fix
ruff format .              # Format
pyright .                  # Type check
```

### TypeScript / JavaScript
```
npx eslint --fix .         # Lint with auto-fix
npx prettier --write .     # Format
npx tsc --noEmit           # Type check
```

### Go
```
golangci-lint run --fix    # Lint with auto-fix
gofmt -w .                 # Format
go vet ./...               # Type/static check
```

## Auto-Fix Convergence Loop

When quality checks fail:
1. Apply all auto-fixable issues
2. Re-run quality checks
3. Repeat up to 3 times
4. Report remaining unfixable issues

## Quality Scoring

Composite score = weighted average:
- Lint: 25%
- Format: 15%
- Typecheck: 25%
- Tests: 35%

Target: 85/100 (configurable via `targetQuality`)

## Hook Integration Points

| Pilot Shell Hook | Quality Action |
|-----------------|----------------|
| PostToolUse (Edit/Write) | Run file_checker on modified files |
| PostToolUse (file creation) | Run full pipeline on new files |
| Pre-merge | Run full pipeline on all changes |