saju-reading

Generates Korean saju fortune readings from deterministic calendar engine calculations with action plans.

1|Updated Jun 11, 2026
One-click install
npx skills add https://github.com/davidchoi0313/samsin-saju --skill saju-reading-davidchoi0313
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: saju-reading
Source: https://github.com/davidchoi0313/samsin-saju/tree/main/plugins/samsin-saju/skills/saju-reading
Command: npx skills add https://github.com/davidchoi0313/samsin-saju --skill saju-reading-davidchoi0313

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? It turns traditional Korean Four Pillars (saju) astrology into consistent, reproducible readings by computing the calendar chart with a deterministic engine first, then interpreting only the computed values, so users get grounded entertainment readings plus concrete daily actions instead of vague fortune-telling. ## Core Features & Use Cases - Deterministic manseryeok engine: Runs scripts/saju_engine.py to compute pillars, five elements, ten gods, major luck cycles, annual/monthly fortune, shinsal, yongshin candidates, tojeong numbers, and compatibility cards from birth date, time, calendar type, and gender. - 15 routed reading menus: Covers lifetime reading, yearly fortune, compatibility, past-life and ghost symbolic stories, yongshin, career, love, tojeong, shinsal, decade luck, daily fortune, health rhythm, business partnership, and fair structured hiring questions. - Action-oriented output contract: Every reading ends with a 10-minute action, a weekly experiment, and a 7-day review, plus fixed disclaimers and safety guards against medical, financial, and hiring decisions. - Use Case: A user says "1990년 3월 5일 오전 7시 남자 평생사주 봐줘" and receives a computed chart, a plain-language interpretation of strengths and overuse patterns, and a small experiment to try this week. ## Quick Start Ask the assistant to read your saju by providing your solar or lunar birth date, birth time (or unknown), and gender, for example by saying "1990년 3월 15일 오전 7시생 남자 평생사주 봐줘".

Frequently Asked Questions about saju-reading

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

FAQPage Schema
How do I get a saju reading from my birth date?

Provide your solar or lunar birth date, birth time (or state that it is unknown), and gender in one message. The skill runs its Python engine to compute the Four Pillars chart, then returns a full interpretation with action suggestions without asking follow-up questions.

What types of Korean fortune readings does this skill support?

It supports fifteen menus: lifetime reading, yearly fortune, compatibility, symbolic ghost and past-life stories, yongshin, career, love and marriage, tojeong, shinsal, decade luck cycles, daily fortune, health rhythm, business partnership, and fair hiring question generation.

Does the saju engine work for people born outside Korea?

The engine assumes birth in Korea and corrects to true solar time based on the 135°E standard meridian. For overseas births, year, month, and day pillars remain usable, but hour-pillar interpretations may be off and the skill discloses that limitation.

Can saju compatibility results be used for hiring or business decisions?

No. The skill explicitly refuses to produce pass/fail judgments, scores, rankings, or investment decisions. For hiring it only generates identical structured interview questions for all candidates, and business compatibility is limited to a 30-day collaboration experiment.

Why does the reading skip hour-based interpretations when birth time is unknown?

The engine marks missing values as null rather than guessing, and the skill is forbidden from inventing data. When birth time is unknown, hour-pillar-dependent interpretations are omitted and the user is told this explicitly.