GitHub - xodn348/destiny: 오늘의 운세 — daily fortune Claude Code plugin (/destiny)
Pangram verdict · v3.3
We believe that this document is fully AI-generated
AI likelihood · overall
AIArticle text · 728 words · 3 segments analyzed
A real fortune-telling skill for Claude Code. Not a horoscope generator. The numbers are computed; only the interpretation is generative.
Quick start /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. 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. 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
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. Variants
/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
Why this exists 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. Stack
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
License MIT