claude-pilot: Skill for Claude Code

SKILL: Quality Gates

Purpose: Pre-commit quality validation procedures (type-check, lint, todos, branch guard) Target: Coder Agent, pre-commit hooks, CI/CD pipelines

---

Quick Start

When to Use This Skill

• Before committing code (pre-commit hooks)
• Validating code quality in CI/CD
• Ensuring all todos complete before commit
• Preventing commits to protected branches

Quick Reference

# Type check validation
npm run type-check  # or: tsc --noEmit

# Lint validation
npm run lint  # or: eslint . --ext .ts,.tsx

# Todo validation
/03_close  # Validates all SCs complete before closing plan

# Branch guard (Git native)
git config --global receive.denyDeleteCurrent warn

Core Concepts

Quality Gates Philosophy

Pre-commit hooks enforce quality standards before code enters the repository.

Skills as procedures, hooks as automation:

• Skills document the what and how (this file)
• Hooks execute the procedures automatically
• CI provides fallback enforcement
• Developer autonomy preserved (opt-in hooks)

Why Opt-In Hooks?

• Mandatory hooks improve baseline quality but create friction
• Skills + CI yields consistent enforcement while preserving autonomy
• Developers can choose strictness level (off/stop/strict profile)

Procedures

Type Check Validation

Command: tsc --noEmit or npm run type-check

Output: Success (exit 0) | Type errors with file/line (exit 1)

Example Failure: src/auth/login.ts:15:11 - error TS2345: Argument of type 'string' is not assignable to parameter of type 'number'.

Lint Validation

Command: npx eslint . --ext .ts,.tsx or npm run lint

Output: Success (exit 0) | Lint errors with file/line/rule (exit 1)

Example Failure: src/utils/format.ts:42:5 error Unused vars no-unused-vars

Todo Validation

Command: /03_close

Steps: Read plan → Check all SCs [x] → Verify evidence → Block if incomplete

Example Block: ⚠️ Incomplete SCs detected: - [ ] SC-3: Add unit tests (evidence missing)