SKILL.md
Run Quality Gate
Execute validation commands as quality gates with structured error reporting.
When to Use
- Type-check, build, test, lint validation
- Orchestrator phase validation
- Worker self-validation
Input
{
"gate": "type-check|build|tests|lint|custom",
"blocking": true,
"custom_command": "pnpm custom-validate"
}Gate Commands
| Gate | Command |
|---|---|
| type-check | pnpm type-check |
| build | pnpm build |
| tests | pnpm test |
| lint | pnpm lint |
| custom | custom_command value |
Process
- Map gate to command - Validate custom_command if gate="custom"
- Execute via Bash - Timeout: 5 minutes, capture stdout/stderr
- Parse result - Exit code 0 = passed, non-zero = failed
- Extract errors - Lines with "error", "failed", TS#### codes
- Determine action:
- Passed → action="continue" - Failed + blocking → action="stop" - Failed + non-blocking → action="warn"
Output
{
"gate": "type-check",
"passed": true,
"blocking": true,
"action": "continue",
"errors": [],
"exit_code": 0,
"duration_ms": 2345,
"command": "pnpm type-check",
"timestamp": "2025-10-18T14:30:00Z"
}Examples
Blocking gate passes:
{ "gate": "type-check", "blocking": true }
→ { "passed": true, "action": "continue", "errors": [] }Blocking gate fails (stops workflow):
{ "gate": "build", "blocking": true }
→ { "passed": false, "action": "stop", "errors": ["Module not found: missing-module"] }Non-blocking gate fails (warns only):
{ "gate": "lint", "blocking": false }
→ { "passed": false, "action": "warn", "errors": ["Missing semicolon"] }Error Handling
- Timeout (5 min): Return failed with timeout error
- Missing custom_command: Return error
- Command not found: Return failed with exit_code=127
Notes
- Exit code 0 always = success regardless of output
- Blocking flag only affects action, not passed status
- Error extraction is best-effort