Collection

---
name: Quality Gate Skill
description: Comprehensive code quality verification workflow that checks linting, formatting, type safety, tests, and build before committing code. Uses parallel agent execution for maximum speed. Non-destructive - only reports issues without making changes.
trigger: manual
allowed-tools:
  - Bash
  - Read
  - Glob
  - Task
  - TaskOutput
---

# Purpose

Run comprehensive Quality Gate checks to verify code quality before committing. Uses parallel agent swarm execution for blazing-fast results. Non-destructive analysis only - reports issues without auto-fixing. Includes linting, formatting, type safety, tests, build verification, and security checks.

## Variables

ENABLE_JAVASCRIPT: true           # Enable JavaScript/TypeScript quality checks
ENABLE_PYTHON: true               # Enable Python quality checks
ENABLE_SECURITY_CHECK: true       # Enable security vulnerability scanning
ENABLE_PARALLEL_EXECUTION: true   # Use parallel agent swarm for faster execution
SUPPORTED_PROJECT_TYPES: javascript, typescript, python  # Currently supported project types

## Workflow

1. **Parse User Request**
   - Identify quality check intent
   - User triggers: "run quality gate", "quality check", "check quality before commit", "verify code quality"
   - Example: "run quality gate" → Intent: comprehensive quality checks

2. **Detect Project Type**
   - Check for indicator files: package.json (JS/TS), requirements.txt/pyproject.toml (Python)
   - Determines which cookbook workflow to use
   - Example: package.json found → JavaScript/TypeScript project

3. **Route to Cookbook**
   - Based on detected type and ENABLE flags
   - JavaScript/TypeScript: IF package.json AND ENABLE_JAVASCRIPT → javascript.md
   - Python: IF requirements.txt/pyproject.toml AND ENABLE_PYTHON → python.md
   - Generic: IF no match → Run basic checks available in project
   - Example: TypeScript project + ENABLE_JAVASCRIPT=true → Route to cookbook/javascript.md

4. **Execute Quality Checks**
   - IF: ENABLE_PARALLEL_EXECUTION is true → Launch parallel agent swarm for all checks
   - Run all check phases defined in cookbook (linting, formatting, type checking, tests, build, security)
   - Tool: Task with run_in_background: true for each independent check
   - IMPORTANT: Non-destructive - only report issues, never auto-fix
   - Continue on failure - run all phases even if some fail (get complete picture)
   - Example: Launch 6 parallel agents (Linter, Formatter, TypeChecker, Tester, Builder, Security) → All complete in ~15s vs ~60s sequential

5. **Generate Report**
   - IF parallel execution used → Collect all agent results using TaskOutput
   - Compile results from all phases
   - Include: specific file paths, line numbers when possible, error messages, actionable fix commands, performance comparison
   - Format: Clear sections per phase (✓ passed, ✗ failed), summary at end, execution time
   - Example: "Linting: ✗ 5 errors in src/utils.ts:23 - Run 'npm run lint:fix' | Performance: 75% faster (15s vs 60s)"

## Cookbook

### JavaScript/TypeScript Projects

- IF: The project has a `package.json` file AND `ENABLE_JAVASCRIPT` is true.
- THEN: Read and execute: `.claude/skills/quality-gate/cookbook/javascript.md`
- EXAMPLES:
  - "run quality gate"
  - "quality check"
  - "check quality before commit"
  - "run all checks"

### Python Projects

- IF: The project has `requirements.txt` or `pyproject.toml` AND `ENABLE_PYTHON` is true.
- THEN: Read and execute: `.claude/skills/quality-gate/cookbook/python.md`
- EXAMPLES:
  - "run quality gate"
  - "quality check"
  - "verify code quality"

### Generic Projects

- IF: No specific project type detected.
- THEN: Run basic checks available in the project and report.
- EXAMPLES:
  - "run quality gate"
  - "check what we can"