A comprehensive Chinese metaphysics skill that integrates four classical divination methods with an intelligent routing matrix and precise true solar time correction.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install comprehensive-divination-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install comprehensive-divination-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Comprehensive Divination Skill?
The Comprehensive Divination Skill brings authentic, technically precise Chinese metaphysics systems directly into AI agent workflows. It unifies four pillars of classical fortune-telling and structural deduction: Xiao Liu Ren, Liu Yao Na Jia, Mei Hua Yi Shu, and Da Liu Ren. Rather than relying on rigid or inaccurate Western calendar lookups, this skill leverages native computational pipelines to handle real-world complexities like solar-term boundary shifts, lunisolar conversions, and localized astronomical adjustments.
At its core, the skill features a sophisticated four-dimensional routing matrix that evaluates user queries across dimensions of complexity, decision weight, time-sensitivity, and domain expertise. This ensures that the optimal metaphysics engine is applied to each unique scenario. Built to be resilient and developer-friendly, it features zero-network fallback modes, deterministic Python math engines, and localized geo-caching to deliver hyper-accurate Ganzhi (Stem-Branch) alignments under Openclaw Skills.
Comprehensive Divination Skill Use Cases
- Dynamically recommending and executing the optimal Chinese divination methodology based on the structural complexity of a user's problem.
- Calibrating raw clock readings into hyper-accurate Local True Solar Time (TST) to ensure correct Ganzhi boundary transitions.
- Simulating authentic multi-stage coin-tossing routines and generating full structural hexagram matrices (including lines, changing elements, and relative correlations).
- Providing deterministic metaframework analysis for temporal, spatial, or numerical prompts to assist LLMs in structural forecasting tasks.
How Comprehensive Divination Skill Works
- Time Anchoring (Step 0): The system immediately freezes the execution time stamp upon receipt of a query using a non-blocking snapshot function to avoid drift during multi-turn clarifications.
- Four-Dimensional Query Routing: The agent reads the matching matrix to mathematically evaluate problem complexity, decision weight, immediacy requirements, and contextual domain.
- Method Confirmation: The agent invokes the programmatic clarify tool to collect user authorization on the calculated method selection and spatial location.
- True Solar Time Alignment: The script transforms standard UTC+8 Beijing Time into precise local astronomical coordinates, checking for critical boundary shifts across hours, calendar days, or seasonal micro-periods.
- Reference Core Loading: Relevant structural markdown databases are dynamically mounted into context on a strict need-to-know basis.
- Deterministic Pipeline Execution: The underlying Python scripting engine runs calculations for Ganzhi setups, coin configurations, or celestial matrices without invoking stochastic AI guesses.
- Formatted Synthesis Output: The AI parses the execution engine's output schema, applies interpretative rulesets based on classical literature, and prints a comprehensive summary with full time-zone annotations and mandatory legal compliance text.
Comprehensive Divination Skill Setup
Prerequisites
Ensure your agent runtime environment is initialized. Note that Windows environments should lock the compatibility version to ensure structural stability.
# Bootstrap the embedded hermes virtual environment package manager
python -m ensurepip
# Install the strict computational dependencies
python -m pip install zhdate==0.1
# Alternative installation via standard project definitions
pip install -r requirements.txt
Core Initialization Quickstart
# Freeze current execution time and configure true solar calibrations for a specific target hub
python scripts/common.py --snapshot --city Chengdu
# Explicit execution targeting standard parameters derived from snapshot values
python scripts/xiao_liuren.py -m 5 -d 29 -t 8
Comprehensive Divination Skill Data Schema & Taxonomy
The skill manages its underlying state, cache architecture, and contextual reference guidelines using a highly predictable layout:
Directory Configuration Layout
SKILL.md- Primary operational rules, target keywords, configuration entry points, and execution instructions.scripts/- Core Python business logic engines executing mathematics and system calculations.common.py- Core date-time translations, Beijing baseline handlers, and TST equations._geo_cache.json- Serialized file mapping geocoded string queries to raw float coordinates (git-ignored, populated locally).xiao_liuren.py/liuyao_yaogua.py/meihua_qigua.py/da_liuren.py- Specialized algorithmic code specific to individual methods.
references/- Static Markdown files housing structured lookups, Ganzhi rulesets, relational graphs, and output generation definitions.
Snapshot JSON Schema
When initializing step operations, the common.py --snapshot pipeline outputs a highly-structured data matrix:
| Key Name | DataType | Context / Intent |
|---|---|---|
frozen_at |
String (ISO 8601) | The absolute frozen execution timestamp protecting boundary logic from system delays. |
bj_hour |
Integer | Absolute normalized Beijing time coordinates. |
ts_hour |
Float | Calibrated Local True Solar Time floating value representing the true position of the sun. |
shichen |
String | Character designation indicating the active structural Earthly Branch double-hour bracket. |
shichen_idx |
Integer | System array index tracking the exact mathematical double-hour slice (1-12). |
Comprehensive Divination Skill Advanced Features
- True Solar Coordinate Translation Matrix: Fixes standard baseline drift by running astronomical offset equations:
TST = Beijing Time + (Local Longitude - 120°) * 4 minutes, systematically recalculating cross-day or cross-hour border transitions. - Asynchronous Geocoding Fallback Engine: Features integrated programmatic coordinate lookups via Open-Meteo Geocoding APIs utilizing python standard libraries with local zero-latency filesystem JSON caching.
- Multi-System Routing Matrix: Implements automated mathematical scaling matrices based on multi-variate query weights, dynamically enhancing specific system affinities when intercepting structural inputs like raw digits, dates, or concise prompts.
- Contextual Memory Anti-Pattern Interceptor: Tracks iteration frequency on single subjects to alert agents of noise degradation ('Dissipating Energy' principle) after 3 consecutive sessions on an unchanged query state.
SKILL.md
Loading
Related Openclaw Skills
Prevent WPS Image Hijack
A utility skill to permanently block WPS Office from hijacking default image associations and restore user control on Windows systems.
Domain Payload Generator
Domain Payload Generator is a specialized meta-skill designed to analyze new technical fields and independently manufacture fully UTOS-compatible domain payload skills from scratch.
Multi-Platform Social Media Data Scraper
An elite multi-platform scraper to capture social media metrics and automatically sync them to Feishu Bitables.
Deeptechnic Deep-Tech Due Diligence Framework
A structured system for conducting independent physics-based technology due diligence and risk assessment on hard-tech startup investments.
Birthing from Within
An AI agent skill based on Pam England and Rob Horowitz's childbirth preparation framework that guides users through natural labor pain management, birth art, emotional readiness, and birth partner involvement.
memory-tencentdb
A production-grade, four-layer memory architecture plugin for OpenClaw that automates dialogue capture, parses structural logs, and manages dynamic user profiles.
Featured*
