destiny

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