Agent skill

Yuan

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

No licenceAuto-check passed

Install Yuan

skills CLI

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

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

GitHub CLI

$ gh skill install shizhilya/yuan yuan --agent claude-code

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

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

Paste into Claude Code

Install the "yuan" agent skill from https://github.com/shizhilya/yuan/tree/main into .claude/skills/yuan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yuan", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add shizhilya/yuan --skill yuan -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install shizhilya/yuan yuan --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "yuan" agent skill from https://github.com/shizhilya/yuan/tree/main into .agents/skills/yuan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yuan", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add shizhilya/yuan --skill yuan -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install shizhilya/yuan yuan --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "yuan" agent skill from https://github.com/shizhilya/yuan/tree/main into .cursor/skills/yuan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yuan", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add shizhilya/yuan --skill yuan -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install shizhilya/yuan yuan --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "yuan" agent skill from https://github.com/shizhilya/yuan/tree/main into .gemini/skills/yuan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yuan", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install shizhilya/yuan yuan

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add shizhilya/yuan --skill yuan -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "yuan" agent skill from https://github.com/shizhilya/yuan/tree/main into .github/skills/yuan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yuan", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add shizhilya/yuan --skill yuan -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install shizhilya/yuan yuan --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "yuan" agent skill from https://github.com/shizhilya/yuan/tree/main into .opencode/skills/yuan/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "yuan", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: yuan
GitHub stars: 201
Token cost: ~970 tokens
SKILL.md length: 186 words
Files: 17 (incl. references)
Skills in repo: 6
Repo updated: Apr 27, 2026
First seen: Oct 7, 2026
Licence: None found

At a glance

Works in 3 steps: 姓名和性别 → 出生年月日时分 → 出生地点
The user asks for Yuan
SKILL.md covers 启动问询, 统一输入, 六法参考 and 执行流程, plus 2 more sections
Runs Python scripts from its folder

What it does

Yuan is an agent skill from shizhilya/yuan. Use when the user asks for Yuan, 元, Great Origin, 玄学, 算命, 命理, 八字, 称骨, 紫微斗数, 数字命理, western astrology, Vedic astrology, or a combined destiny reading. First collect name/gender, birth date/time, birthplace, and calendar type; then use the runnable reference methods under references, render either a conservative synthesis or a direct reading, and support a five-year fortune window centered on the current year.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. The skill folder holds 20 other files, including reference files (for example `AGENTS.md`, `README-CN.md` and `README.md`).

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 for Yuan
Western astrology
Vedic astrology
A combined destiny reading

Example prompts

“/yuan”

Requirements

Python 3

Workflow steps

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

姓名和性别
出生年月日时分
出生地点

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 script files (Python), which the agent can run.
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

Yuan loads about 970 tokens when it runs, and up to ~32k if it reads all its reference files. Until then it costs about 104 tokens; SKILL.md has 186 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

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

name: yuan

Read the full SKILL.md on GitHub

Files

SKILL.md and 16 other files (references) in the repository root of shizhilya/yuan.

SKILL.md
AGENTS.md
README-CN.md
README.md
agents/AGENTS.md
agents/openai.yaml
references/AGENTS.md
references/bazi/AGENTS.md
references/bazi/README.md
references/bazi/bazi_analysis_skill.json
references/bazi/bazi_analysis_skill.yaml
references/bazi/bazi_skill_engine.py
references/bazi/bazi_skill_spec.docx
references/bazi/examples/sample_output.json
references/bazi/examples/sample_request.json
references/bazi/manifest.txt
references/bazi/requirements.txt

Open the folder on GitHubat commit c417ae7

Compare with similar skills

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

Yuan compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Yuan this skillshizhilya/yuan	201	—	~970	Automated safety check: Pass	None	5 mo ago
Cross Origin Securitythedaviddias/Front-End-Checklist	74k	—	~595	Automated safety check: Pass	MIT	4 days ago
Cross Origin Isolationthedaviddias/Front-End-Checklist	74k	—	~565	Automated safety check: Pass	MIT	4 days ago
Origin APIcursor/plugins	11k	—	~694	Automated safety check: Pass	MIT	yesterday
Port GitHub App To Origincursor/plugins	11k	—	~1.3k	Automated safety check: Pass	MIT	today
Exploring MCP Tool Original User MotivePostHog/posthog	40k	—	~9.4k	Automated safety check: Notes	Custom licence	today

Similar skills

Cross Origin Security
thedaviddias/Front-End-Checklist
A skill your agent uses when reviewing scripts, client components, bundles, or runtime behavior related to Handle cross-origin requests securely.
74k GitHub stars~595 tokensUpdated 4 days ago
Auto-check passed
Cross Origin Isolation
thedaviddias/Front-End-Checklist
A skill your agent uses when reviewing security-sensitive web apps, SharedArrayBuffer usage, worker-heavy apps, editors, or measurement features that require cross-origin isolation.
74k GitHub stars~565 tokensUpdated 4 days ago
Auto-check passed
Origin API
cursor/plugins
Official
Routes questions about the Cursor Origin API to the right section of the Origin docs and names the few rules to check first.
11k GitHub stars~694 tokensUpdated yesterday
Backend & APIsAuto-check passed
Port GitHub App To Origin
cursor/plugins
Official
Plans the port of an existing GitHub App to a Cursor Origin App.
11k GitHub stars~1.3k tokensUpdated today
Backend & APIsAuto-check passed
Exploring MCP Tool Original User Motive
PostHog/posthog
Official
Build a starting-point taxonomy for an MCP tool — what users were trying to accomplish before they reached the tool — and publish it as a PostHog notebook.
40k GitHub stars~9.4k tokensUpdated today
Agent WorkflowsAuto-check: notes
Origin Ip Discovery
uphiago/recon-skills
Discover origin IPs behind CDN/WAF via favicon hash, DNS history, and SSL certs.
1.3k GitHub stars~1.7k tokensUpdated 1 mo ago
SecurityAuto-check passed

Questions about Yuan

What does Yuan do?

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

When should I use Yuan?

Yuan fits situations like: the user asks for Yuan; western astrology; vedic astrology; A combined destiny reading.

How do I install Yuan in Claude Code?

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

How do I install Yuan in Codex?

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

Can I use Yuan 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 yuan -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/yuan, .gemini/skills/yuan, .github/skills/yuan and .opencode/skills/yuan in your project.

What does Yuan need to run?

Going by SKILL.md and its folder, Yuan needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Yuan 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 Yuan 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. Review the folder before installing.

What licence does Yuan use?

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

How many tokens does Yuan use?

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

What are the alternatives to Yuan?

Skills that share tags, products or a category with Yuan: Cross Origin Security (thedaviddias/Front-End-Checklist, 74k stars), Cross Origin Isolation (thedaviddias/Front-End-Checklist, 74k stars), Origin API (cursor/plugins, 11k stars) and Port GitHub App To Origin (cursor/plugins, 11k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Yuan?

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.

Yuan

Install Yuan

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Files

Compare with similar skills

Similar skills

Cross Origin Security

Cross Origin Isolation

Origin API

Port GitHub App To Origin

Exploring MCP Tool Original User Motive

Origin Ip Discovery

More from shizhilya/yuan

Ziwei Analysis

Astrology Analysis

Vedic Analysis

Numerology Analysis

Chenggu Analysis

Questions about Yuan