saju-fortune

Generates Korean saju fortune readings and compatibility analysis via the saju-fortune npm package.

7.4k|904|Updated Mar 24, 2026
One-click install
npx skills add https://github.com/NomaDamas/k-skill --skill saju-fortune
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: saju-fortune
Source: https://github.com/NomaDamas/k-skill/tree/main/saju-fortune
Command: npx skills add https://github.com/NomaDamas/k-skill --skill saju-fortune

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires saju-fortune.

What problem does it solve?

It turns raw birth information into structured Korean four-pillars (saju) readings, covering love, wealth, career, health, yearly fortune, and compatibility, without requiring a separate MCP server or manual calendar calculations.

Core Features & Use Cases

  • Interview-driven input collection: Confirms solar/lunar calendar, birth date, birth time, gender, and topic before running any calculation, and states accuracy limits when the birth time is unknown.
  • Topic-based fortune analysis: Uses the saju-fortune npm package's analyzeSaju and checkCompatibility functions to interpret the four pillars, five-element distribution, and the user's chosen topic such as love, wealth, career, health, or a target year.
  • Compatibility readings: Compares two people's birth data to produce a compatibility interpretation framed as conversation reference, not deterministic judgment.
  • Use Case: A user asks "우리 궁합 봐줘" (check our compatibility). The skill interviews both people for birth dates, times, and genders, calls checkCompatibility locally, and delivers a conversational reading with stated limitations.

Quick Start

Ask the agent to read your saju by providing your solar or lunar birth date, birth time, gender, and the topic you want such as love or wealth fortune.

Frequently Asked Questions about saju-fortune

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

FAQPage Schema
How do I get a Korean saju fortune reading from an AI agent?

Provide your solar or lunar birth date, birth time, gender, and the topic you want such as love, wealth, career, health, or yearly fortune. The skill interviews you for missing details, then calls the saju-fortune npm package's analyzeSaju function and interprets the four pillars and five-element distribution conversationally.

How do I check saju compatibility between two people?

Collect both people's birth dates, birth times, and genders, then the skill calls the checkCompatibility function from the saju-fortune package. The result is presented as a reference for relationship conversation, not as a decision on marriage or separation.

Does saju-fortune require running an MCP server?

No. The skill mimics the tool model of the hjsh200219/fortuneteller MCP server but calls the saju-fortune npm package directly as local functions. You only need Node.js 18+ and the package installed globally with NODE_PATH set.

What happens if I do not know my exact birth time?

Without a birth time, the hour pillar cannot be determined, so hour-based interpretations are excluded. The skill proceeds with a conservative reading based on year, month, and day pillars and explicitly states this accuracy limitation.

Can saju-fortune handle lunar calendar or leap-month birthdays?

The package does not convert lunar dates internally. You must first confirm the solar date using a verified perpetual calendar, then call the package with calendar set to solar, noting the conversion source and any leap-month caveats.