Generates personalized horoscope readings for all twelve zodiac signs based on Western astrology.
Supports any date (today, tomorrow, a specific date) and any time period (daily/weekly/monthly),
covering five dimensions — Overall, Love, Career, Finance, and Health — with a Lucky Guide and Daily Tip.
Can deliver personalized readings based on the user's birthday. Pure LLM generation, no external API required.
Trigger words: horoscope, daily horoscope, zodiac forecast, what's my horoscope today,
weekly horoscope, monthly horoscope, star sign reading, astrology forecast, what's my sign today.
Not intended for: Ba Zi (Four Pillars), Zi Wei Dou Shu, Tarot, Numerology, or Feng Shui —
use fortune-hub to find the right skill for those domains.
Generates personalized horoscope readings for all twelve zodiac signs based on Western astrology.
Supports any date (today, tomorrow, a specific date) and any time period (daily/weekly/monthly),
covering five dimensions — Overall, Love, Career, Finance, and Health — with a Lucky Guide and Daily Tip.
Can deliver personalized readings based on the user's birthday. Pure LLM generation, no external API required.
Trigger words: horoscope, daily horoscope, zodiac forecast, what's my horoscope today,
weekly horoscope, monthly horoscope, star sign reading, astrology forecast, what's my sign today.
Not intended for: Ba Zi (Four Pillars), Zi Wei Dou Shu, Tarot, Numerology, or Feng Shui —
use fortune-hub to find the right skill for those domains.
license
MIT
compatibility
{"platforms":["claude-code","claude-ai","api"]}
data_access
[{"path":"MEMORY.md","purpose":"Read/write user's birthday and sun sign for personalized readings","operations":["read","write"]},{"path":"../fortune-hub/MEMORY.md","purpose":"Read shared user profile fields (birthday) to avoid re-asking — fortune-hub is the central profile hub for this multi-skill repository","operations":["read"]}]
Draws from a rich knowledge base of zodiac sign traits to deliver personalized horoscope readings for any date and any time period.
Quick Start
Just say your sign (or birthday) and get your reading:
"Aries horoscope today"
"Scorpio reading for March 25th"
"I was born June 15, 1995 — what's my horoscope today?"
"Generate today's horoscope for all 12 signs"
"Gemini weekly horoscope"
"Sagittarius horoscope for March"
Mercury's lively energy sharpens your mind and quickens your wit — perfect for anything that calls for communication and coordination. An unexpected message may arrive in the afternoon; stay open to it and you might be pleasantly surprised.
Love ⭐⭐⭐ (3/5)
Conversation flows easily today, but things could stay a little surface-level. Try putting the phone down and having a real, unhurried talk with your partner. If you're single, a social gathering could bring a genuinely interesting connection.
Career ⭐⭐⭐⭐⭐ (5/5)
Thursday's forward-moving energy pairs beautifully with your natural talent for multitasking — push several projects ahead at once. In team settings, your ideas are the spark that gets everyone excited.
Finance ⭐⭐⭐ (3/5)
Income stays steady, but a "too good to pass up" purchase may be tempting. Add it to your cart and sit on it for a day before you commit.
Health ⭐⭐⭐⭐ (4/5)
Your energy is high, but watch out for eye strain. Step away from the screen for five minutes every hour. Spring's temperature swings mean you'll want to layer up in the morning and evening.
Lucky Guide
🎨 Lucky Color: Mint Green
🔢 Lucky Numbers: 5, 14
⏰ Lucky Hours: 2:00 PM – 4:00 PM
💑 Best Match Today: Libra
Daily Tip
Reach out to a friend you haven't spoken to in a while this afternoon — a light, easy conversation could spark an idea you weren't expecting.
User Context
This Skill can deliver more personalized readings when it knows your birthday.
Reading: Before generating, check in this order:
This directory's MEMORY.md — use first
fortune-hub/MEMORY.md (sibling skill in the same repository) — fill in any missing profile fields
If data is available, use it directly without asking again.
Writing: If the user shares their birthday, write it to this directory'sMEMORY.md:
# User Profile## Basic Info- Birthday (Gregorian): YYYY-MM-DD
- Sun Sign: [Sign Name]
- Sign Period: Early / Middle / Late
Field
Required
Notes
Birthday (Gregorian)
No (sign can be specified directly)
Enables personalized readings
Updating: Update MEMORY.md when the user asks to change their info.
Workflow
Step 1: Parse the User's Intent
Extract the following parameters from the user's input:
Parameter
Parsing Rule
Default
Sign
Stated directly, or inferred from birthday
Required (ask if unclear)
Date
"today/tomorrow/the day after" or a specific date like "March 25th"
Today
Period
Daily / Weekly / Monthly
Daily
Dimension
Is the user asking about just one area (e.g., "love life")?
All dimensions
Mode
Single sign or all 12 signs
Single sign
Zodiac Signs Reference Table:
Symbol
Sign
Date Range
Symbol
Sign
Date Range
♈
Aries
3/21-4/19
♎
Libra
9/23-10/22
♉
Taurus
4/20-5/20
♏
Scorpio
10/23-11/21
♊
Gemini
5/21-6/20
♐
Sagittarius
11/22-12/21
♋
Cancer
6/21-7/22
♑
Capricorn
12/22-1/19
♌
Leo
7/23-8/22
♒
Aquarius
1/20-2/18
♍
Virgo
8/23-9/22
♓
Pisces
2/19-3/20
Step 2: Load Sign Knowledge
Load only the relevant sign's trait file (do not load all 12):
The element and modality quick-reference table is in references/zodiac-index.md — load it only when cross-sign comparisons or batch generation is needed.
Step 3: Generate the Reading
Use the sign's traits combined with the date context to generate the horoscope, following the rules below.
Output Format (Daily)
# {Symbol} {Sign} Daily Horoscope ({YYYY-MM-DD}, {Day of Week})## Overall {Stars} ({N}/5)
[2-3 sentences of overall energy, weaving in the sign's core traits and the day's energy]
## Love {Stars} ({N}/5)
[1-2 sentences, offering perspective for both partnered and single readers]
## Career {Stars} ({N}/5)
[1-2 sentences, connecting to the day-of-week energy]
## Finance {Stars} ({N}/5)
[1-2 sentences, tuned to the rhythm of the month]
## Health {Stars} ({N}/5)
[1-2 sentences, grounded in the current season]
## Lucky Guide- 🎨 Lucky Color: [specific color name]
- 🔢 Lucky Numbers: [2 numbers]
- ⏰ Lucky Hours: [HH:MM – HH:MM]
- 💑 Best Match Today: [sign name]
## Daily Tip> [One specific, actionable piece of guidance]
Output Format (Weekly)
# {Symbol} {Sign} Weekly Horoscope ({Start Date} – {End Date})## This Week's Theme: [3 keywords]## Overview
[3-4 sentences covering the week's overall arc]
## Dimension Breakdown### Love {Stars} ({N}/5)
[2-3 sentences, with a highlight for key days this week]
### Career {Stars} ({N}/5)
[2-3 sentences, with specific action guidance]
### Finance {Stars} ({N}/5)
[2-3 sentences, with income/spending reminders]
### Health {Stars} ({N}/5)
[1-2 sentences]
## Power Days This Week- {Day}: [special note for this day]
- {Day}: [special note for this day]
## Weekly Tip> [One actionable suggestion for the week]
Output Format (Monthly)
# {Symbol} {Sign} Horoscope — {Month} {YYYY}## This Month's Theme: [3 keywords]## Monthly Overall Rating: {Stars} ({N}/5)## Big Picture
[4-5 sentences covering the month's arc, including early/mid/late month pacing]
## Dimension Breakdown### Love {Stars} ({N}/5)
[3-4 sentences, noting monthly turning points]
### Career {Stars} ({N}/5)
[3-4 sentences, highlighting key windows of opportunity]
### Finance {Stars} ({N}/5)
[2-3 sentences, with money management advice]
### Health {Stars} ({N}/5)
[2-3 sentences, with seasonal reminders]
## Key Dates- {M}/{D}: [note]
- {M}/{D}: [note]
- {M}/{D}: [note]
## Monthly Tip> [One actionable suggestion for the month]
Generation Rules
Content Quality:
Keep scores balanced — the sum of all five dimension scores should land between 14 and 19 (average 2.8–3.8 per dimension). Avoid all-high or all-low spreads.
Every reading must echo the sign's core traits (Aries = drive and initiative, Taurus = groundedness, Gemini = communication, etc.).
Each sign's reading on the same day must be clearly distinct — no copy-paste-and-swap-the-name content.
Be specific and vivid — ❌ "Things look good today" ✅ "An impromptu afternoon meeting could be your moment to shine as an organizer"
Writing Style:
Default to the warm mentor voice (think Susan Miller meets Cafe Astrology):
Lead with the cosmic weather, then bring it down to earth with a natural metaphor
Good news first; wrap any challenging energy in constructive, forward-looking guidance
Land each dimension with a concrete, actionable takeaway
Sound like a knowledgeable, friendly astrologer having a conversation — not a fortune-teller issuing decrees
Banned Phrases:
Don't Use
Use Instead
❌ "You are destined to..."
✅ "Your chart suggests a tendency toward..."
❌ "Disaster / catastrophe / danger"
✅ "This period calls for extra care in [area]"
❌ "You will never..."
✅ "This area may need more patience and a fresh approach"
❌ "You must remedy this or else..."
✅ "Here are some directions worth exploring"
❌ Unconditional praise with no nuance
✅ Mostly positive, but honestly flag challenging areas
✅ "The energy points toward," "may," "your chart indicates"
Absolutely off-limits: disease diagnosis, death references, disaster predictions, or any fear-based language.
Astrological Depth:
Weave the following elements naturally into readings — don't just list them mechanically:
Element (Fire / Earth / Air / Water): Sets the tone of the reading
Fire signs (Aries, Leo, Sagittarius): Focus on drive, passion, creative momentum
Earth signs (Taurus, Virgo, Capricorn): Focus on stability, pragmatism, long-term building
Air signs (Gemini, Libra, Aquarius): Focus on communication, social life, mental agility
Water signs (Cancer, Scorpio, Pisces): Focus on intuition, emotional depth, inner insight
Modality (Cardinal / Fixed / Mutable): Shapes the rhythm of the reading
Cardinal (Aries, Cancer, Libra, Capricorn): Emphasize initiating and launching new things
Fixed (Taurus, Leo, Scorpio, Aquarius): Emphasize commitment and deepening what's already in motion
Mutable (Gemini, Virgo, Sagittarius, Pisces): Emphasize adapting and transitioning
Ruling Planet Energy: Weave in the symbolic qualities of the ruling planet (Mercury = communication, Venus = love and beauty, Mars = action, Jupiter = expansion, Saturn = responsibility, etc.)
Season Resonance: When the current season aligns with the sign's element (e.g., summer and a Fire sign), note this resonance in the Health and Overall sections. When they clash (e.g., winter and a Fire sign), offer practical tips for balancing the elemental energy.
Date-Based Differentiation:
Date Feature
Dimension Affected
Score Shift & Content Direction
Monday
Career
+1 lean; focus on new plans and setting the week's intentions
Tuesday–Thursday
Career
Baseline; focus on execution and momentum
Friday
Love / Social
+1 lean; focus on social plans and relationship nurturing
Saturday
Health
+1 lean; focus on rest, relaxation, and outdoor activity
Sunday
Overall
Lean toward reflection, recharging, and preparing for the week ahead
Early month (1st–5th)
Finance
Focus on budgeting and planning
Mid-month (13th–17th)
Career
Focus on mid-point check-ins and course corrections
Late month (25th–31st)
Finance
Focus on reviewing, wrapping up, and celebrating wins
Spring (Mar–May)
Health
Watch for allergies, temperature swings, and sleep schedule shifts
Summer (Jun–Aug)
Health
Watch for heat, hydration, diet, and exercise balance
Fall (Sep–Nov)
Health
Watch for dryness, respiratory health, and seasonal mood dips
Winter (Dec–Feb)
Health
Watch for staying warm, immunity, and indoor movement
Personalization Rules (when a full birthday is provided):
Birthday falls in the first 1/3 of the sign's date range → weave in transitional qualities from the previous sign
Birthday falls in the final 1/3 → weave in anticipatory qualities from the next sign
Reading date is within 3 days of the user's birthday → mention "birthday energy boost"; Overall score gets +1
Step 4: Output and Saving
Single sign query: Output directly in the conversation.
All 12 signs (batch):
Generate in order (♈ Aries → ♓ Pisces)
Keep each daily reading to 150–200 words
Save as a Markdown file in the current working directory
Ask: "What's your sign? Or share your birthday and I'll figure it out for you 🌟"
Invalid date given
Prompt: "I couldn't quite parse that date — try something like: 'tomorrow,' 'next Monday,' 'March 25th,' or '2026-03-25'"
Birthday on a cusp (e.g., Jan 19 or 20)
Explain both possible signs and ask the user to confirm
User asks about Ba Zi, Tarot, or other non-zodiac topics
Redirect: "For that, I'd suggest using fortune-hub to find the right skill — there are dedicated modules for Ba Zi and Tarot"
User questions whether astrology is scientific
Respond warmly: "Horoscopes are a rich cultural tradition — think of them as a fun lens for reflection. For big life decisions, I'd always recommend grounding things in rational thinking and professional advice 😊"
Not Intended For
Please do not invoke this Skill for:
Ba Zi / Four Pillars / Zi Wei Dou Shu / Feng Shui / Qi Men Dun Jia → Use fortune-hub to find the right skill
Tarot → Use fortune-hub to find the right skill
Vedic Astrology → Use fortune-hub to find the right skill
Precise astronomical chart calculation → Requires an astronomical engine like Kerykeion; this skill does not perform astronomical computation
Psychological counseling / medical advice → This skill is for entertainment only and does not replace professional services
Automated Daily Delivery (Advanced)
Pair this skill with a scheduled task to get your horoscope delivered automatically every day:
Save your info: On first use, store your sign (or birthday) in memory so future runs don't need to ask again
Create a scheduled task: Use Claude Code's cron capability to set a daily trigger (e.g., every morning at 8:00 AM)
Auto-generate + deliver: When the task fires, it reads your sign from memory → runs this skill → sends the reading via your chosen channel (Feishu, DingTalk, etc.)
Example scheduled task setup:
Every morning at 8:00 AM, read my sign from memory, generate today's horoscope, and send it to my Feishu group
Prerequisites:
Your sign or birthday has been saved in memory
A message delivery channel has been configured (e.g., a feishu-lark skill webhook)
Tip: On a user's first visit, you might say — "Want me to remember your sign? I can set it up to send you a daily horoscope automatically."
Language & Localization
Always detect and respond in the user's language.
English:
Warm mentor tone, like Susan Miller meets Cafe Astrology
Personify planets: "Mercury's active energy sharpens your thinking"
Nature metaphors: seeds, bloom, tides, seasons
Structure: celestial event → personal impact → actionable advice
Hedging: "The stars suggest..." "You may find..." "This is a good time to..."
中文:
温暖导师型语气，亲切但专业
守护星能量融入描述："水星的活跃能量让你思维格外敏捷"
自然隐喻：种子、绽放、潮汐
结构：天象描述 → 对你的影响 → 具体建议
柔化措辞："星盘显示..." "你可能会..." "适合..."
禁用："命中注定""大凶""克夫""血光之灾"
Atomic Design
This Skill handles one thing: Western zodiac horoscope generation. It does not include Ba Zi, Tarot, Numerology, Zi Wei Dou Shu, or any other fortune-telling system. For other domains, combine the relevant Skills from this repository or route through fortune-hub.
Disclaimer
Horoscope readings are rooted in cultural and symbolic tradition and are intended for entertainment and reflection only. They do not constitute medical, legal, financial, or any other form of professional advice. For important life decisions, please rely on sound reasoning and qualified professional guidance.
