Agent skill

Astrology Analysis

by shizhilya in shizhilya/yuan

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

No licenceAuto-check passedResearch & Science

Install Astrology Analysis

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

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

GitHub CLI
$ gh skill install shizhilya/yuan astrology-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/western-astrology .claude/skills/astrology-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
astrology-analysis
GitHub stars
201
Token cost
~1.3k tokens
SKILL.md length
525 words
Files
18 (incl. scripts, references)
Skills in repo
6
Repo updated
First seen
Licence
None found

At a glance

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

  • Works in 5 steps: Normalize inputs → Compute chart → Analyze houses → …
  • Requests about planets
  • SKILL.md covers Scope, Core contract, Defaults and Hard rules, plus 6 more sections
  • Calls python

What it does

Astrology Analysis is an agent skill from shizhilya/yuan. Compute and interpret a Western tropical natal chart (birth chart / natal chart / 本命盘 / 星盘) from birth datetime and location. Use for requests about planets, signs, houses, aspects, or outputs grouped into personality, career, and relationships. Skip Vedic or sidereal unless explicitly requested, tarot, horary, Chinese astrology, daily horoscopes, or astronomy-only questions unrelated to a natal chart.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 21 other files, including scripts and reference files (for example `AGENTS.md`, `agents/openai.yaml` and `examples/prompt_examples.md`).

It sits in Research & Science, covering Physical and earth sciences. 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

  • Requests about planets
  • Outputs grouped into personality

Example prompts

  • “/astrology-analysis”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Normalize inputs
  2. Compute chart
  3. Analyze houses
  4. Analyze aspects
  5. Interpret

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.

Context cost

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

Always · name and description, kept in context so the agent knows when to use it
~106
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
~5.1k

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 525 words (~1,294 tokens).

“You are a Western astrology + astronomical calculation specialist.”

— opening of SKILL.md by shizhilya
name
astrology-analysis

Read the full SKILL.md on GitHub

Files

SKILL.md and 17 other files (scripts, references) in references/western-astrology of shizhilya/yuan.

  • SKILL.md
  • AGENTS.md
  • agents/openai.yaml
  • examples/prompt_examples.md
  • examples/sample_chart.json
  • examples/sample_input.json
  • examples/sample_reading.json
  • references/calculation-contract.md
  • references/house-meanings.md
  • references/input.schema.json
  • references/interpretation-rules.md
  • references/output.schema.json
  • references/planet-roles.md
  • references/sign-qualities.md
  • references/skill-manifest.json
  • requirements-optional.txt
  • scripts/README.md
  • … and 1 more

Open the folder on GitHubat commit c417ae7

Compare with similar skills

Astrology 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.

Astrology Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Astrology Analysis this skillshizhilya/yuan201—~1.3kAutomated safety check: PassNone
AstropyzLanqing/codex-claude-academic-skills4.7k13 repos~2.9kAutomated safety check: PassBSD-3-Clause
PymatgenzLanqing/codex-claude-academic-skills4.7k11 repos~5kAutomated safety check: PassMIT
Cantera Ignition DelayK-Dense-AI/scientific-agent-skills48k1 repos~2.2kAutomated safety check: PassMIT
Weathertrpc-group/trpc-agent-go1.9k8 repos~591Automated safety check: PassApache-2.0
Pymol VisualizationChatMol/ChatMol373—~1.2kAutomated safety check: PassMIT

Similar skills

  • Astropy

    zLanqing/codex-claude-academic-skills

    Comprehensive Python library for astronomy and astrophysics.

    4.7k GitHub starsUsed in 13 repos~2.9k tokens
    Research & ScienceAuto-check passed
  • Pymatgen

    zLanqing/codex-claude-academic-skills

    Materials science toolkit. An agent skill from zLanqing/codex-claude-academic-skills.

    4.7k GitHub starsUsed in 11 repos~5k tokens
    Research & ScienceAuto-check passed
  • Cantera Ignition Delay

    K-Dense-AI/scientific-agent-skills

    Runs Cantera constant-volume or constant-pressure ignition simulations and reports temperature-based ignition delay with mechanism provenance and checks.

    48k GitHub starsUsed in 1 repo~2.2k tokens
    Research & ScienceAuto-check passed
  • Weather

    trpc-group/trpc-agent-go

    Get current weather and forecasts via wttr.in or Open-Meteo.

    1.9k GitHub starsUsed in 8 repos~591 tokens
    Research & ScienceAuto-check passed
  • Pymol Visualization

    ChatMol/ChatMol

    Generate publication-quality molecular visualization images using PyMOL.

    373 GitHub stars~1.2k tokensUpdated 6 mo ago
    Research & ScienceAuto-check passed
  • Review

    Muuuun/luxas

    Write domain-authentic review articles that synthesize rather than stack.

    1.2k GitHub stars~2.1k tokensUpdated 1 mo ago
    Research & ScienceAuto-check passed

More from shizhilya/yuan

  • Ziwei Analysis

    shizhilya/yuan

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

    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 Astrology Analysis

What does Astrology Analysis do?

Compute and interpret a Western tropical natal chart (birth chart / natal chart / 本命盘 / 星盘) from birth datetime and location. Astrology Analysis is an agent skill from shizhilya/yuan. Compute and interpret a Western tropical natal chart (birth chart / natal chart / 本命盘 / 星盘) from birth datetime and location.

When should I use Astrology Analysis?

Astrology Analysis fits situations like: requests about planets; outputs grouped into personality.

How do I install Astrology Analysis in Claude Code?

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

How do I install Astrology Analysis in Codex?

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

Can I use Astrology 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 astrology-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/astrology-analysis, .gemini/skills/astrology-analysis, .github/skills/astrology-analysis and .opencode/skills/astrology-analysis in your project.

What does Astrology Analysis need to run?

Going by SKILL.md and its folder, Astrology Analysis needs the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Astrology 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 Astrology 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 Astrology Analysis use?

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

How many tokens does Astrology Analysis use?

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

What are the alternatives to Astrology Analysis?

Skills that share tags, products or a category with Astrology Analysis: Astropy (zLanqing/codex-claude-academic-skills, 4.7k stars), Pymatgen (zLanqing/codex-claude-academic-skills, 4.7k stars), Cantera Ignition Delay (K-Dense-AI/scientific-agent-skills, 48k stars) and Weather (trpc-group/trpc-agent-go, 1.9k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Astrology 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.