Agent skill

Numerology Analysis

by shizhilya in shizhilya/yuan

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

No licenceAuto-check passed

Install Numerology Analysis

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

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

GitHub CLI
$ gh skill install shizhilya/yuan numerology-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/numerology .claude/skills/numerology-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
numerology-analysis
GitHub stars
201
Token cost
~1.2k tokens
SKILL.md length
560 words
Files
8 (incl. assets)
Skills in repo
6
Repo updated
First seen
Licence
None found

At a glance

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

  • Works in 7 steps: Normalize birthdate → Reduce function → Life path number → …
  • Numerology / 数字命理 / 生命路径数 / 姓名映射 requests and structured numerology JSON
  • SKILL.md covers 1) Normalize birthdate, 2) Reduce function, 3) Life path number and 4) Normalize name, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Numerology Analysis is an agent skill from shizhilya/yuan. Compute symbolic numerology from a person's name and birthdate using deterministic mappings only. Use for numerology / 数字命理 / 生命路径数 / 姓名映射 requests and structured numerology JSON. Do not use for predictive fortune-telling or non-symbolic advice.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including assets (for example `AGENTS.md`, `README.md` and `agents/openai.yaml`).

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

  • Numerology / 数字命理 / 生命路径数 / 姓名映射 requests and structured numerology JSON
  • Predictive fortune-telling
  • Non-symbolic advice

Example prompts

  • “/numerology-analysis”

Workflow steps

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

  1. Normalize birthdate
  2. Reduce function
  3. Life path number
  4. Normalize name
  5. Name mapping
  6. Name number
  7. Personality map

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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    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

Numerology Analysis loads about 1.2k tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 560 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~66
When it runs · the whole SKILL.md, loaded when a task matches
~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); 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 560 words (~1,178 tokens).

“Return a numerology analysis using only the symbolic rules in this skill. The result must be deterministic, reproducible, and limited to symbolic mappings.”

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

Read the full SKILL.md on GitHub

Files

SKILL.md and 7 other files (assets) in references/numerology of shizhilya/yuan.

  • SKILL.md
  • AGENTS.md
  • README.md
  • agents/openai.yaml
  • assets/example_input.json
  • assets/example_output.json
  • assets/output.schema.json
  • assets/spec.json

Open the folder on GitHubat commit c417ae7

Compare with similar skills

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

Numerology Analysis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Numerology Analysis this skillshizhilya/yuan201—~1.2kAutomated safety check: PassNone
Ito Computeaffaan-m/ECC277k1 repos~1.7kAutomated safety check: PassMIT
Math Computationtradecatlabs/vibe-coding-cn17k—~881Automated safety check: PassMIT
Senior Computer Visiondavila7/claude-code-templates33k2 repos~1.4kAutomated safety check: PassMIT
Senior Computer Visionalirezarezvani/claude-skills28k1 repos~3.2kAutomated safety check: PassMIT
GCP Computesickn33/agentic-awesome-skills47k2 repos~2.6kAutomated safety check: PassMIT

Similar skills

  • Ito Compute

    affaan-m/ECC

    Query live GPU inventory, submit an authenticated Itô fixed-rate RFQ, inspect RFQ or procurement status, revoke device credentials, and run explicitly gated node qualification through the separately…

    277k GitHub starsUsed in 1 repo~1.7k tokens
    Business, Finance & HRAuto-check passed
  • Math Computation

    tradecatlabs/vibe-coding-cn

    Runs reproducible math computations and counterexample searches with SymPy, NumPy and mpmath, logging evidence without presenting results as proofs.

    17k GitHub stars~881 tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Senior Computer Vision

    davila7/claude-code-templates

    World-class computer vision skill for image/video processing, object detection, segmentation, and visual AI systems.

    33k GitHub starsUsed in 2 repos~1.4k tokens
    AI & LLM EngineeringAuto-check passed
  • Senior Computer Vision

    alirezarezvani/claude-skills

    Computer vision engineering skill for object detection, image segmentation, and visual AI systems.

    28k GitHub starsUsed in 1 repo~3.2k tokens
    AI & LLM EngineeringAuto-check passed
  • GCP Compute

    sickn33/agentic-awesome-skills

    Manage Compute Engine instances and instance templates. An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~2.6k tokens
    DevOps & CloudAuto-check passed
  • Symbolic Computation Guide

    wentorai/research-plugins

    Computer algebra systems: SymPy, SageMath, and Mathematica for research

    298 GitHub starsUsed in 1 repo~1.7k tokens
    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
  • 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
  • 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 Numerology Analysis

What does Numerology Analysis do?

Compute symbolic numerology from a person's name and birthdate using deterministic mappings only. Numerology Analysis is an agent skill from shizhilya/yuan. Compute symbolic numerology from a person's name and birthdate using deterministic mappings only.

When should I use Numerology Analysis?

Numerology Analysis fits situations like: numerology / 数字命理 / 生命路径数 / 姓名映射 requests and structured numerology JSON; predictive fortune-telling; non-symbolic advice.

How do I install Numerology Analysis in Claude Code?

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

How do I install Numerology Analysis in Codex?

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

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

What does Numerology Analysis need to run?

SKILL.md names no scripts, command-line tools or credentials: Numerology Analysis is instructions for the agent only.

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

What licence does Numerology Analysis use?

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

How many tokens does Numerology Analysis use?

About 1.2k tokens (SKILL.md is roughly 4.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Numerology Analysis?

Skills that share tags, products or a category with Numerology Analysis: Ito Compute (affaan-m/ECC, 277k stars), Math Computation (tradecatlabs/vibe-coding-cn, 17k stars), Senior Computer Vision (davila7/claude-code-templates, 33k stars) and Senior Computer Vision (alirezarezvani/claude-skills, 28k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

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