agentic-qe 3.4.0 → 3.4.2

package/v3/assets/skills/mutation-testing/test-data/sample-output.json

@@ -0,0 +1,295 @@
+{
+  "skillName": "mutation-testing",
+  "version": "1.0.0",
+  "timestamp": "2026-02-02T12:00:00Z",
+  "status": "success",
+  "trustTier": 3,
+  "output": {
+    "summary": "Mutation testing completed for src/auth module. Generated 150 mutants across 8 files. Test suite killed 127 mutants (84.7% mutation score). Identified 5 weak tests requiring boundary value improvements.",
+    "mutationScore": {
+      "score": 84.67,
+      "killed": 127,
+      "survived": 18,
+      "timeout": 3,
+      "noCoverage": 1,
+      "equivalent": 1,
+      "total": 150,
+      "grade": "B",
+      "threshold": {
+        "target": 80,
+        "met": true
+      },
+      "trend": "improving"
+    },
+    "mutants": {
+      "total": 150,
+      "byStatus": {
+        "killed": 127,
+        "survived": 18,
+        "timeout": 3,
+        "noCoverage": 1,
+        "equivalent": 1,
+        "runtimeError": 0,
+        "compileError": 0
+      },
+      "byOperator": {
+        "AOR": 25,
+        "ROR": 45,
+        "LCR": 30,
+        "COR": 28,
+        "RVR": 22
+      }
+    },
+    "survivors": [
+      {
+        "id": "MUT-001",
+        "operator": "ROR",
+        "operatorDescription": "Relational Operator Replacement (>= to >)",
+        "location": {
+          "file": "src/auth/validator.ts",
+          "line": 45,
+          "column": 12,
+          "function": "validateAge"
+        },
+        "original": "if (age >= 18)",
+        "mutated": "if (age > 18)",
+        "impact": "high",
+        "impactDescription": "Edge case at exactly 18 years old would incorrectly fail validation",
+        "suggestedTest": "test('should validate user exactly 18 years old', () => { expect(validateAge(18)).toBe(true); });",
+        "relatedTests": ["should validate adult", "should reject minor"],
+        "equivalentSuspect": false
+      },
+      {
+        "id": "MUT-002",
+        "operator": "LCR",
+        "operatorDescription": "Logical Connector Replacement (&& to ||)",
+        "location": {
+          "file": "src/auth/permissions.ts",
+          "line": 28,
+          "column": 8,
+          "function": "canAccess"
+        },
+        "original": "isAdmin && hasPermission",
+        "mutated": "isAdmin || hasPermission",
+        "impact": "critical",
+        "impactDescription": "Would allow unauthorized access if only one condition is true",
+        "suggestedTest": "test('should deny access when only admin flag is set', () => { expect(canAccess({ isAdmin: true, hasPermission: false })).toBe(false); });",
+        "relatedTests": ["should allow admin access"],
+        "equivalentSuspect": false
+      },
+      {
+        "id": "MUT-003",
+        "operator": "conditional",
+        "operatorDescription": "Conditional boundary mutation",
+        "location": {
+          "file": "src/auth/session.ts",
+          "line": 67,
+          "column": 6,
+          "function": "isSessionValid"
+        },
+        "original": "if (expiresAt > now)",
+        "mutated": "if (expiresAt >= now)",
+        "impact": "medium",
+        "impactDescription": "Session might be considered valid at exact expiration moment",
+        "suggestedTest": "test('should invalidate session at exact expiration time', () => { const now = Date.now(); expect(isSessionValid({ expiresAt: now })).toBe(false); });",
+        "relatedTests": ["should validate active session"],
+        "equivalentSuspect": false
+      }
+    ],
+    "operatorBreakdown": [
+      {
+        "operator": "AOR",
+        "operatorCategory": "arithmetic",
+        "total": 25,
+        "killed": 24,
+        "survived": 1,
+        "score": 96.0
+      },
+      {
+        "operator": "ROR",
+        "operatorCategory": "relational",
+        "total": 45,
+        "killed": 36,
+        "survived": 8,
+        "score": 80.0
+      },
+      {
+        "operator": "LCR",
+        "operatorCategory": "logical",
+        "total": 30,
+        "killed": 25,
+        "survived": 5,
+        "score": 83.3
+      },
+      {
+        "operator": "COR",
+        "operatorCategory": "conditional",
+        "total": 28,
+        "killed": 24,
+        "survived": 3,
+        "score": 85.7
+      },
+      {
+        "operator": "RVR",
+        "operatorCategory": "return",
+        "total": 22,
+        "killed": 18,
+        "survived": 1,
+        "score": 81.8
+      }
+    ],
+    "fileBreakdown": [
+      {
+        "file": "src/auth/validator.ts",
+        "total": 35,
+        "killed": 28,
+        "survived": 6,
+        "score": 80.0,
+        "priority": "high"
+      },
+      {
+        "file": "src/auth/permissions.ts",
+        "total": 28,
+        "killed": 22,
+        "survived": 5,
+        "score": 78.6,
+        "priority": "high"
+      },
+      {
+        "file": "src/auth/session.ts",
+        "total": 25,
+        "killed": 21,
+        "survived": 3,
+        "score": 84.0,
+        "priority": "medium"
+      }
+    ],
+    "weakTests": [
+      {
+        "testFile": "tests/auth/validator.test.ts",
+        "mutantsNotKilled": 6,
+        "priority": "high",
+        "reason": "Missing boundary value tests for age validation",
+        "suggestions": [
+          "Add test for exactly 18 years old",
+          "Add test for age = 0",
+          "Add test for maximum age boundary"
+        ]
+      },
+      {
+        "testFile": "tests/auth/permissions.test.ts",
+        "mutantsNotKilled": 5,
+        "priority": "high",
+        "reason": "Incomplete logical condition coverage",
+        "suggestions": [
+          "Test all combinations of admin and permission flags",
+          "Add negative tests for partial conditions"
+        ]
+      },
+      {
+        "testFile": "tests/auth/session.test.ts",
+        "mutantsNotKilled": 3,
+        "priority": "medium",
+        "reason": "Missing exact boundary tests for session expiration",
+        "suggestions": [
+          "Test session validity at exact expiration time"
+        ]
+      }
+    ],
+    "recommendations": [
+      {
+        "id": "REC-001",
+        "title": "Add boundary value tests for age validation",
+        "description": "The validator.ts file has multiple surviving relational operator mutations. Add tests for exact boundary values (18, 0, max age).",
+        "priority": "high",
+        "effort": "low",
+        "impact": 8,
+        "relatedMutants": ["MUT-001"],
+        "codeExample": "test('should validate exact boundary ages', () => {\n  expect(validateAge(18)).toBe(true);\n  expect(validateAge(17)).toBe(false);\n});",
+        "targetFile": "tests/auth/validator.test.ts"
+      },
+      {
+        "id": "REC-002",
+        "title": "Add combinatorial tests for permission logic",
+        "description": "The permissions.ts file has surviving logical operator mutations. Test all combinations of boolean conditions.",
+        "priority": "critical",
+        "effort": "medium",
+        "impact": 9,
+        "relatedMutants": ["MUT-002"],
+        "targetFile": "tests/auth/permissions.test.ts"
+      },
+      {
+        "id": "REC-003",
+        "title": "Add session expiration edge case tests",
+        "description": "Test session validity at the exact moment of expiration.",
+        "priority": "medium",
+        "effort": "low",
+        "impact": 6,
+        "relatedMutants": ["MUT-003"],
+        "targetFile": "tests/auth/session.test.ts"
+      }
+    ],
+    "metrics": {
+      "coverageCorrelation": 0.72,
+      "assertionDensity": 3.2,
+      "testEfficiency": 89.5,
+      "avgMutantsPerFile": 18.75,
+      "avgTimePerMutant": 245,
+      "parallelWorkers": 8
+    },
+    "testSuiteEffectiveness": {
+      "overallRating": "good",
+      "strengthAreas": [
+        "Good arithmetic operator coverage",
+        "Strong return value testing"
+      ],
+      "weaknessAreas": [
+        "Boundary value testing needs improvement",
+        "Logical condition combinations incomplete"
+      ],
+      "boundaryTesting": 72,
+      "conditionCoverage": 78,
+      "errorHandling": 85
+    },
+    "artifacts": [
+      {
+        "type": "report",
+        "path": "reports/mutation/mutation-report.html",
+        "format": "html",
+        "description": "Interactive HTML mutation testing report",
+        "sizeBytes": 245678
+      },
+      {
+        "type": "data",
+        "path": "reports/mutation/mutation-results.json",
+        "format": "json",
+        "description": "Raw mutation testing data",
+        "sizeBytes": 89234
+      }
+    ]
+  },
+  "metadata": {
+    "executionTimeMs": 125430,
+    "toolsUsed": ["stryker"],
+    "agentId": "qe-mutation-tester",
+    "modelUsed": "claude-3.5-sonnet",
+    "targetPath": "src/auth",
+    "testPath": "tests/auth",
+    "incremental": false,
+    "changedLinesOnly": false
+  },
+  "validation": {
+    "schemaValid": true,
+    "contentValid": true,
+    "confidence": 0.92,
+    "warnings": []
+  },
+  "learning": {
+    "patternsDetected": [
+      "boundary-value-weakness",
+      "logical-condition-gaps",
+      "high-arithmetic-coverage"
+    ],
+    "reward": 0.85
+  }
+}

package/v3/assets/skills/n8n-expression-testing/scripts/validate.sh

@@ -0,0 +1,162 @@
+#!/bin/bash
+# =============================================================================
+# AQE Skill Validator: n8n-expression-testing v1.0.0
+# Validates n8n expression testing skill output per ADR-056
+# =============================================================================
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SKILL_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+PROJECT_ROOT="$(cd "$SKILL_DIR/../../.." && pwd)"
+
+# Source validator library
+for lib_path in \
+  "$PROJECT_ROOT/.claude/skills/.validation/templates/validator-lib.sh" \
+  "$SKILL_DIR/scripts/validator-lib.sh"; do
+  if [[ -f "$lib_path" ]]; then
+    source "$lib_path"
+    break
+  fi
+done
+
+SKILL_NAME="n8n-expression-testing"
+SKILL_VERSION="1.0.0"
+REQUIRED_TOOLS=("jq")
+OPTIONAL_TOOLS=("node")
+SCHEMA_PATH="$SKILL_DIR/schemas/output.json"
+
+REQUIRED_FIELDS=("skillName" "status" "output" "output.summary" "output.expressionResults" "output.nodeTests")
+REQUIRED_NON_EMPTY_FIELDS=("output.summary")
+MUST_CONTAIN_TERMS=("expression" "n8n")
+MUST_NOT_CONTAIN_TERMS=("TODO" "FIXME" "placeholder")
+ENUM_VALIDATIONS=(".status:success,partial,failed,skipped")
+
+# N8N Expression-specific validation
+validate_skill_specific() {
+  local output_file="$1"
+  local has_errors=false
+
+  # Validate expression results have required structure
+  local expr_count
+  expr_count=$(jq '.output.expressionResults | length' "$output_file" 2>/dev/null || echo "0")
+
+  if [[ "$expr_count" -gt 0 ]]; then
+    # Check expression result structure
+    local invalid_exprs
+    invalid_exprs=$(jq '[.output.expressionResults[]? | select(.id == null or .expression == null or .status == null)] | length' "$output_file" 2>/dev/null || echo "0")
+
+    if [[ "$invalid_exprs" -gt 0 ]]; then
+      warn "$invalid_exprs expression result(s) missing required fields (id, expression, status)"
+    fi
+
+    # Validate expression IDs follow pattern
+    local invalid_ids
+    invalid_ids=$(jq '[.output.expressionResults[]?.id // empty | select(test("^EXPR-[0-9]{3,6}$") | not)] | length' "$output_file" 2>/dev/null || echo "0")
+
+    if [[ "$invalid_ids" -gt 0 ]]; then
+      warn "$invalid_ids expression(s) have invalid ID format (should be EXPR-NNN)"
+    fi
+
+    # Validate expression status values
+    local valid_statuses="valid invalid warning error"
+    local statuses
+    statuses=$(jq -r '.output.expressionResults[]?.status // empty' "$output_file" 2>/dev/null || true)
+
+    for status in $statuses; do
+      if ! echo "$valid_statuses" | grep -qw "$status"; then
+        error "Invalid expression status: $status"
+        has_errors=true
+      fi
+    done
+  fi
+
+  # Validate node tests
+  local node_count
+  node_count=$(jq '.output.nodeTests | length' "$output_file" 2>/dev/null || echo "0")
+
+  if [[ "$node_count" -gt 0 ]]; then
+    local invalid_nodes
+    invalid_nodes=$(jq '[.output.nodeTests[]? | select(.nodeId == null or .nodeName == null or .nodeType == null)] | length' "$output_file" 2>/dev/null || echo "0")
+
+    if [[ "$invalid_nodes" -gt 0 ]]; then
+      warn "$invalid_nodes node test(s) missing required fields"
+    fi
+  fi
+
+  # Validate workflow validation if present
+  local has_workflow
+  has_workflow=$(jq 'has("output") and (.output | has("workflowValidation"))' "$output_file" 2>/dev/null)
+
+  if [[ "$has_workflow" == "true" ]]; then
+    local wf_valid
+    wf_valid=$(jq '.output.workflowValidation | has("workflowId") and has("valid")' "$output_file" 2>/dev/null)
+
+    if [[ "$wf_valid" != "true" ]]; then
+      warn "Workflow validation missing required fields (workflowId, valid)"
+    fi
+  fi
+
+  if [[ "$has_errors" == "true" ]]; then
+    return 1
+  fi
+
+  success "N8N expression testing validation passed"
+  return 0
+}
+
+# Main validation (delegate to common pattern)
+source "$PROJECT_ROOT/.claude/skills/.validation/templates/validator-main.sh" 2>/dev/null || {
+  # Fallback if main template not found
+  OUTPUT_FILE="${1:-}"
+
+  # Handle --self-test flag
+  if [[ "$OUTPUT_FILE" == "--self-test" ]]; then
+    echo "=== Self-Test: $SKILL_NAME v$SKILL_VERSION ==="
+    echo "[PASS] Required tool: jq"
+    if command -v node &>/dev/null; then
+      echo "[PASS] Optional tool: node"
+    else
+      echo "[WARN] Optional tool missing: node"
+    fi
+    if [[ -f "$SCHEMA_PATH" ]]; then
+      echo "[PASS] Schema file exists"
+      if jq empty "$SCHEMA_PATH" 2>/dev/null; then
+        echo "[PASS] Schema is valid JSON"
+      else
+        echo "[FAIL] Schema is invalid JSON"
+        exit 1
+      fi
+    else
+      echo "[WARN] Schema file not found"
+    fi
+    echo "[PASS] Self-test completed"
+    exit 0
+  fi
+
+  if [[ -z "$OUTPUT_FILE" ]]; then
+    echo "Usage: $0 <output-file> | --self-test"
+    exit 1
+  fi
+
+  if [[ ! -f "$OUTPUT_FILE" ]]; then
+    echo "ERROR: File not found: $OUTPUT_FILE"
+    exit 1
+  fi
+
+  echo "Validating $SKILL_NAME output..."
+
+  # Basic JSON validation
+  if ! jq empty "$OUTPUT_FILE" 2>/dev/null; then
+    echo "ERROR: Invalid JSON"
+    exit 1
+  fi
+
+  # Run skill-specific validation
+  if validate_skill_specific "$OUTPUT_FILE"; then
+    echo "PASSED: $SKILL_NAME validation"
+    exit 0
+  else
+    echo "FAILED: $SKILL_NAME validation"
+    exit 1
+  fi
+}

package/v3/assets/skills/n8n-integration-testing-patterns/scripts/validate.sh

@@ -0,0 +1,104 @@
+#!/bin/bash
+# =============================================================================
+# AQE Skill Validator: n8n-integration-testing-patterns v1.0.0
+# =============================================================================
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SKILL_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+PROJECT_ROOT="$(cd "$SKILL_DIR/../../.." && pwd)"
+
+for lib_path in "$PROJECT_ROOT/.claude/skills/.validation/templates/validator-lib.sh" "$SKILL_DIR/scripts/validator-lib.sh"; do
+  [[ -f "$lib_path" ]] && source "$lib_path" && break
+done
+
+SKILL_NAME="n8n-integration-testing-patterns"
+SKILL_VERSION="1.0.0"
+REQUIRED_TOOLS=("jq")
+SCHEMA_PATH="$SKILL_DIR/schemas/output.json"
+REQUIRED_FIELDS=("skillName" "status" "output" "output.summary" "output.integrationTests" "output.serviceConnections")
+MUST_CONTAIN_TERMS=("integration" "n8n")
+MUST_NOT_CONTAIN_TERMS=("TODO" "FIXME")
+ENUM_VALIDATIONS=(".status:success,partial,failed,skipped")
+
+validate_skill_specific() {
+  local output_file="$1"
+  local has_errors=false
+
+  # Validate integration tests structure
+  local test_count
+  test_count=$(jq '.output.integrationTests | length' "$output_file" 2>/dev/null || echo "0")
+
+  if [[ "$test_count" -gt 0 ]]; then
+    local invalid_tests
+    invalid_tests=$(jq '[.output.integrationTests[]? | select(.id == null or .name == null or .testType == null or .status == null)] | length' "$output_file" 2>/dev/null || echo "0")
+
+    if [[ "$invalid_tests" -gt 0 ]]; then
+      warn "$invalid_tests integration test(s) missing required fields"
+    fi
+
+    # Validate test type enum
+    local valid_types="api webhook database file queue external-service e2e"
+    local types
+    types=$(jq -r '.output.integrationTests[]?.testType // empty' "$output_file" 2>/dev/null || true)
+
+    for type in $types; do
+      if ! echo "$valid_types" | grep -qw "$type"; then
+        error "Invalid test type: $type"
+        has_errors=true
+      fi
+    done
+  fi
+
+  # Validate service connections
+  local conn_count
+  conn_count=$(jq '.output.serviceConnections | length' "$output_file" 2>/dev/null || echo "0")
+
+  if [[ "$conn_count" -gt 0 ]]; then
+    local invalid_conns
+    invalid_conns=$(jq '[.output.serviceConnections[]? | select(.serviceName == null or .connectionStatus == null)] | length' "$output_file" 2>/dev/null || echo "0")
+
+    if [[ "$invalid_conns" -gt 0 ]]; then
+      warn "$invalid_conns service connection(s) missing required fields"
+    fi
+  fi
+
+  if [[ "$has_errors" == "true" ]]; then return 1; fi
+  success "N8N integration testing validation passed"
+  return 0
+}
+
+OUTPUT_FILE="${1:-}"
+
+# Handle --self-test flag
+if [[ "$OUTPUT_FILE" == "--self-test" ]]; then
+  echo "=== Self-Test: $SKILL_NAME v$SKILL_VERSION ==="
+  echo "[PASS] Required tool: jq"
+  if [[ -f "$SCHEMA_PATH" ]]; then
+    echo "[PASS] Schema file exists"
+    if jq empty "$SCHEMA_PATH" 2>/dev/null; then
+      echo "[PASS] Schema is valid JSON"
+    else
+      echo "[FAIL] Schema is invalid JSON"
+      exit 1
+    fi
+  else
+    echo "[WARN] Schema file not found"
+  fi
+  echo "[PASS] Self-test completed"
+  exit 0
+fi
+
+[[ -z "$OUTPUT_FILE" ]] && { echo "Usage: $0 <output-file> | --self-test"; exit 1; }
+[[ ! -f "$OUTPUT_FILE" ]] && { echo "ERROR: File not found: $OUTPUT_FILE"; exit 1; }
+
+echo "Validating $SKILL_NAME output..."
+jq empty "$OUTPUT_FILE" 2>/dev/null || { echo "ERROR: Invalid JSON"; exit 1; }
+
+if validate_skill_specific "$OUTPUT_FILE"; then
+  echo "PASSED: $SKILL_NAME validation"
+  exit 0
+else
+  echo "FAILED: $SKILL_NAME validation"
+  exit 1
+fi

package/v3/assets/skills/n8n-security-testing/scripts/validate.sh

@@ -0,0 +1,120 @@
+#!/bin/bash
+# =============================================================================
+# AQE Skill Validator: n8n-security-testing v1.0.0
+# =============================================================================
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+SKILL_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
+PROJECT_ROOT="$(cd "$SKILL_DIR/../../.." && pwd)"
+
+for lib_path in "$PROJECT_ROOT/.claude/skills/.validation/templates/validator-lib.sh" "$SKILL_DIR/scripts/validator-lib.sh"; do
+  [[ -f "$lib_path" ]] && source "$lib_path" && break
+done
+
+SKILL_NAME="n8n-security-testing"
+SKILL_VERSION="1.0.0"
+REQUIRED_TOOLS=("jq")
+SCHEMA_PATH="$SKILL_DIR/schemas/output.json"
+REQUIRED_FIELDS=("skillName" "status" "output" "output.summary" "output.securityFindings" "output.credentialAudit")
+MUST_CONTAIN_TERMS=("security" "credential")
+MUST_NOT_CONTAIN_TERMS=("TODO" "FIXME")
+ENUM_VALIDATIONS=(".status:success,partial,failed,skipped")
+
+validate_skill_specific() {
+  local output_file="$1"
+  local has_errors=false
+
+  # Validate security findings
+  local finding_count
+  finding_count=$(jq '.output.securityFindings | length' "$output_file" 2>/dev/null || echo "0")
+
+  if [[ "$finding_count" -gt 0 ]]; then
+    local invalid_findings
+    invalid_findings=$(jq '[.output.securityFindings[]? | select(.id == null or .title == null or .severity == null or .category == null)] | length' "$output_file" 2>/dev/null || echo "0")
+
+    if [[ "$invalid_findings" -gt 0 ]]; then
+      warn "$invalid_findings finding(s) missing required fields"
+    fi
+
+    # Validate severity enum
+    local valid_severities="critical high medium low info"
+    local severities
+    severities=$(jq -r '.output.securityFindings[]?.severity // empty' "$output_file" 2>/dev/null || true)
+
+    for sev in $severities; do
+      if ! echo "$valid_severities" | grep -qw "$sev"; then
+        error "Invalid severity: $sev"
+        has_errors=true
+      fi
+    done
+
+    # Validate finding ID pattern
+    local invalid_ids
+    invalid_ids=$(jq '[.output.securityFindings[]?.id // empty | select(test("^SEC-N8N-[0-9]{3,6}$") | not)] | length' "$output_file" 2>/dev/null || echo "0")
+
+    if [[ "$invalid_ids" -gt 0 ]]; then
+      warn "$invalid_ids finding(s) have invalid ID format (should be SEC-N8N-NNN)"
+    fi
+  fi
+
+  # Validate credential audit
+  local has_audit
+  has_audit=$(jq '.output.credentialAudit | has("totalCredentials") and has("secureCredentials") and has("insecureCredentials")' "$output_file" 2>/dev/null)
+
+  if [[ "$has_audit" != "true" ]]; then
+    error "Credential audit missing required fields"
+    has_errors=true
+  else
+    # Validate credential counts are consistent
+    local total secure insecure
+    total=$(jq '.output.credentialAudit.totalCredentials' "$output_file" 2>/dev/null)
+    secure=$(jq '.output.credentialAudit.secureCredentials' "$output_file" 2>/dev/null)
+    insecure=$(jq '.output.credentialAudit.insecureCredentials' "$output_file" 2>/dev/null)
+
+    if [[ -n "$total" && -n "$secure" && -n "$insecure" ]]; then
+      if [[ $((secure + insecure)) -gt $total ]]; then
+        warn "Credential counts inconsistent: secure($secure) + insecure($insecure) > total($total)"
+      fi
+    fi
+  fi
+
+  if [[ "$has_errors" == "true" ]]; then return 1; fi
+  success "N8N security testing validation passed"
+  return 0
+}
+
+OUTPUT_FILE="${1:-}"
+
+# Handle --self-test flag
+if [[ "$OUTPUT_FILE" == "--self-test" ]]; then
+  echo "=== Self-Test: $SKILL_NAME v$SKILL_VERSION ==="
+  echo "[PASS] Required tool: jq"
+  if [[ -f "$SCHEMA_PATH" ]]; then
+    echo "[PASS] Schema file exists"
+    if jq empty "$SCHEMA_PATH" 2>/dev/null; then
+      echo "[PASS] Schema is valid JSON"
+    else
+      echo "[FAIL] Schema is invalid JSON"
+      exit 1
+    fi
+  else
+    echo "[WARN] Schema file not found"
+  fi
+  echo "[PASS] Self-test completed"
+  exit 0
+fi
+
+[[ -z "$OUTPUT_FILE" ]] && { echo "Usage: $0 <output-file> | --self-test"; exit 1; }
+[[ ! -f "$OUTPUT_FILE" ]] && { echo "ERROR: File not found: $OUTPUT_FILE"; exit 1; }
+
+echo "Validating $SKILL_NAME output..."
+jq empty "$OUTPUT_FILE" 2>/dev/null || { echo "ERROR: Invalid JSON"; exit 1; }
+
+if validate_skill_specific "$OUTPUT_FILE"; then
+  echo "PASSED: $SKILL_NAME validation"
+  exit 0
+else
+  echo "FAILED: $SKILL_NAME validation"
+  exit 1
+fi