destiny

Generates personalized daily fortune and life readings from Four Pillars birth charts computed with lunar-python.

67|2|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/xodn348/destiny --skill destiny-xodn348
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: destiny
Source: https://github.com/xodn348/destiny/tree/main/skills/destiny
Command: npx skills add https://github.com/xodn348/destiny --skill destiny-xodn348

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lunar-python, and includes scripts (resource) components.

What problem does it solve? It turns a user's birth date, time, city, and gender into a deterministic East Asian fortune reading — a daily fortune plus a life reading — without requiring any knowledge of 사주, 명리, or I-Ching terminology. ## Core Features & Use Cases - Two-Section Readings: Produces a daily fortune (five-category stars, I-Ching hexagram, lucky number/color/direction) and a life reading (character, life arc, current decade) in plain prose. - Deterministic Computation: Computes Four Pillars charts, Ten Gods interactions, branch relations, and 매화역수 hexagrams via lunar-python, with true solar time and DST corrections. - Profile Persistence & Variants: Saves birth info to ~/.destiny/profile.json after first use; supports quick mode, language switching, couple compatibility (궁합) readings, and an optional SessionStart hook. - Use Case: A user types /destiny each morning to get a personalized fortune grounded in their actual birth chart, with identical script output for the same person and day. ## Quick Start Ask Claude to run /destiny and provide your birth date, time, city, and gender when prompted to receive your first personalized reading.

Frequently Asked Questions about destiny

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I get a personalized daily fortune reading in Claude Code?

Run /destiny inside Claude Code after installing the plugin. On first use it asks for your birth date, time, city, and gender, saves them to ~/.destiny/profile.json, and every later call produces a reading without re-asking.

What library computes the Four Pillars birth chart?

The reading.py script uses lunar-python to compute the Four Pillars chart, applying true solar time correction from birthplace longitude, Korean DST handling, and the 야자시 hour-pillar rule. Install it with python3 -m pip install lunar-python.

Can I get a fortune reading without giving my birth information?

Yes, use /destiny quick for a generic daily-only reading based on today's day pillar and an I-Ching hexagram. It skips the life reading section and stores no personal data.

Does the skill support couple compatibility readings?

Yes, /destiny compat with a partner's birth datetime, city, and gender runs the script in compat mode. It analyzes reciprocal day-master Ten Gods, branch relations, and five-element complementarity between the two charts.

Why does the same person get identical output on the same day?

All chart elements, star inputs, and the hexagram are computed deterministically from birth data and the current date via lunar-python. Only the prose phrasing written by the model varies between calls.

What are the limitations of the fortune readings?

Readings never predict accidents, illness, death, or breakups, and compatibility mode gives no numerical scores or verdicts. Unknown birth time skips the hour pillar, reducing chart precision.