code-quality-gates

SKILL: Code Quality Gates

Purpose: Automated quality checks before/after code changes (PreToolUse, PostToolUse, Stop hooks converted to skill logic) Target: All agents making code changes

---

Quick Start

When to Use This Skill

• Before creating any .md files (documentation gate)
• After writing code (formatting, type check)
• Before completing work (final audit)

Quick Reference

# PreToolUse: Block .md creation
[[ "$file" == *.md ]] && echo "Use Write tool for .md" && return 1

# PostToolUse: Auto-format + type check
prettier --write "$file" && npx tsc --noEmit

# Stop: Console.log audit
grep -rn "console.log" src/ || true

---

Quality Gates

Gate 1: Documentation (PreToolUse)

Purpose: Block .md file creation via Bash

Apply: Before Bash commands

echo "$command" | grep -qiE '\.md' && echo "Use Write tool for .md" && return 1

Gate 2: Formatting (PostToolUse)

Purpose: Auto-format after code changes

Apply: After Edit/Write

format_code() {
  case "${1##*.}" in
    js|ts|tsx|json|css|md) prettier --write "$1" ;;
    py) black "$1" ;;
  esac
}

Gate 3: Type Safety (PostToolUse)

Purpose: Verify TypeScript type correctness

Apply: After .ts file changes

[ -f tsconfig.json ] && npx tsc --noEmit

Gate 4: Console Audit (Stop)

Purpose: Flag console.log before completion

Apply: Before work completion

find src -name "*.ts" -o -name "*.js" | xargs grep -n "console.log"

---

Integration Points

Hook	Function	Agent	Trigger
PreToolUse	Documentation gate	All	Before Bash
PostToolUse	Formatting	Coder	After Edit/Write
PostToolUse	Type check	Coder	After .ts changes
Stop	Console audit	Coder	Before completion

---

Verification

# Test all gates
echo "# Test" > test.md  # Should warn
echo "const x=1;" > test.js && prettier --write test.js  # Should format
echo "const x: string = 1;" > test.ts && npx tsc --noEmit  # Should error
grep -rn "console.log" src/  # Should find logs