← Back to Skills Marketplace
328
Downloads
5
Stars
0
Active Installs
13
Versions
Install in OpenClaw
/install yunshi
Description
MingLi is your all-in-one Chinese astrology and fortune-telling companion. It combines six ancient divination systems — BaZi (Four Pillars of Destiny), ZiWei...
Usage Guidance
What to consider before installing:
- Privacy: The skill stores PII (names, exact birth dates/times, birth places) in data/profiles/*.json. Ensure that directory is only readable by trusted users/processes and remove or anonymize sample profiles if needed.
- Test before enabling automation: Run scripts with --dry-run / --test first (daily-push.js has such flags). The included push-log.json shows errors like "zhiElement is not defined" — expect some implementation bugs; verify outputs for a few test profiles before enabling scheduled cron pushes.
- Note inconsistent paths: Some scripts reference data/users while most documentation references data/profiles. Confirm which directory your runtime will populate and that it matches your retention/backups.
- Supply-chain: The skill installs npm packages (iztro and lunar-related libs). If you require stricter risk posture, review the iztro package on the npm registry (maintainer, versions, recent vulnerabilities) or install in an isolated environment.
- Network / channels: SKILL.md states the runtime (OpenClaw) delivers push channels and the skill does not call external messaging APIs directly. Confirm your OpenClaw runtime enforces that (so messaging credentials remain managed at the platform level).
- Recommended actions: run the skill in a sandboxed agent, verify a dry-run push, inspect created data/profiles for any unexpected contents, and set a retention/deletion policy for stored profiles.
Capability Analysis
Type: OpenClaw Skill
Name: yunshi
Version: 1.2.2
The 'yunshi' skill is a comprehensive Chinese astrology toolset providing BaZi, ZiWei DouShu, and other divination systems. It manages user data locally in JSON files within the 'data/profiles' directory and utilizes OpenClaw's cron system to automate daily fortune pushes. The scripts (e.g., 'profile.js', 'register.js', 'ziwei.js') implement complex astrological logic without external API dependencies or evidence of data exfiltration. Security-conscious patterns, such as path sanitization and ID validation, are present in files like 'evening-push.js' and 'morning-push.js' to prevent directory traversal, and all behaviors align with the stated purpose of a personal astrology assistant.
Capability Assessment
Purpose & Capability
Name/description match the code and install: the skill implements BaZi, ZiWei, QiMen, I Ching, fengshui and daily pushes using local algorithms. The declared install (npm package 'iztro') and listed JavaScript scripts align with those capabilities. There are no unexpected credentials or unrelated binaries requested.
Instruction Scope
SKILL.md and the scripts instruct the agent to read/write profile files under data/profiles, generate push messages, and (optionally) use an OPENCLAW_KNOWLEDGE_DIR. That is expected for a personalization/push skill. Note: some scripts and docs refer to different data directories (SKILL.md/data uses data/profiles while scripts/evening-push.js uses data/users) and the included push-log.json shows runtime errors like "zhiElement is not defined" — these are implementation bugs (scope creep is not observed, but the inconsistencies could cause misbehavior).
Install Mechanism
Install uses npm (package 'iztro' and related dependencies listed in package-lock.json). This is a standard registry install (moderate risk typical for Node packages) and there are no downloads from arbitrary URLs or archive extracts in the manifest.
Credentials
The skill requests no secrets or cloud credentials (only an optional OPENCLAW_KNOWLEDGE_DIR). However it deliberately stores sensitive personal data (names, birthdates, birthtimes, places) in local JSON files (data/profiles/*.json). That data storage is proportionate to the service but is sensitive — users/operators should confirm filesystem access controls and retention/deletion policies before enabling live pushes.
Persistence & Privilege
always:false and no special platform privileges requested. The skill persists its own data under its skill directory (normal). It does not modify other skills or system-wide settings based on the provided files.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install yunshi - After installation, invoke the skill by name or use
/yunshi - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.2
yunshi 1.2.2 Changelog
- Updated package.json (details not specified).
- No functional, documentation, or interface changes observed in this version.
v1.2.1
**Yunshi 1.2.1 Changelog**
- Introduced English README and improved multi-language documentation.
- Added sample user profile data and new push notification scripts for morning and evening fortune delivery.
- Refined package configuration and updated usage description with clearer English skill summary.
- Cleaned up legacy files for streamlined maintenance.
v1.1.2
- 移除了对 lunar-typescript (农历转换) 的依赖，仅保留 iztro（紫微斗数）为必装模块
- 其他功能、说明和脚本保持不变
v1.1.1
- Package version bumped to 1.1.1.
- No functional changes; metadata update only.
v1.1.0
yunshi v1.1.0
- Initial public release with full BaZi, ZiWei, QiMen, Meihua, LiuYao, marriage compatibility, and feng shui capabilities, including built-in charting algorithms.
- Added automatic daily fortune push feature (morning "today's fortune" and evening "tomorrow's preview").
- Multi-language response support, with automatic language detection and terminology retention rules.
- User profile system for storing personalized data and customizing readings.
- Comprehensive command-line tools included for all supported astrology and divination features.
- Personal data securely stored in data/profiles; review privacy requirements before use.
v1.0.8
- Added package-lock.json to version control for reproducible npm dependency management.
v1.0.7
yunshi 1.0.7
- Documentation update in SKILL.md for improved clarity, organization, and usability.
- No changes to logic, functionality, runtime, or dependencies.
- All features and usage remain the same as previous version.
v1.0.6
yunshi v1.0.6
- 明确 Node.js 18+ 版本运行时要求，并在 metadata 内声明
- 详细说明环境变量 OPENCLAW_KNOWLEDGE_DIR 用途及可选性
- 增补各依赖/第三方渠道的使用权限与隐私说明，确保 skill 本体无额外数据上传或调用
- 优化本地知识库和推送机制相关描述，使依赖关系与回退策略更清晰
- 修正部分英文表述，提升文档规范性
v1.0.5
yunshi 1.0.4
- 新增用户档案示例文件：data/profiles/test001.json
- 支持更好地管理和演示用户档案数据结构
- 文档中新增 npm 依赖安装提示说明
v1.0.4
yunshi 1.0.1
- Added "环境依赖说明"，详细说明了本 skill 的 npm 依赖、知识库、新闻联动和每日推送环境需求。
- 明确注明各项依赖包（如 iztro、lunar-typescript）及可选外部资源/cron 环境。
- 提示网络搜索/新闻连接为可选能力，无搜索时自动降级内容输出。
- 其它说明、用法及功能描述保持一致，无功能或接口变更。
v1.0.3
yunshi 1.0.3
- No file changes detected in this version.
- No new features, fixes, or documentation updates introduced.
v1.0.1
yunshi 1.0.1
- No code or documentation changes detected in this version.
- Functionality, features, and usage remain unchanged from the previous release.
v1.0.0
YunShi 1.0.0 — Initial Release
- Provides daily fortune push, BaZi (Four Pillars), ZiWei DouShu charts, divination, marriage compatibility, and feng shui analysis.
- Supports multi-language responses; core terminology remains in Chinese with translations.
- Features customizable daily horoscope push (morning & evening), tailored to user preferences and real-time news events.
- Implements a comprehensive user profile, tracking interests and history for personalized readings.
- Includes various astrology and divination systems: BaZi, ZiWei, QiMen, Meihua, Liuyao, and feng shui tools.
- Offers risk warnings in areas like health, wealth, career, and relationships.
- Integrates with OpenClaw for scheduled, multi-platform message delivery.
Metadata
Frequently Asked Questions
What is Yunshi?
MingLi is your all-in-one Chinese astrology and fortune-telling companion. It combines six ancient divination systems — BaZi (Four Pillars of Destiny), ZiWei... It is an AI Agent Skill for Claude Code / OpenClaw, with 328 downloads so far.
How do I install Yunshi?
Run "/install yunshi" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Yunshi free?
Yes, Yunshi is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Yunshi support?
Yunshi is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Yunshi?
It is built and maintained by jiajiaoy (@jiajiaoy); the current version is v1.2.2.
More Skills