Agent skill

Ziwei Doushu

by rongxinzy in rongxinzy/RongxinAI

Professional Ziwei Doushu consultation skill with an offline calculation engine.

AGPL-3.0Auto-check passed

Install Ziwei Doushu

skills CLI
$ npx skills add rongxinzy/RongxinAI --skill ziwei-doushu -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rongxinzy/RongxinAI ziwei-doushu --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rongxinzy/RongxinAI.git skills-src && mkdir -p .claude/skills && cp -r skills-src/SKILLs/zhiyuan-expert-manager/presets/fortune-consultant/skills/ziwei-doushu .claude/skills/ziwei-doushu && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ziwei-doushu
GitHub stars
154
Token cost
~746 tokens
SKILL.md length
322 words
Files
5 (incl. scripts, references)
Skills in repo
94
Repo updated
First seen
Licence
AGPL-3.0

At a glance

Professional Ziwei Doushu consultation skill with an offline calculation engine.

  • Works in 5 steps: Confirm Gregorian birth date, local… → Convert local birth time to the standard… → Install the local dependency once in… → …
  • Life palace structure
  • SKILL.md covers Required Workflow, Parameters, Calculation Standard and Deliverables, plus 3 more sections
  • Runs JavaScript scripts from its folder; calls npm and node

What it does

Ziwei Doushu is an agent skill from rongxinzy/RongxinAI. Professional Ziwei Doushu consultation skill with an offline calculation engine. Use for life palace structure, twelve palaces, four transformations, major luck cycles, yearly triggers, and a clear split between chart facts and traditional interpretation.

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `package.json`, `references/interpretation-framework.md` and `references/mapping.md`).

The repository describes itself as: An all-in-one local AI Agent workspace with a fully self-developed stack. The licence is AGPL-3.0.

When your agent uses it

  • Life palace structure
  • Four transformations
  • Major luck cycles
  • Yearly triggers

Example prompts

  • “/ziwei-doushu”

Requirements

  • Node.js

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Confirm Gregorian birth date, local birth time, gender convention, birthplace, and timezone.
  2. Convert local birth time to the standard two-hour branch index and record the conversion.
  3. Install the local dependency once in this Skill directory
  4. Run the offline engine from this Skill directory
  5. Preserve the JSON output as the calculation record, then interpret it with the references listed below.

What it can do on your machine

Read from SKILL.md and the folder at commit 31b424a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (JavaScript), which the agent can run.

    Shell commands in SKILL.md call:

    • npm
    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Ziwei Doushu loads about 746 tokens when it runs, and up to ~1.2k if it reads all its reference files. Until then it costs about 67 tokens; SKILL.md has 322 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~67
When it runs · the whole SKILL.md, loaded when a task matches
~746
With references · SKILL.md plus every file in references/, read only if the agent opens them
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from rongxinzy/RongxinAI at commit 31b424a, republished under its AGPL-3.0 licence (© rongxinzy). 322 words, ~746 tokens.

Download SKILL.mdSave it as .claude/skills/ziwei-doushu/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
ziwei-doushu
description
Professional Ziwei Doushu consultation skill with an offline calculation engine. Use for life palace structure, twelve palaces, four transformations, major luck cycles, yearly triggers, and a clear split between chart facts and traditional interpretation.

Ziwei Doushu

Generate a professional Ziwei Doushu reading with a clear split between chart facts, traditional interpretation, and practical trend summaries.

Required Workflow

  1. Confirm Gregorian birth date, local birth time, gender convention, birthplace, and timezone.
  2. Convert local birth time to the standard two-hour branch index and record the conversion.
  3. Install the local dependency once in this Skill directory:
bash
npm install --no-audit --no-fund
  1. Run the offline engine from this Skill directory:
bash
node scripts/ziwei_engine_js.mjs --date 1990-10-21 --time-index 8 --gender female --year 2026 --anchor-date 2026-01-01
  1. Preserve the JSON output as the calculation record, then interpret it with the references listed below.

Parameters

  • --date YYYY-MM-DD: Gregorian birth date.
  • --time-index 0-11: two-hour branch index; 0 is 子时, 1 is 丑时, through 11 for 亥时.
  • --gender male|female|男|女: gender convention used by the engine.
  • --year YYYY: optional target year.
  • --anchor-date YYYY-MM-DD: required with --year for annual triggers.

Calculation Standard

  • Calendar input: Gregorian date.
  • Time input: explicit branch index derived from local time.
  • Engine: local iztro JavaScript runtime.
  • Output: structured JSON on stdout.
  • If daylight saving, timezone, or branch-boundary handling is uncertain, state the uncertainty and calculate alternatives when it can change the result.

Deliverables

Include:

  1. Calculation standard and normalized inputs.
  2. Chart facts: 命宫、身宫、十二宫、主星组合、三方四正、四化、大限和流年触发。
  3. Interpretation framework: robust signals, timing-sensitive areas, and conflicting indicators.
  4. Practical summary: career, relationships, money, energy management, and current-year focus.

Output Guardrails

  • Separate chart facts from traditional interpretation.
  • Present conclusions as trends and structures, never deterministic destiny claims.
  • Make calculation conventions visible.
  • If the engine fails, report the error and stop rather than estimating from memory.
  • Do not treat this output as medical, legal, financial, or investment advice.

Optional HTML Visualization

Use the engine JSON to render a standalone responsive HTML file when requested:

  • deep blue background #0a0e2a;
  • purple highlight #a890ff and silver text #e8e4ff;
  • transformations: 禄 #ffd66e, 权 #ff8eb8, 科 #6ee0d6, 忌 #b8b4c8;
  • put 命、身、大限、流年 badges inline beside palace names;
  • never use absolutely positioned badges that can cover text.

HTML visualization is optional and must not gate the textual report.

References

  • references/mapping.md
  • references/interpretation-framework.md

© rongxinzy, AGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts, references) in SKILLs/zhiyuan-expert-manager/presets/fortune-consultant/skills/ziwei-doushu of rongxinzy/RongxinAI.

  • SKILL.md
  • package.json
  • references/interpretation-framework.md
  • references/mapping.md
  • scripts/ziwei_engine_js.mjs

Open the folder on GitHubat commit 31b424a

Compare with similar skills

Ziwei Doushu next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Ziwei Doushu compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ziwei Doushu this skillrongxinzy/RongxinAI154—~746Automated safety check: PassAGPL-3.0
Ziwei Doushuinfometa/workbuddyskills348—~790Automated safety check: PassNone
Ziwei DoushuFANzR-arch/Numerologist_skills1.4k1 repos~1.1kAutomated safety check: PassNone
Design Consultationgarrytan/gstack136k—~16kAutomated safety check: NotesMIT
Pua Offlinetanweai/pua20k—~143Automated safety check: PassMIT
Design Consultationnexu-io/open-design100k—~313Automated safety check: PassApache-2.0

Similar skills

  • Ziwei Doushu

    infometa/workbuddyskills

    Professional Ziwei Doushu consultation skill with offline, Beijing-standard calculation rules.

    348 GitHub stars~790 tokensUpdated yesterday
    Auto-check passed
  • Ziwei Doushu

    FANzR-arch/Numerologist_skills

    紫微斗数专业排盘与解盘技能。当用户提到紫微斗数、紫微排盘、紫微命盘、命宫、 十二宫、主星、四化、大限、流年、斗数格局、飞星、三方四正、紫微星、天机星、 太阳星、武曲星、天同星、廉贞星、天府星、太阴星、贪狼星、巨门星、天相星、 天梁星、七杀星、破军星等相关内容时触发此技能。也适用于用户想了解自己的命运、 性格、事业、婚姻、财运等,且明确要求或暗示使用紫微斗数体系的场景。包含完整的…

    1.4k GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Design Consultation

    garrytan/gstack

    Learns about your product, studies the landscape and writes a DESIGN.md with a full design system covering type, color, layout, spacing and motion.

    136k GitHub stars~16k tokensUpdated today
    Frontend & DesignAuto-check: notes
  • Pua Offline

    tanweai/pua

    PUA offline alias for Codex. An agent skill from tanweai/pua.

    20k GitHub stars~143 tokensUpdated 1 mo ago
    Auto-check passed
  • Design Consultation

    nexu-io/open-design

    Build a complete design system from scratch with creative risks and realistic product mockups.

    100k GitHub stars~313 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Consulting Analysis

    bytedance/deer-flow

    A skill your agent uses when the user requests to generate, create, or write professional research reports including but not limited to market analysis, consumer insights, brand analysis, financial…

    84k GitHub starsUsed in 4 repos~8.4k tokens
    Marketing & SEOAuto-check passed

More from rongxinzy/RongxinAI

All 94 skills in this repo
  • SaaS Metrics Coach

    rongxinzy/RongxinAI

    SaaS financial health advisor. An agent skill from rongxinzy/RongxinAI.

    154 GitHub starsUsed in 2 repos~1.3k tokens
    Auto-check passed
  • Churn Prevention

    rongxinzy/RongxinAI

    Reduce voluntary and involuntary churn through cancel flow design, save offers, exit surveys, and dunning sequences.

    154 GitHub starsUsed in 3 repos~2.6k tokens
    Auto-check passed
  • Presentation Studio

    rongxinzy/RongxinAI

    The only skill for creating a new PowerPoint deck. An agent skill from rongxinzy/RongxinAI.

    154 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Zhiyuan Expert Manager

    rongxinzy/RongxinAI

    ZhiYuan Agent expert package lifecycle manager for the pi engine.

    154 GitHub stars~1.9k tokensUpdated yesterday
    Auto-check passed
  • Lark Mail

    rongxinzy/RongxinAI

    飞书邮箱:Use when user mentions 起草邮件、写邮件、草稿、发送/回复/转发邮件、查阅邮件、看邮件、搜索邮件、邮件文件夹、邮件标签、邮件联系人、监听新邮件、邮件收信规则等;use for mail/email intent only.

    154 GitHub starsUsed in 3 repos~4.1k tokens
    Auto-check: warnings
  • Cantian Bazi

    rongxinzy/RongxinAI

    以命理场景为主的八字排盘、黄历查询与大运/流年/流月/流日/流时区间查询技能。用于用户请求“算八字”“四柱排盘”“阳历/农历转八字”“查黄历/宜忌”“查未来10年流年”“查下个月流日/流时”等场景;关键词包括:八字、四柱、命理、大运、流年、流月、流日、流时、时辰、阳历转八字、农历转八字、黄历、宜忌、干支日期。真太阳时换算属于辅助能力,仅在需要校时定盘时使用。

    154 GitHub starsUsed in 1 repo~2.1k tokens
    Auto-check passed

Questions about Ziwei Doushu

What does Ziwei Doushu do?

Professional Ziwei Doushu consultation skill with an offline calculation engine. Ziwei Doushu is an agent skill from rongxinzy/RongxinAI. Professional Ziwei Doushu consultation skill with an offline calculation engine.

When should I use Ziwei Doushu?

Ziwei Doushu fits situations like: life palace structure; four transformations; major luck cycles; yearly triggers.

How do I install Ziwei Doushu in Claude Code?

Run `npx skills add rongxinzy/RongxinAI --skill ziwei-doushu -a claude-code`. Or copy the skill folder (SKILLs/zhiyuan-expert-manager/presets/fortune-consultant/skills/ziwei-doushu in rongxinzy/RongxinAI) into .claude/skills/ziwei-doushu in your project. Claude Code loads it when a task matches its description.

How do I install Ziwei Doushu in Codex?

Run `npx skills add rongxinzy/RongxinAI --skill ziwei-doushu -a codex`. Or copy the skill folder (SKILLs/zhiyuan-expert-manager/presets/fortune-consultant/skills/ziwei-doushu in rongxinzy/RongxinAI) into .agents/skills/ziwei-doushu in your project. Codex loads it when a task matches its description.

Can I use Ziwei Doushu in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rongxinzy/RongxinAI --skill ziwei-doushu -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ziwei-doushu, .gemini/skills/ziwei-doushu, .github/skills/ziwei-doushu and .opencode/skills/ziwei-doushu in your project.

What does Ziwei Doushu need to run?

Going by SKILL.md and its folder, Ziwei Doushu needs JavaScript for the scripts in its folder and the command-line tools its instructions call (npm and node). Our summary lists: Node.js.

Does Ziwei Doushu access the network?

SKILL.md contains no URLs. Its commands use npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Ziwei Doushu safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Ziwei Doushu use?

Ziwei Doushu is published under the AGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Ziwei Doushu use?

About 746 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 497 tokens, read only when the agent opens those files.

What are the alternatives to Ziwei Doushu?

Skills that share tags, products or a category with Ziwei Doushu: Ziwei Doushu (infometa/workbuddyskills, 348 stars), Ziwei Doushu (FANzR-arch/Numerologist_skills, 1.4k stars), Design Consultation (garrytan/gstack, 136k stars) and Pua Offline (tanweai/pua, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ziwei Doushu?

rongxinzy (a GitHub organization) maintains it in rongxinzy/RongxinAI, which has 154 GitHub stars. The repository holds 94 skills in this directory. The repository was last updated on October 10, 2026.

Source: rongxinzy/RongxinAI on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.