---

name: quality-gates description: Automated code quality validation with configurable checks version: 1.0.0

Quality Gates Skill

Automated code quality validation with configurable checks.

Description

This skill runs quality checks on code changes and reports results. It integrates with project-specific tooling and provides consistent validation across the siftcoder workflow.

When to Use

Invoke this skill when:

• Code has been written or modified
• Before marking a subtask as complete
• During QA review phase
• User requests manual quality check

Instructions

You are a quality gate runner. Your job is to validate code changes against project quality standards.

Quality Checks Available

1. Format Check

   • Prettier (JS/TS/JSON/MD/CSS)
   • Black (Python)
   • gofmt (Go)
   • rustfmt (Rust)

2. Lint Check

   • ESLint (JS/TS)
   • Flake8/Pylint (Python)
   • golangci-lint (Go)
   • Clippy (Rust)

3. Type Check

   • TypeScript (tsc)
   • mypy (Python)
   • Go compiler

4. Test Check

   • Jest/Vitest (JS/TS)
   • Pytest (Python)
   • go test (Go)
   • cargo test (Rust)

5. Security Check (if available)

   • npm audit
   • Semgrep
   • Bandit (Python)

Execution Flow

1. Detect Project Type

   Detecting project configuration...
   ├── package.json → Node.js project
   ├── tsconfig.json → TypeScript enabled
   ├── .prettierrc → Prettier configured
   └── jest.config.js → Jest for testing
   

2. Run Configured Checks

   🔍 QUALITY GATES
   
   [1/4] Format Check (Prettier)
         Running: npx prettier --check src/
         Result: ✓ All files formatted
   
   [2/4] Lint Check (ESLint)
         Running: npx eslint src/ --format json
         Result: ⚠️ 2 warnings, 0 errors
         - src/utils.ts:15 - Unused variable 'temp'
         - src/api.ts:42 - Prefer const over let
   
   [3/4] Type Check (TypeScript)
         Running: npx tsc --noEmit
         Result: ✓ No type errors
   
   [4/4] Test Check (Jest)
         Running: npx jest --passWithNoTests
         Result: ✓ 47 tests passing
   

3. Generate Report

   {
     "timestamp": "2026-01-10T15:30:00Z",
     "checks": {
       "format": { "status": "pass", "tool": "prettier" },
       "lint": {
         "status": "warn",
         "tool": "eslint",
         "warnings": 2,
         "errors": 0,
         "issues": [
           { "file": "src/utils.ts", "line": 15, "message": "Unused variable" }
         ]
       },
       "typeCheck": { "status": "pass", "tool": "tsc" },
       "tests": { "status": "pass", "tool": "jest", "passed": 47, "failed": 0 }
     },
     "summary": {
       "passed": 3,
       "warned": 1,
       "failed": 0,
       "blocked": false
     }
   }
   

Blocking vs Non-Blocking

Blocking (stops workflow):

• Any type errors
• Any lint errors (not warnings)
• Any test failures
• Security vulnerabilities (high/critical)

Non-Blocking (warns but continues):

• Format issues (auto-fixed when possible)
• Lint warnings
• Low/medium security issues

Auto-Fix Capabilities

When possible, automatically fix issues:

🔧 AUTO-FIX APPLIED

Format:
├── src/utils.ts - Reformatted
└── src/api.ts - Reformatted

Lint (auto-fixable):
└── src/config.ts - Fixed import order

Re-running checks after fixes...

Configuration Detection

The skill respects project configuration:

• .prettierrc / prettier.config.js
• .eslintrc / eslint.config.js
• tsconfig.json
• jest.config.js / vitest.config.ts
• pyproject.toml (for Python projects)

Per-Project Overrides

Read from .claude/siftcoder-state/config.json:

{
  "qualityGates": {
    "format": true,
    "lint": true,
    "typeCheck": true,
    "tests": true,
    "security": false,
    "blockOnWarnings": false
  }
}

Output Format

Return structured result:

{
  "passed": true|false,
  "blocked": true|false,
  "checks": { ... },
  "summary": "All quality gates passed" | "Blocked: 2 type errors",
  "autoFixed": ["file1.ts", "file2.ts"]
}

Runtime Implementation

This skill includes a minimal skill.ts entry point to satisfy plugin requirements. The primary value remains in this documentation - see sections above for:

• Quality gate patterns
• Configuration detection
• Auto-fix capabilities

The runtime entry point can be extended with actual functionality as needed.

Allowed Tools

Bash, Read, Glob