Agent skill

Ziwei Analysis

by shizhilya in shizhilya/yuan

Perform structured Ziwei Dou Shu (紫微斗数 / Zi Wei Dou Shu) system design, chart interpretation, and implementation planning.

No licenceAuto-check passed

Install Ziwei Analysis

skills CLI
$ npx skills add shizhilya/yuan --skill ziwei-analysis -a claude-code

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

GitHub CLI
$ gh skill install shizhilya/yuan ziwei-analysis --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/shizhilya/yuan.git skills-src && mkdir -p .claude/skills && cp -r skills-src/references/ziwei .claude/skills/ziwei-analysis && 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-analysis
GitHub stars
201
Token cost
~1.3k tokens
SKILL.md length
240 words
Files
19 (incl. scripts, references, assets)
Skills in repo
6
Repo updated
First seen
Licence
None found

At a glance

Perform structured Ziwei Dou Shu (紫微斗数 / Zi Wei Dou Shu) system design, chart interpretation, and implementation planning.

  • Works in 4 steps: 先分模式,再执行 → 排盘是确定层,解读是经验层 → 绝不虚构星曜位置 → …
  • The user asks to build a Ziwei skill
  • SKILL.md covers 核心原则, 使用时机, 不使用的场景 and 输入合同, plus 7 more sections
  • Calls python

What it does

Ziwei Analysis is an agent skill from shizhilya/yuan. Perform structured Ziwei Dou Shu (紫微斗数 / Zi Wei Dou Shu) system design, chart interpretation, and implementation planning. Use when the user asks to build a Ziwei skill or engine, define palaces/stars/four-transformations/limits, interpret an existing chart JSON/table, or produce deterministic-vs-heuristic output. Do not use for birth-data-only personal readings unless verified chart facts or a deterministic chart engine are available.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 22 other files, including scripts, reference files and assets (for example `AGENTS.md`, `README.md` and `agents/openai.yaml`). Compatibility notes: Claude Code, Codex, OpenAI Skills, and Agent Skills-compatible clients. Optional helper scripts require Python 3. No bundled charting engine is included.

The repository describes itself as: Yuan (元) — a unified destiny-reading skill for Codex, Claude Code, and Agent Skills runtimes. One input surface, six methods (BaZi / Cheng Gu / Numerology / Western / Vedic / Zi…

When your agent uses it

  • The user asks to build a Ziwei skill
  • Define palaces/stars/four-transformations/limits
  • Interpret an existing chart JSON/table
  • Produce deterministic-vs-heuristic output

Example prompts

  • “/ziwei-analysis”

Requirements

  • Python 3
  • Compatibility (from SKILL.md): Claude Code, Codex, OpenAI Skills, and Agent Skills-compatible clients. Optional helper scripts require Python 3. No bundled charting engine is included.

Workflow steps

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

  1. 先分模式,再执行
  2. 排盘是确定层,解读是经验层
  3. 绝不虚构星曜位置
  4. 显式处理歧义

What it can do on your machine

Read from SKILL.md and the folder at commit c417ae7. 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/, which the agent can run.

    Shell commands in SKILL.md call:

    • python

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

  • Network

    No URLs in SKILL.md.

    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.

  • Compatibility

    Claude Code, Codex, OpenAI Skills, and Agent Skills-compatible clients. Optional helper scripts require Python 3. No bundled charting engine is included.

    From compatibility in the SKILL.md frontmatter.

Context cost

Ziwei Analysis loads about 1.3k tokens when it runs, and up to ~2.2k if it reads all its reference files. Until then it costs about 114 tokens; SKILL.md has 240 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~114
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~2.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

Without a licence we can't republish the file, so here is its outline and opening line. It has 240 words (~1,343 tokens).

name
ziwei-analysis
compatibility
Claude Code, Codex, OpenAI Skills, and Agent Skills-compatible clients. Optional helper scripts require Python 3. No bundled charting engine is included.
metadata.author
custom
metadata.version
1.0.0
metadata.locale
zh-CN
metadata.domain
ziwei-doushu
metadata.mode
design-interpretation

Read the full SKILL.md on GitHub

Files

SKILL.md and 18 other files (scripts, references, assets) in references/ziwei of shizhilya/yuan.

  • SKILL.md
  • AGENTS.md
  • README.md
  • agents/openai.yaml
  • assets/chart-facts-schema.json
  • assets/config-example.json
  • assets/input-schema.json
  • assets/output-template.json
  • assets/rules-structure.json
  • examples/birth-data-request.md
  • examples/design-request.md
  • examples/discovery-snippets.md
  • examples/interpret-chart-request.md
  • references/DOMAIN_MODEL.md
  • references/LIMITS_AND_GUARDRAILS.md
  • references/WORKFLOW.md
  • scripts
  • … and 2 more

Open the folder on GitHubat commit c417ae7

Compare with similar skills

Ziwei Analysis 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 Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Ziwei Analysis this skillshizhilya/yuan201—~1.3kAutomated safety check: PassNone
React Performanceaffaan-m/ECC277k1 repos~4.5kAutomated safety check: PassMIT
Performance Profileralirezarezvani/claude-skills28k—~684Automated safety check: PassMIT
Agent Performance Optimizerruvnet/ruflo74k2 repos~3.6kAutomated safety check: PassMIT
Handsontable Performance Testinghandsontable/handsontable22k—~3.4kAutomated safety check: PassCustom licence
Performance Managementsickn33/agentic-awesome-skills47k1 repos~4.1kAutomated safety check: PassMIT

Similar skills

  • React Performance

    affaan-m/ECC

    React and Next.js performance optimization patterns adapted from Vercel Engineering's React Best Practices (https://github.com/vercel-labs/agent-skills).

    277k GitHub starsUsed in 1 repo~4.5k tokens
    DevelopmentAuto-check passed
  • Performance Profiler

    alirezarezvani/claude-skills

    Systematic performance profiling for Node.js, Python, and Go applications.

    28k GitHub stars~684 tokensUpdated 1 mo ago
    DevelopmentAuto-check passed
  • Agent skill for performance-optimizer - invoke with $agent-performance-optimizer

    74k GitHub starsUsed in 2 repos~3.6k tokens
    Auto-check passed
  • Handsontable Performance Testing

    handsontable/handsontable

    Guide to Handsontable's performance-tests package: Playwright scenarios measured through CDP traces and compared against golden baselines taken from the develop branch.

    22k GitHub stars~3.4k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Performance Management

    sickn33/agentic-awesome-skills

    Performance review register: review type, period, employee and reviewer, KPI, OKR and behaviour scores, overall rating, PIP and promotion flags, development plan.

    47k GitHub starsUsed in 1 repo~4.1k tokens
    Business, Finance & HRAuto-check passed
  • Performance

    udecode/plate

    Review performance lanes with GitHub-scale tactics not owned by Vercel React rules: cohort segmentation, repeated-unit budgets, interaction-level INP, memory tagging, degradation contracts, browser…

    17k GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed

More from shizhilya/yuan

  • Astrology Analysis

    shizhilya/yuan

    Compute and interpret a Western tropical natal chart (birth chart / natal chart / 本命盘 / 星盘) from birth datetime and location.

    201 GitHub stars~1.3k tokensUpdated 5 mo ago
    Auto-check passed
  • Vedic Analysis

    shizhilya/yuan

    使用传统吠陀占星(Vedic astrology)流程“星盘 → Nakshatra → Vimshottari Dasha”分析出生信息,输出只含“业力”和“阶段”的结构化 JSON。Use when a user asks for Vedic astrology, Nakshatra, Janma Nakshatra, Dasha, Vimshottari, karmic themes…

    201 GitHub stars~877 tokensUpdated 5 mo ago
    Auto-check passed
  • Yuan

    shizhilya/yuan

    A skill your agent uses when the user asks for Yuan, 元, Great Origin, 玄学, 算命, 命理, 八字, 称骨, 紫微斗数, 数字命理, western astrology, Vedic astrology, or a combined destiny reading.

    201 GitHub stars~970 tokensUpdated 5 mo ago
    Auto-check passed
  • Numerology Analysis

    shizhilya/yuan

    Compute symbolic numerology from a person's name and birthdate using deterministic mappings only.

    201 GitHub stars~1.2k tokensUpdated 5 mo ago
    Auto-check passed
  • Chenggu Analysis

    shizhilya/yuan

    Structured Chinese Chenggu (“bone weight”) fortune analysis for 称骨算命 / 袁天罡称骨 tasks.

    201 GitHub stars~663 tokensUpdated 5 mo ago
    Auto-check passed

Questions about Ziwei Analysis

What does Ziwei Analysis do?

Perform structured Ziwei Dou Shu (紫微斗数 / Zi Wei Dou Shu) system design, chart interpretation, and implementation planning. Ziwei Analysis is an agent skill from shizhilya/yuan. Perform structured Ziwei Dou Shu (紫微斗数 / Zi Wei Dou Shu) system design, chart interpretation, and implementation planning.

When should I use Ziwei Analysis?

Ziwei Analysis fits situations like: the user asks to build a Ziwei skill; define palaces/stars/four-transformations/limits; interpret an existing chart JSON/table; produce deterministic-vs-heuristic output.

How do I install Ziwei Analysis in Claude Code?

Run `npx skills add shizhilya/yuan --skill ziwei-analysis -a claude-code`. Or copy the skill folder (references/ziwei in shizhilya/yuan) into .claude/skills/ziwei-analysis in your project. Claude Code loads it when a task matches its description.

How do I install Ziwei Analysis in Codex?

Run `npx skills add shizhilya/yuan --skill ziwei-analysis -a codex`. Or copy the skill folder (references/ziwei in shizhilya/yuan) into .agents/skills/ziwei-analysis in your project. Codex loads it when a task matches its description.

Can I use Ziwei Analysis 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 shizhilya/yuan --skill ziwei-analysis -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-analysis, .gemini/skills/ziwei-analysis, .github/skills/ziwei-analysis and .opencode/skills/ziwei-analysis in your project.

What does Ziwei Analysis need to run?

Going by SKILL.md and its folder, Ziwei Analysis needs the command-line tools its instructions call (python). Our summary lists: Python 3. Compatibility (from SKILL.md): Claude Code, Codex, OpenAI Skills, and Agent Skills-compatible clients. Optional helper scripts require Python 3. No bundled charting engine is included..

Does Ziwei Analysis access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Ziwei Analysis 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 Analysis use?

No licence was found for Ziwei Analysis or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Ziwei Analysis use?

About 1.3k tokens (SKILL.md is roughly 5.4k 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 824 tokens, read only when the agent opens those files.

What are the alternatives to Ziwei Analysis?

Skills that share tags, products or a category with Ziwei Analysis: React Performance (affaan-m/ECC, 277k stars), Performance Profiler (alirezarezvani/claude-skills, 28k stars), Agent Performance Optimizer (ruvnet/ruflo, 74k stars) and Handsontable Performance Testing (handsontable/handsontable, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Ziwei Analysis?

shizhilya (a GitHub user) maintains it in shizhilya/yuan, which has 201 GitHub stars. The repository holds 6 skills in this directory. The repository was last updated on April 27, 2026.

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