A real fortune-telling skill for Claude Code.
Not a horoscope generator. The numbers are computed; only the interpretation is generative.

/plugin marketplace add xodn348/destiny
/plugin install destiny@destiny-marketplace
/destiny

That's it. The first call asks for your birth date, time, city, and gender — once. Every call after is just /destiny.

Claude Code
   │
   ▼
destiny plugin            ← installed once via /plugin install
   │
   ▼
/destiny skill            ← invoked any time
   │
   ▼
your birth date           ← asked once, saved to ~/.destiny/profile.json
   │
   ▼
destiny of the day        ← personalized: today's fortune + life reading

Each /destiny produces a two-section reading:

🔮 Today's Fortune — a short prose reading of today against your birth chart, with five-category stars (overall, love, money, career, health), a hexagram drawn for this moment, and a lucky number / color / direction.

🌌 Life Reading — your character, the broad arc of your life, and where you are in your current 10-year period. Plain language, no untranslated jargon.

This skill uses three pieces of classical East Asian metaphysics, each computed deterministically from your birth date and time:

• Four Pillars (the eight-character birth chart) — Your year, month, day, and hour of birth each map to a pair of Chinese characters (one "Heavenly Stem" + one "Earthly Branch") drawn from a 60-cycle calendar that has run continuously for over two millennia. The eight characters together describe your "elemental fingerprint": which of the five elements (Wood / Fire / Earth / Metal / Water) dominate, which are missing, and how they relate. The character of your day-of-birth is your "core self".

• Perpetual lunar calendar — The engine that converts solar dates to the eight characters. It handles solar terms (the 24 climate divisions of the year), lunar/solar conversion, true-solar-time correction by birthplace longitude, and Korean Daylight Saving for births in 1987–88. Equivalent to the calendar published by Korea's national astronomical observatory.

• The I-Ching (Book of Changes) — A 3,000-year-old divination system of 64 hexagrams. We draw one hexagram for the present moment using plum-blossom time divination — an algorithm by the Song-dynasty scholar Shao Yong that derives the hexagram from the current lunar date and hour. Hexagram texts are from James Legge's 1899 public-domain translation.

The skill computes today's "day pillar" the same way and analyzes its relationship with your birth chart — five-element generation/control cycles, branch harmonies and clashes — to produce the reading.

Same person + same day always produces identical script output. Only the prose phrasing changes between calls.

No external APIs. No scraped sites. Everything runs locally.

• /destiny — full reading (auto-loads saved profile)
• /destiny today — only today's fortune
• /destiny life — only life reading
• /destiny reset — delete saved profile and start over
• /destiny in english|korean|japanese|chinese|spanish — switch language
• /destiny born YYYY-MM-DD HH:MM <city> <m|f> — one-off without saving
• /destiny quick — generic daily, no personal data

Most fortune apps either (a) compute the chart correctly but lock interpretation behind a paywall, or (b) let an LLM hallucinate the whole thing and call it astrology. This skill keeps the deterministic part deterministic — you can verify your eight characters against any traditional calendar source — and lets Claude do what it's actually good at: applying centuries-old reading conventions to that fixed data.

Default output is English with every classical term unpacked into plain language. A reader with zero exposure to East Asian astrology should follow it. Output switches to Korean / Japanese / Chinese / Spanish on request.

• Python 3.10+
• lunar-python (MIT) — pure-Python perpetual lunar calendar
• I-Ching: King Wen ordering + Legge (1899) public-domain judgments
• Claude Code plugin format

MIT