synapse-hub 2.2.4 → 2.4.0

package/scripts/generate_skill_examples.py

@@ -0,0 +1,244 @@
+#!/usr/bin/env python3
+"""
+Generates standard examples/ directory and realistic fixtures for all skills (Task B3).
+"""
+
+import os
+import sys
+import json
+
+SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
+REPO_ROOT = os.path.abspath(os.path.join(SCRIPT_DIR, ".."))
+SKILLS_DIR = os.path.join(REPO_ROOT, ".agents", "skills")
+
+EXAMPLES_MAP = {
+    'agent-orchestration-multi-agent-optimize': ('swarm_workload_config.json', json.dumps({
+        'swarm': 'LeadQAOrchestrator',
+        'subagents': ['live-explorer', 'pom-crafter', 'test-runner', 'failure-analyst', 'quality-gatekeeper'],
+        'tokenBudgetPerAgent': 1200,
+        'concurrency': 3
+    }, indent=2)),
+    'antigravity-test-sentinel': ('dod_gate_policy.json', json.dumps({
+        'policyName': 'Enterprise-DoD-Gate-0-to-8',
+        'enforceGates': ['Gate-0-Integrity', 'Gate-1-UTF8-NoBOM', 'Gate-3-CleanPOM', 'Gate-7-InferLinter', 'Gate-8-MicroMutator'],
+        'minMutationScore': 80.0
+    }, indent=2)),
+    'api-network-mocking-interception': ('network_route_stub.json', json.dumps({
+        'route': '**/api/v1/checkout',
+        'method': 'POST',
+        'status': 200,
+        'response': {'orderId': 'ORD-AUTO-998822', 'status': 'CONFIRMED'}
+    }, indent=2)),
+    'api-spec-to-e2e-matrix': ('sample_openapi.json', json.dumps({
+        'openapi': '3.0.0',
+        'info': {'title': 'Payment API', 'version': '1.0.0'},
+        'paths': {
+            '/payments': {
+                'post': {
+                    'summary': 'Create payment',
+                    'responses': {'201': {'description': 'Created'}}
+                }
+            }
+        }
+    }, indent=2)),
+    'architecture-decision-records': ('0001-record-architecture-decisions.md', """# 1. Record architecture decisions
+
+Date: 2026-10-30
+
+## Status
+Accepted
+
+## Context
+We need to record technical architecture decisions in ADR format.
+
+## Decision
+We will use Markdown ADR files stored in docs/adr/.
+"""),
+    'auth-session-and-cookie-manager': ('storage_state_sample.json', json.dumps({
+        'cookies': [
+            {'name': 'session_id', 'value': 'sess_auto_998', 'domain': 'example.com', 'path': '/'}
+        ],
+        'origins': []
+    }, indent=2)),
+    'backend-load-and-stress-patterns': ('k6_load_test_sample.js', """import http from 'k6/http';
+import { check, sleep } from 'k6';
+
+export const options = {
+  vus: 10,
+  duration: '30s',
+};
+
+export default function () {
+  const res = http.get('https://test.k6.io');
+  check(res, { 'status was 200': (r) => r.status == 200 });
+  sleep(1);
+}
+"""),
+    'bats-testing-patterns': ('cli_runner_test.bats', """#!/usr/bin/env bats
+
+@test 'verify CLI returns version' {
+  run python3 tools/cli.py --version
+  [ "$status" -eq 0 ]
+}
+"""),
+    'code-refactoring-refactor-clean': ('refactored_page_sample.groovy', """package pages
+
+class UserManagementPage extends BasePage {
+    static final String USER_TABLE_ROW = "table#users tbody tr"
+
+    static boolean verifyUserActive(String email) {
+        return verifyElementPresent(uniqueLocator(USER_TABLE_ROW, email))
+    }
+}
+"""),
+    'db-state-verifier-and-seeder': ('db_fixture_seed.json', json.dumps({
+        'table': 'tenants',
+        'operation': 'INSERT',
+        'records': [
+            {'tenant_id': 'AUTO_TENANT_01', 'status': 'ACTIVE', 'plan': 'ENTERPRISE'}
+        ],
+        'teardown': 'DELETE FROM tenants WHERE tenant_id = :tenant_id'
+    }, indent=2)),
+    'e2e-testing-patterns': ('playwright_sharded_config.ts', """import { defineConfig, devices } from '@playwright/test';
+
+export default defineConfig({
+  testDir: './tests',
+  fullyParallel: true,
+  retries: 2,
+  workers: process.env.CI ? 4 : undefined,
+  use: {
+    headless: true,
+    trace: 'on-first-retry',
+  },
+});
+"""),
+    'failure-autopsy-and-healing': ('sample_junit_failure.xml', """<?xml version="1.0" encoding="UTF-8"?>
+<testsuites>
+  <testsuite name="AuthenticationSuite" tests="1" failures="1">
+    <testcase name="testLoginFailure" classname="AuthTest">
+      <failure message="Timeout 30000ms exceeded waiting for locator('#submit-btn')" type="ElementNotFoundError"/>
+    </testcase>
+  </testsuite>
+</testsuites>
+"""),
+    'file-and-report-validator': ('sample_export_schema.json', json.dumps({
+        'expectedHeaders': ['Order ID', 'Customer Name', 'Amount', 'Date', 'Status'],
+        'rowCountRange': [1, 5000],
+        'dateFormat': 'YYYY-MM-DD'
+    }, indent=2)),
+    'flaky-test-sentinel-and-quarantine': ('quarantine_registry.json', json.dumps({
+        'quarantinedTests': [
+            {
+                'testId': 'TC-CHECKOUT-881',
+                'flakinessScore': 0.35,
+                'reason': 'Intermittent 3rd-party payment gateway timeout',
+                'quarantineDate': '2026-10-30',
+                'ticket': 'QA-1204'
+            }
+        ]
+    }, indent=2)),
+    'github-actions-templates': ('matrix_test_pipeline.yml', """name: Automated E2E Matrix
+on: [push, pull_request]
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - run: npx playwright test
+"""),
+    'graphify-impact-analyzer': ('dependency_blast_radius.json', json.dumps({
+        'modifiedFile': 'src/pages/CheckoutPage.ts',
+        'impactedSuites': ['tests/e2e/checkout.spec.ts', 'tests/e2e/payment.spec.ts'],
+        'blastRadiusScore': 'LOW_ISOLATED'
+    }, indent=2)),
+    'katalon-cli-runner': ('headless_kre_exec.sh', """#!/bin/sh
+# Execute headless Katalon suite with automatic process cleanup
+katalonc -noSplash -runMode=console -projectPath="$1" -testSuitePath="Test Suites/SmokeSuite" -browserType="Chrome (headless)"
+"""),
+    'lam-script-generator': ('user_story_sample.md', """# User Story: User Password Reset Flow
+As a registered customer,
+I want to request a password reset email,
+So that I can regain access if I forget my password.
+
+## Acceptance Criteria:
+1. Submitting registered email displays "Reset link dispatched".
+2. Submitting empty email highlights field in red with validation error.
+"""),
+    'playwright-live-interaction': ('live_probe_script.js', """// Playwright Live Interactive Probe Helper
+const targetLocator = page.locator("[data-testid='submit-order']");
+const isVisible = await targetLocator.isVisible();
+const boundingBox = await targetLocator.boundingBox();
+console.log({ isVisible, boundingBox });
+"""),
+    'security-dast-sentinel': ('dast_scan_config.json', json.dumps({
+        'targetUrl': 'https://staging.internal.example.com',
+        'checks': ['OWASP_TOP_10', 'HEADER_SECURITY', 'TOKEN_EXPOSURE', 'SQLI_PROBING'],
+        'failOnSeverity': 'HIGH'
+    }, indent=2)),
+    'self-healing-locator': ('aom_diff_sample.json', json.dumps({
+        'brokenLocator': '#old-checkout-btn',
+        'historicalAttributes': {'role': 'button', 'text': 'Confirm Order', 'testid': 'checkout-submit'},
+        'currentAOMSnapshot': [
+            {'role': 'button', 'name': 'Confirm Order', 'testid': 'checkout-submit-v2'}
+        ],
+        'healedLocator': "button[data-testid='checkout-submit-v2']"
+    }, indent=2)),
+    'skillspector-security-guard': ('safe_mcp_config.json', json.dumps({
+        'mcpServers': {
+            'playwright-live': {
+                'command': 'npx',
+                'args': ['-y', '@modelcontextprotocol/server-playwright'],
+                'sandboxPolicy': 'HEADLESS_VIRTUAL_DISPLAY'
+            }
+        }
+    }, indent=2)),
+    'synthetic-test-data-generator': ('idempotent_data_recipe.json', json.dumps({
+        'entity': 'user',
+        'prefix': 'AUTO_',
+        'timestampPattern': 'EPOCH_MS',
+        'fields': {
+            'email': 'AUTO_USER@example-qa.com',
+            'phone': '+15551234567'
+        }
+    }, indent=2)),
+    'token-and-context-optimizer': ('distilled_log_sample.txt', """[RAW CLI LOG: 3,200 lines truncated by distill_log.py]
+FAILED tests/checkout.spec.ts:42:15 -> TimeoutError: Waiting for selector `button.order-confirm`
+Status: 1 failed, 12 passed in 14.2s
+"""),
+    'visual-regression-sentinel': ('visual_mask_rules.json', json.dumps({
+        'maskSelectors': ['.dynamic-timestamp', '.live-chart-canvas', '.user-avatar-badge'],
+        'thresholdSSIM': 0.98,
+        'maxDiffPixels': 25
+    }, indent=2)),
+    'wcag-audit-patterns': ('wcag_compliance_checklist.json', json.dumps({
+        'conformanceLevel': 'AA',
+        'criteria': ['1.4.3 Contrast (Minimum)', '2.1.1 Keyboard', '2.4.7 Focus Visible', '4.1.2 Name, Role, Value'],
+        'auditTool': 'axe-core'
+    }, indent=2)),
+    'web-vitals-and-performance-profiler': ('cwv_budget_policy.json', json.dumps({
+        'LCP_ms': 2500,
+        'CLS_score': 0.1,
+        'INP_ms': 200,
+        'networkThrottle': 'Fast 3G'
+    }, indent=2))
+}
+
+
+def main():
+    try:
+        sys.stdout.reconfigure(encoding='utf-8')
+    except Exception:
+        pass
+    count = 0
+    for skill, (filename, content) in EXAMPLES_MAP.items():
+        ex_dir = os.path.join(SKILLS_DIR, skill, 'examples')
+        os.makedirs(ex_dir, exist_ok=True)
+        fpath = os.path.join(ex_dir, filename)
+        with open(fpath, 'w', encoding='utf-8') as f:
+            f.write(content)
+        count += 1
+    print(f"[OK] Generated examples for {count} skills.")
+
+
+if __name__ == "__main__":
+    main()

package/scripts/install.ps1

@@ -0,0 +1,112 @@
+<#
+.SYNOPSIS
+    One-click setup and dependency bootstrap script for Enterprise Agent-Skills Hub.
+.DESCRIPTION
+    Detects and installs Python, Node.js, Playwright, sets up a clean virtual environment,
+    installs requirements.txt, and verifies the full 30-skill catalog.
+#>
+
+[CmdletBinding()]
+param(
+    [switch]$ForceInstall = $false
+)
+
+Write-Host "==========================================================" -ForegroundColor Cyan
+Write-Host "  Enterprise Agent-Skills Hub: Automated Bootstrap Setup  " -ForegroundColor Cyan
+Write-Host "==========================================================" -ForegroundColor Cyan
+
+$repoRoot = Split-Path -Parent $PSScriptRoot
+Set-Location $repoRoot
+
+# 1. Verify / Install Python
+Write-Host "`n[1/5] Checking Python 3 Runtime..." -ForegroundColor Yellow
+$py = $null
+foreach ($cmd in @("python", "python3", "py")) {
+    try {
+        $v = & $cmd --version 2>&1
+        if ($LASTEXITCODE -eq 0 -and $v -match "Python\s+3\.(1[0-9]|[2-9][0-9])") {
+            $py = $cmd
+            Write-Host "  [OK] Found Python: $v" -ForegroundColor Green
+            break
+        }
+    } catch { }
+}
+
+if (-not $py) {
+    Write-Host "  [WARN] Python 3.10+ not found in PATH." -ForegroundColor Yellow
+    Write-Host "  Attempting automated installation via winget..." -ForegroundColor Cyan
+    try {
+        winget install -e --id Python.Python.3.11 --accept-source-agreements --accept-package-agreements --scope currentUser
+        Write-Host "  [OK] Python 3.11 installed. Please restart your shell if PATH is not updated." -ForegroundColor Green
+    } catch {
+        Write-Host "  [FAIL] Could not auto-install Python. Please install from https://python.org" -ForegroundColor Red
+    }
+}
+
+# 2. Virtual Environment Setup
+Write-Host "`n[2/5] Setting up Virtual Environment (.venv)..." -ForegroundColor Yellow
+$venvDir = Join-Path $repoRoot ".venv"
+if (-not (Test-Path $venvDir) -and $py) {
+    Write-Host "  Creating virtual environment at $venvDir..." -ForegroundColor Cyan
+    & $py -m venv $venvDir
+}
+
+$venvPython = if ($IsWindows -or $env:OS -match "Windows") {
+    Join-Path $venvDir "Scripts\python.exe"
+} else {
+    Join-Path $venvDir "bin/python"
+}
+
+# 3. Pip Dependencies
+Write-Host "`n[3/5] Installing Core Python Dependencies..." -ForegroundColor Yellow
+$reqFile = Join-Path $repoRoot "requirements.txt"
+if (Test-Path $venvPython) {
+    Write-Host "  Upgrading pip & wheel..." -ForegroundColor Cyan
+    & $venvPython -m pip install --upgrade pip setuptools wheel --quiet
+    if (Test-Path $reqFile) {
+        Write-Host "  Installing requirements from requirements.txt..." -ForegroundColor Cyan
+        & $venvPython -m pip install -r $reqFile --quiet
+        Write-Host "  [OK] Dependencies installed in .venv" -ForegroundColor Green
+    }
+} elseif ($py) {
+    Write-Host "  Installing requirements using system $py..." -ForegroundColor Cyan
+    & $py -m pip install -r $reqFile --quiet
+} else {
+    Write-Host "  [SKIP] Skipping pip install: Python runtime not yet active." -ForegroundColor Yellow
+}
+
+# 4. Check Node.js / Playwright
+Write-Host "`n[4/5] Checking Node.js & Playwright CLI..." -ForegroundColor Yellow
+try {
+    $nodeVer = & node --version 2>&1
+    Write-Host "  [OK] Found Node.js: $nodeVer" -ForegroundColor Green
+} catch {
+    Write-Host "  [INFO] Node.js not detected. Optional for standalone Python tools, required for Playwright MCP." -ForegroundColor Gray
+}
+
+# 5. Run Quality Gate Linting
+Write-Host "`n[5/6] Running Quality Gate & Skill Integrity Verification..." -ForegroundColor Yellow
+$linter = Join-Path $repoRoot "scripts\lint_skills.ps1"
+if (Test-Path $linter) {
+    & powershell -ExecutionPolicy Bypass -File $linter
+}
+
+# 6. Initialize SQLite Central Agent Memory
+Write-Host "`n[6/6] Initializing Global Central Agent Memory (~/.agent_memory/global_cache.db)..." -ForegroundColor Yellow
+$cacheTool = Join-Path $repoRoot "tools\cache_resolver.py"
+if (Test-Path $cacheTool) {
+    try {
+        if (Test-Path $venvPython) {
+            & $venvPython $cacheTool init
+        } elseif ($py) {
+            & $py $cacheTool init
+        }
+        Write-Host "  [OK] Central Agent Memory initialized and seeded." -ForegroundColor Green
+    } catch {
+        Write-Host "  [WARN] Could not initialize ~/.agent_memory/global_cache.db: $_" -ForegroundColor Yellow
+    }
+}
+
+Write-Host "`n==========================================================" -ForegroundColor Cyan
+Write-Host "  Bootstrap Complete! Hub is ready for Multi-Agent Swarm. " -ForegroundColor Green
+Write-Host "==========================================================" -ForegroundColor Cyan

package/scripts/install_global_plugin.ps1

@@ -0,0 +1,94 @@
+# Enterprise Synapse-Hub Global Antigravity Plugin Installer (Windows)
+# ======================================================================
+# Mounts Synapse-Hub directly into Google Antigravity's Global Plugin Directory.
+# Once installed, all 27 skills and 6 subagents are active across all projects automatically.
+
+[CmdletBinding()]
+param()
+
+$ErrorActionPreference = "Stop"
+$ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$RepoRoot = Resolve-Path "$ScriptDir\.."
+
+Write-Host "`n======================================================================" -ForegroundColor Cyan
+Write-Host "   SYNAPSE-HUB: ANTIGRAVITY GLOBAL PLUGIN 1-CLICK INSTALLER           " -ForegroundColor Cyan
+Write-Host "======================================================================`n" -ForegroundColor Cyan
+
+$PluginsDir = "$HOME\.gemini\config\plugins"
+$TargetPluginDir = "$PluginsDir\synapse-hub"
+
+if (-not (Test-Path $PluginsDir)) {
+    Write-Host "[1/5] Creating Antigravity plugins directory: $PluginsDir" -ForegroundColor Yellow
+    New-Item -ItemType Directory -Path $PluginsDir -Force | Out-Null
+} else {
+    Write-Host "[1/5] Antigravity plugins directory verified: $PluginsDir" -ForegroundColor Green
+}
+
+# Ensure clean target directory
+if (-not (Test-Path $TargetPluginDir)) {
+    Write-Host "[2/5] Creating plugin bundle directory: $TargetPluginDir" -ForegroundColor Yellow
+    New-Item -ItemType Directory -Path $TargetPluginDir -Force | Out-Null
+} else {
+    Write-Host "[2/5] Plugin bundle directory exists: $TargetPluginDir" -ForegroundColor Green
+}
+
+# 1. Copy plugin.json & README.md
+Write-Host "[3/5] Copying plugin manifest (plugin.json)..." -ForegroundColor Yellow
+Copy-Item "$RepoRoot\plugin.json" "$TargetPluginDir\plugin.json" -Force
+if (Test-Path "$RepoRoot\README.md") {
+    Copy-Item "$RepoRoot\README.md" "$TargetPluginDir\README.md" -Force
+}
+
+# 2. Setup skills and agents via NTFS Junctions (Instant, zero duplication)
+Write-Host "[4/5] Linking skills, agents, and rules into Global Plugin..." -ForegroundColor Yellow
+
+$SkillsLink = "$TargetPluginDir\skills"
+$AgentsLink = "$TargetPluginDir\agents"
+$ToolsLink = "$TargetPluginDir\tools"
+$RulesDir = "$TargetPluginDir\rules"
+
+# Skills Junction
+if (Test-Path $SkillsLink) {
+    (Get-Item $SkillsLink).Delete()
+}
+New-Item -ItemType Junction -Path $SkillsLink -Target "$RepoRoot\.agents\skills" | Out-Null
+Write-Host "  • Linked skills  : $SkillsLink -> $RepoRoot\.agents\skills" -ForegroundColor Green
+
+# Agents Junction
+if (Test-Path $AgentsLink) {
+    (Get-Item $AgentsLink).Delete()
+}
+New-Item -ItemType Junction -Path $AgentsLink -Target "$RepoRoot\.agents\agents" | Out-Null
+Write-Host "  • Linked agents  : $AgentsLink -> $RepoRoot\.agents\agents" -ForegroundColor Green
+
+# Tools Junction
+if (Test-Path $ToolsLink) {
+    (Get-Item $ToolsLink).Delete()
+}
+New-Item -ItemType Junction -Path $ToolsLink -Target "$RepoRoot\tools" | Out-Null
+Write-Host "  • Linked tools   : $ToolsLink -> $RepoRoot\tools" -ForegroundColor Green
+
+# Rules directory & AGENTS.md
+if (-not (Test-Path $RulesDir)) {
+    New-Item -ItemType Directory -Path $RulesDir -Force | Out-Null
+}
+Copy-Item "$RepoRoot\AGENTS.md" "$RulesDir\AGENTS.md" -Force
+Write-Host "  • Deployed rules : $RulesDir\AGENTS.md" -ForegroundColor Green
+
+# 3. Initialize SQLite Cache
+Write-Host "`n[5/5] Initializing Central Agent Memory (SQLite Cache)..." -ForegroundColor Yellow
+try {
+    python "$RepoRoot\tools\cache_resolver.py" init
+} catch {
+    Write-Host "  (Notice: cache_resolver init will run when Python is invoked)" -ForegroundColor DarkGray
+}
+
+Write-Host "`n======================================================================" -ForegroundColor Cyan
+Write-Host "  🎉 SUCCESS: Synapse-Hub is now installed as a GLOBAL PLUGIN!        " -ForegroundColor Green
+Write-Host "======================================================================" -ForegroundColor Cyan
+Write-Host "• Location : $TargetPluginDir" -ForegroundColor White
+Write-Host "• Skills   : 27 Standardized QA Skills" -ForegroundColor White
+Write-Host "• Agents   : 6 Swarm Subagent Profiles" -ForegroundColor White
+Write-Host "`n👉 Antigravity will now automatically load Synapse-Hub across ALL projects" -ForegroundColor Yellow
+Write-Host "   without needing to add Synapse-Hub as a workspace folder!" -ForegroundColor Yellow
+Write-Host "======================================================================`n" -ForegroundColor Cyan

package/scripts/install_global_plugin.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+# Enterprise Synapse-Hub Global Antigravity Plugin Installer (macOS / Linux)
+# ======================================================================
+# Mounts Synapse-Hub directly into Google Antigravity's Global Plugin Directory.
+# Once installed, all 27 skills and 6 subagents are active across all projects automatically.
+
+set -e
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/.." && pwd)"
+
+echo ""
+echo "======================================================================"
+echo "   SYNAPSE-HUB: ANTIGRAVITY GLOBAL PLUGIN 1-CLICK INSTALLER           "
+echo "======================================================================"
+echo ""
+
+PLUGINS_DIR="$HOME/.gemini/config/plugins"
+TARGET_PLUGIN_DIR="$PLUGINS_DIR/synapse-hub"
+
+mkdir -p "$PLUGINS_DIR"
+mkdir -p "$TARGET_PLUGIN_DIR"
+
+echo "[1/4] Copying plugin manifest..."
+cp "$REPO_ROOT/plugin.json" "$TARGET_PLUGIN_DIR/plugin.json"
+[ -f "$REPO_ROOT/README.md" ] && cp "$REPO_ROOT/README.md" "$TARGET_PLUGIN_DIR/README.md"
+
+echo "[2/4] Symlinking skills, agents, and tools..."
+ln -sfn "$REPO_ROOT/.agents/skills" "$TARGET_PLUGIN_DIR/skills"
+ln -sfn "$REPO_ROOT/.agents/agents" "$TARGET_PLUGIN_DIR/agents"
+ln -sfn "$REPO_ROOT/tools" "$TARGET_PLUGIN_DIR/tools"
+
+mkdir -p "$TARGET_PLUGIN_DIR/rules"
+cp "$REPO_ROOT/AGENTS.md" "$TARGET_PLUGIN_DIR/rules/AGENTS.md"
+
+echo "[3/4] Initializing Central Agent Memory (SQLite Cache)..."
+python3 "$REPO_ROOT/tools/cache_resolver.py" init 2>/dev/null || python "$REPO_ROOT/tools/cache_resolver.py" init 2>/dev/null || true
+
+echo ""
+echo "======================================================================"
+echo "  🎉 SUCCESS: Synapse-Hub is now installed as a GLOBAL PLUGIN!        "
+echo "======================================================================"
+echo "• Location : $TARGET_PLUGIN_DIR"
+echo "• Skills   : 27 Standardized QA Skills"
+echo "• Agents   : 6 Swarm Subagent Profiles"
+echo ""
+echo "👉 Antigravity will now automatically load Synapse-Hub across ALL projects"
+echo "   without needing to add Synapse-Hub as a workspace folder!"
+echo "======================================================================"
+echo ""

package/scripts/lint_skills.ps1

@@ -0,0 +1,57 @@
+<#
+.SYNOPSIS
+    Automated validation test for all skills in Agent-Skills Hub.
+.DESCRIPTION
+    Checks presence of SKILL.md, valid frontmatter (name, description), and verifies skills_manifest.json.
+#>
+
+Write-Host "==========================================================" -ForegroundColor Cyan
+Write-Host "         Agent-Skills Quality & Integrity Linter          " -ForegroundColor Cyan
+Write-Host "==========================================================" -ForegroundColor Cyan
+
+$skillsDir = Join-Path $PSScriptRoot "..\.agents\skills"
+$manifestPath = Join-Path $PSScriptRoot "..\skills_manifest.json"
+
+$passed = 0
+$failed = 0
+
+if (-not (Test-Path $manifestPath)) {
+    Write-Host "[FAIL] Missing skills_manifest.json!" -ForegroundColor Red
+    exit 1
+}
+
+$manifest = Get-Content $manifestPath -Raw | ConvertFrom-Json
+Write-Host "[INFO] Manifest loaded: $($manifest.totalSkills) declared skills." -ForegroundColor Gray
+
+$skillDirs = Get-ChildItem -Path $skillsDir -Directory
+
+foreach ($dir in $skillDirs) {
+    $skillMd = Join-Path $dir.FullName "SKILL.md"
+    if (-not (Test-Path $skillMd)) {
+        Write-Host "[FAIL] $($dir.Name): Missing SKILL.md" -ForegroundColor Red
+        $failed++
+        continue
+    }
+
+    $content = Get-Content $skillMd -Raw
+    $hasName = $content -match "name:\s*[\w\-\s]+"
+    $hasDesc = $content -match "description:\s*.+"
+
+    if ($hasName -and $hasDesc) {
+        Write-Host "[PASS] $($dir.Name) - Valid Frontmatter" -ForegroundColor Green
+        $passed++
+    } else {
+        Write-Host "[FAIL] $($dir.Name) - Invalid or missing YAML frontmatter" -ForegroundColor Red
+        $failed++
+    }
+}
+
+Write-Host "----------------------------------------------------------" -ForegroundColor Cyan
+Write-Host "Verification Results: $passed Passed, $failed Failed." -ForegroundColor $(if ($failed -eq 0) { "Green" } else { "Red" })
+Write-Host "----------------------------------------------------------" -ForegroundColor Cyan
+
+if ($failed -gt 0) {
+    exit 1
+} else {
+    exit 0
+}