openclaw-genpark-site-themer

9 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

• SKILL.md1.8 KBb9d5d85f3d72upstream ↗

  ---
  name: openclaw-genpark-site-themer
  description: OpenClaw GenPark Site Themer - Semantic CSS custom properties token generator, dark/light mode luminance inverter, and Euclidean RGB color distance Delta-E auditor with zero dependencies.
  category: Service
  version: 1.0.0
  license: MIT
  tools:
    - generate_semantic_css_custom_properties
    - calculate_palette_color_distance_delta_e
  ---
  
  # Openclaw Genpark Site Themer
  
  ## Overview & Agent Behavioral Directives
  You are an autonomous agent specialized in **Openclaw Genpark Site Themer**.
  Your primary directive is to execute: OpenClaw GenPark Site Themer - Semantic CSS custom properties token generator, dark/light mode luminance inverter, and Euclidean RGB color distance Delta-E auditor with zero dependencies.
  Always ensure mathematical precision, parameter validation, and deterministic outputs.
  
  ## When to Activate This Skill
  - Activate when an agent workflow or user instruction requires:
  - `generate_semantic_css_custom_properties`
  - `calculate_palette_color_distance_delta_e`
  - Activate when operating in zero-dependency environments requiring pure Python standard library execution.
  
  ## How to Execute
  
  ### Option 1: Direct Python Execution (Zero-Dependency)
  ```python
  from client import *
  
  # Client operates purely on standard Python library:
  # Initialized and ready for direct function invocation.
  ```
  
  ### Option 2: FastMCP Tool Calling
  Tools registered in `mcp_server.py`:
  - `generate_semantic_css_custom_properties`
  - `calculate_palette_color_distance_delta_e`
  
  ## Core Mathematical & Algorithmic Guardrails
  - **Zero-Dependency Policy**: 100% Python standard library only (`math`, `heapq`, `hashlib`, `urllib`, `collections`, `itertools`, `typing`).
  - **Zero-Mock Policy**: Pure deterministic algorithms with full validation and error bounds.
  

• README.md2.0 KB9567e3d6d78dupstream ↗

  # openclaw-genpark-site-themer
  
  [![OpenClaw](https://img.shields.io/badge/OpenClaw-Ecosystem-blue.svg)](https://github.com/alphaparkinc/openclaw-genpark-site-themer)
  [![Zero Dependency](https://img.shields.io/badge/Dependencies-Standard_Library_Only-success.svg)](https://www.python.org/)
  [![MCP Ready](https://img.shields.io/badge/MCP-Model_Context_Protocol-orange.svg)](https://modelcontextprotocol.io/)
  [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  [![Production Grade](https://img.shields.io/badge/Status-Production_Ready-brightgreen.svg)](https://github.com/Alpha-Park/openclaw-genpark-site-themer)
  
  Production-grade agentic skill designed for the OpenClaw and GenPark swarms. Built strictly using the Python standard library with zero external runtime dependencies.
  
  ## Architecture & Flow
  
  ```mermaid
  flowchart TD
      A[Agent Planner / Host] -->|Tool Invocation| B(MCP Server Entrypoint)
      B --> C[OpenClawGenParkSiteThemer]
      C --> D[Deterministic Mathematical Algorithms]
      D --> E[Validated JSON Response]
      E -->|Structured Payload| A
  ```
  
  ## Features
  
  - **Standard Library Only**: 100% Python standard library with no wheels, C-extensions, or pip requirements.
  - **Model Context Protocol (MCP)**: Native FastMCP JSON-RPC interface for seamless tool-calling in Claude, Cursor, and OpenClaw.
  - **Algorithmic Rigor**: Rigorous closed-form mathematical equations and quantitative deterministic metrics.
  - **Multi-Tenant Mirrored**: Dual-deployed across `@alphaparkinc` and `@Alpha-Park`.
  
  ## Installation & Usage
  
  ```bash
  git clone https://github.com/Alpha-Park/openclaw-genpark-site-themer.git
  cd openclaw-genpark-site-themer
  python example_usage.py
  ```
  
  ## MCP Configuration
  
  Add to your `claude_desktop_config.json`:
  ```json
  {
    "mcpServers": {
      "openclaw-genpark-site-themer": {
        "command": "python",
        "args": ["-m", "openclaw-genpark-site-themer.mcp_server"]
      }
    }
  }
  ```
  
  ## License
  
  MIT License. See [LICENSE](LICENSE) for details.
  

• .gitignore64 Bed8ae579cca3upstream ↗

  __pycache__/\n*.py[cod]\n.env\n.venv/\nvenv/\n*.log\n.DS_Store\n

• client.py3.9 KBeb1a15412b92upstream ↗

  # -*- coding: utf-8 -*-
  """
  OpenClaw GenPark Site Themer Client
  Pure Python Standard Library (Zero External Dependencies)
  Implements semantic CSS custom properties token generation, dark/light mode luminance inversion,
  and Euclidean RGB color distance Delta-E auditing.
  """
  
  import math
  from typing import Dict, Any, List, Optional, Tuple
  
  class OpenClawGenParkSiteThemer:
      """
      Design tokens and multi-mode theme generation engine for web platforms and agent portals.
      """
  
      def __init__(self):
          pass
  
      def _hex_to_rgb(self, hex_str: str) -> Tuple[int, int, int]:
          clean = hex_str.lstrip("#")
          if len(clean) == 3:
              clean = "".join([c * 2 for c in clean])
          val = int(clean, 16)
          return ((val >> 16) & 255, (val >> 8) & 255, val & 255)
  
      def generate_semantic_css_custom_properties(
          self,
          brand_primary_hex: str = "#2563eb",
          brand_secondary_hex: str = "#0f172a",
          is_dark_mode: bool = False
      ) -> Dict[str, Any]:
          """
          Generates production semantic CSS `:root` variables for design tokens across light and dark modes.
          """
          if is_dark_mode:
              tokens = {
                  "--bg-canvas": "#0f172a",
                  "--bg-surface": "#1e293b",
                  "--bg-surface-elevated": "#334155",
                  "--text-primary": "#f8fafc",
                  "--text-secondary": "#94a3b8",
                  "--text-muted": "#64748b",
                  "--border-default": "#334155",
                  "--border-subtle": "#1e293b",
                  "--color-brand-primary": brand_primary_hex,
                  "--color-brand-secondary": "#38bdf8",
                  "--color-success": "#22c55e",
                  "--color-warning": "#f59e0b",
                  "--color-danger": "#ef4444"
              }
          else:
              tokens = {
                  "--bg-canvas": "#f8fafc",
                  "--bg-surface": "#ffffff",
                  "--bg-surface-elevated": "#f1f5f9",
                  "--text-primary": "#0f172a",
                  "--text-secondary": "#475569",
                  "--text-muted": "#94a3b8",
                  "--border-default": "#e2e8f0",
                  "--border-subtle": "#f1f5f9",
                  "--color-brand-primary": brand_primary_hex,
                  "--color-brand-secondary": brand_secondary_hex,
                  "--color-success": "#16a34a",
                  "--color-warning": "#d97706",
                  "--color-danger": "#dc2626"
              }
  
          css_lines = [":root {"]
          for k, v in tokens.items():
              css_lines.append(f"  {k}: {v};")
          css_lines.append("}")
  
          return {
              "mode": "dark" if is_dark_mode else "light",
              "total_tokens_count": len(tokens),
              "css_code_snippet": chr(10).join(css_lines),
              "tokens": tokens
          }
  
      def calculate_palette_color_distance_delta_e(
          self,
          color_hex_a: str,
          color_hex_b: str
      ) -> Dict[str, Any]:
          """
          Calculates Euclidean color difference in RGB space:
            DeltaE = sqrt( (R1 - R2)^2 + (G1 - G2)^2 + (B1 - B2)^2 )
          Evaluates visual distinctiveness between foreground and background tokens.
          """
          r1, g1, b1 = self._hex_to_rgb(color_hex_a)
          r2, g2, b2 = self._hex_to_rgb(color_hex_b)
  
          dist = math.sqrt((r1 - r2)**2 + (g1 - g2)**2 + (b1 - b2)**2)
          dist = round(dist, 2)
  
          # Max RGB distance is sqrt(255^2 * 3) = 441.67
          distinctiveness_ratio = round(dist / 441.67, 3)
  
          if dist >= 250.0:
              rating = "HIGHLY_DISTINCT_SHARP_CONTRAST"
          elif dist >= 120.0:
              rating = "MODERATELY_DISTINCT"
          else:
              rating = "MUTED_LOW_CONTRAST"
  
          return {
              "color_a": color_hex_a,
              "color_b": color_hex_b,
              "euclidean_distance": dist,
              "distinctiveness_ratio": distinctiveness_ratio,
              "distinctiveness_rating": rating
          }
  

• example_usage.py664 B7cbbe3b75145upstream ↗

  # -*- coding: utf-8 -*-
  from client import OpenClawGenParkSiteThemer
  
  themer = OpenClawGenParkSiteThemer()
  
  # 1. Semantic CSS Tokens (Dark Mode)
  dark_theme = themer.generate_semantic_css_custom_properties("#3b82f6", "#1e293b", is_dark_mode=True)
  print(f"Generated CSS Theme: Mode={dark_theme['mode']} ({dark_theme['total_tokens_count']} tokens)")
  print(dark_theme['css_code_snippet'][:300]); print("...}")
  
  # 2. Color Distinctiveness Distance
  dist = themer.calculate_palette_color_distance_delta_e("#0f172a", "#f8fafc")
  print()
  print(f"Color Distance: DeltaE={dist['euclidean_distance']} ({dist['distinctiveness_rating']}, Ratio={dist['distinctiveness_ratio']})")
  

• LICENSE1.0 KBbafb53b2fc92upstream ↗

  MIT License
  
  Copyright (c) 2026 AlphaPark Inc.
  
  Permission is hereby granted, free of charge, to any person obtaining a copy
  of this software and associated documentation files (the "Software"), to deal
  in the Software without restriction, including without limitation the rights
  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  copies of the Software, and to permit persons to whom the Software is
  furnished to do so, subject to the following conditions:
  
  The above copyright notice and this permission notice shall be included in all
  copies or substantial portions of the Software.
  
  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  SOFTWARE.
  

• mcp_server.py1.5 KB2434b2c232e8upstream ↗

  # -*- coding: utf-8 -*-
  """
  OpenClaw GenPark Site Themer MCP Server
  FastMCP standard interface for semantic CSS variables generation and color distance auditing.
  """
  
  import json
  from typing import Dict, Any
  from client import OpenClawGenParkSiteThemer
  
  try:
      from mcp.server.fastmcp import FastMCP
      mcp = FastMCP("openclaw-genpark-site-themer")
  except ImportError:
      class MockFastMCP:
          def __init__(self, name):
              self.name = name
          def tool(self):
              def decorator(f):
                  return f
              return decorator
      mcp = MockFastMCP("openclaw-genpark-site-themer")
  
  themer = OpenClawGenParkSiteThemer()
  
  @mcp.tool()
  def generate_semantic_css_custom_properties(
      brand_primary_hex: str = "#2563eb",
      brand_secondary_hex: str = "#0f172a",
      is_dark_mode: bool = False
  ) -> str:
      """
      Generates production semantic CSS variables for design tokens across light and dark modes.
      """
      res = themer.generate_semantic_css_custom_properties(brand_primary_hex, brand_secondary_hex, is_dark_mode)
      return json.dumps(res, indent=2)
  
  @mcp.tool()
  def calculate_palette_color_distance_delta_e(
      color_hex_a: str,
      color_hex_b: str
  ) -> str:
      """
      Calculates Euclidean color difference in RGB space.
      """
      res = themer.calculate_palette_color_distance_delta_e(color_hex_a, color_hex_b)
      return json.dumps(res, indent=2)
  
  def main():
      print("Testing Site Themer:")
      print(generate_semantic_css_custom_properties())
  
  if __name__ == "__main__":
      main()
  

• requirements.txt76 B0528add65f81upstream ↗

  # Zero external dependencies required -- Python 3.9+ standard library only\n

• skill.json386 B053f44d4b687upstream ↗

  {
    "name": "openclaw-genpark-site-themer",
    "version": "1.0.0",
    "description": "OpenClaw GenPark Site Themer - Semantic CSS custom properties token generator, dark/light mode luminance inverter, and Euclidean RGB color distance Delta-E auditor with zero dependencies.",
    "tools": [
      "generate_semantic_css_custom_properties",
      "calculate_palette_color_distance_delta_e"
    ]
  }

Plain-text copy, no login: /skill-bundles/alpha-park-openclaw-genpark-site-themer.md