destiny
A real fortune-telling skill for Claude Code.
Not a horoscope generator. The numbers are computed; only the interpretation is generative.
Quick start
Prerequisites
- Claude Code v2.0 or newer
- Check with
claude --version
- Update with
npm i -g @anthropic-ai/claude-code
- The
/plugin command must be available. On modern Claude Code it's on by default. If /plugin isn't recognized inside Claude Code, run /config and enable Plugins, then restart Claude Code.
Install (inside Claude Code)
/plugin marketplace add xodn348/destiny
/plugin install destiny@destiny-marketplace
/destiny
Install from terminal (fallback if /plugin isn't available)
claude plugin marketplace add xodn348/destiny
claude plugin install destiny@destiny-marketplace
Then launch Claude Code and run /destiny.
Verify
claude plugin list # should show: destiny@destiny-marketplace
That's it. The first /destiny call asks for your birth date, time, city, and gender — once. Every call after is just /destiny.
How it flows
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
What you get
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.
Example output
Real run from a sample profile (1992-07-31, Suwon). Same person + same day always produces identical script output; only the prose phrasing changes between calls.
How it works (the principles in 60 seconds)
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.
What's actually computed (vs. interpreted by Claude)
| Layer | Source |
|---|
| Your eight-character birth chart | lunar-python — pure-Python perpetual calendar |
| True solar time correction | longitude offset from local standard time meridian (1° = 4 min) |
| Korean DST handling (1987–88) | automatic |
| Today's day pillar | lunar-python |
| Five Elements + Ten Gods relationships | classical 60-cycle lookup tables |
| Branch harmonies, clashes, punishments | classical lookup tables |
| I-Ching hexagram for this moment | plum-blossom time divination |
| Hexagram corpus | King Wen ordering, Legge (1899) public-domain translation |
| Lucky number / color / direction | derived from your day-of-birth's element + the hexagram |
| Star ratings, character sketch, life arc, today's advice | Claude, applying classical reading conventions to the data above |