← Back to Skills Marketplace
vincent-vstudios

Yinian Zwds

by Vincent-VStudios · GitHub ↗ · v2.1.0 · MIT-0
cross-platform ⚠ suspicious
53
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install yinian-zwds
Description
一念紫微斗数 (Yinian Zi Wei Dou Shu) — 专业AI紫微斗数排盘解盘系统。三派合一:三合派/飞星派/占验派。触发词:紫微斗数、紫微、命盘、排盘、ZWDS、ziwei、Purple Star
Usage Guidance
This skill appears to implement a real Zi Wei Dou Shu (astrology) system and includes code to build prompts and call external LLM APIs, which is consistent with the description — but there are important mismatches you should consider before installing or running it: - Undeclared secret access: The code will look for DEEPSEEK_API_KEY and OPENAI_API_KEY and will attempt to read your OpenClaw config at ~/.openclaw/openclaw.json to extract keys. The registry metadata did not declare these env vars or config paths. If you have sensitive keys in those locations, the skill will use them to call external services. - Network behavior: Running the provided scripts will send chart data and AI prompts (including users' birth info) to external AI endpoints (DeepSeek/OpenAI). This is expected for LLM-powered output, but you should be aware data will leave your machine when these scripts are executed. - Extra components not documented in SKILL.md: The package includes an API server (FastAPI), a Telegram handler, and scheduled push logic. These components could expose data or start outgoing connections if run; SKILL.md primarily documents interactive use but does not warn about these modules. Recommendations: 1. Inspect the code yourself or have someone you trust review ai_engine.py and any network call before running. Verify exactly what data is sent in requests. 2. If you want to try it, run it in an isolated environment (VM or container) without sensitive keys present. Provide only ephemeral/test API keys if needed. 3. Prefer to run the calculation-only parts (zwds_calc.generate_astrolabe) locally first to validate outputs; avoid running scripts that call call_llm or start api_app unless you intend those behaviors. 4. Ask the publisher to update SKILL.md and registry metadata to declare required env vars/config paths and to explicitly document the network calls and optional server components. If you want, I can list the exact lines/files that read environment variables or the OpenClaw config and the functions that perform network requests so you can inspect them more quickly.
Capability Analysis
Type: OpenClaw Skill Name: yinian-zwds Version: 2.1.0 The skill bundle is classified as suspicious primarily because `scripts/ai_engine.py` directly accesses and parses the global OpenClaw configuration file (`~/.openclaw/openclaw.json`) to extract DeepSeek and OpenAI API keys. While this is intended to facilitate the skill's astrology interpretation features, accessing the platform's sensitive core configuration file is an over-privileged behavior that bypasses standard environment variable usage. Additionally, `SKILL.md` provides instructions for the agent to execute complex Python logic via shell commands (`python3 -c`), which creates a potential surface for command injection if birth dates or names are not strictly sanitized. No evidence of intentional data exfiltration to unauthorized third-party servers was found.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
The skill's name/description (紫微斗数排盘解盘) matches the included code: calculation, prompt-building, and AI-driven report generation. However, ai_engine.py looks up API keys from environment variables and from ~/.openclaw/openclaw.json — neither the SKILL.md nor the registry metadata declare any required env vars or config paths. Reading the user's OpenClaw config is outside the declared scope and not obviously necessary to compute astrological charts; at minimum the skill should have declared these requirements.
Instruction Scope
SKILL.md explicitly instructs the agent to exec local Python scripts in ~/.openclaw/skills/yinian-zwds/scripts to generate charts. Those scripts in turn perform network calls (POSTs to external LLM endpoints) and read local config (~/.openclaw/openclaw.json) and environment variables. The SKILL.md does not disclose that network calls will be made to external AI services or that it will attempt to read application config. The explicit use of exec to run packaged code increases the runtime surface and the instructions give the agent direct permission to run these scripts.
Install Mechanism
There is no install spec (instruction-only in registry), but the bundle contains many code files (Python and web assets). Because the code is packaged with the skill, nothing needs to be downloaded during install; that lowers installation risk. However, the package contains an API server (api_app.py), bot/push scripts (daily_push.py, tg_bot_handler.py), and web assets — more functionality than the SKILL.md calls out, which increases the potential for unexpected use if the user runs those files.
Credentials
Registry metadata lists no required env vars/config paths, yet ai_engine.py and other modules access DEEPSEEK_API_KEY and OPENAI_API_KEY environment variables and attempt to read ~/.openclaw/openclaw.json to extract a DeepSeek key. Requesting access to the user's OpenClaw config (which may contain other credentials) is a high-sensitivity action that is not justified or declared in SKILL.md. The code will send prompts and user birth data to external AI endpoints (DeepSeek/OpenAI) using these keys.
Persistence & Privilege
The skill does not set always: true and does not request special platform privileges. That said, the package includes an HTTP API (FastAPI app), Telegram handler, and scheduled push script — any of which could be launched by a user or agent run and would create persistent network-facing behavior. The SKILL.md does not instruct running the server, but presence of these components increases potential persistence if executed.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install yinian-zwds
  3. After installation, invoke the skill by name or use /yinian-zwds
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.1.0
Version 2.1.0 of yinian-zwds adds major enhancements to clarity, structure, and professional use: - Expanded skill documentation with full workflow for 紫微斗数排盘与解盘,三派合一三大流派(中州派/钦天门/紫云体系)特点说明。 - Added detailed user prompts and script execution guidance for both阳历/农历排盘。 - Included reference tables: 12宫结构、14主星简介、亮度体系、生年四化表。 - Defined输出规范、伦理提醒及AI身份声明要求,防止误用与隐私泄露。 - Organized technical文件目录、核心知识与自定义扩展说明,提升易用性和可维护性。
Metadata
Slug yinian-zwds
Version 2.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Yinian Zwds?

一念紫微斗数 (Yinian Zi Wei Dou Shu) — 专业AI紫微斗数排盘解盘系统。三派合一:三合派/飞星派/占验派。触发词:紫微斗数、紫微、命盘、排盘、ZWDS、ziwei、Purple Star. It is an AI Agent Skill for Claude Code / OpenClaw, with 53 downloads so far.

How do I install Yinian Zwds?

Run "/install yinian-zwds" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Yinian Zwds free?

Yes, Yinian Zwds is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Yinian Zwds support?

Yinian Zwds is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Yinian Zwds?

It is built and maintained by Vincent-VStudios (@vincent-vstudios); the current version is v2.1.0.

💬 Comments