# Send Zodiac Horoscope to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "zodiac-horoscope",
    "name": "Zodiac Horoscope",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/dowands/zodiac-horoscope",
    "canonicalUrl": "https://clawhub.ai/dowands/zodiac-horoscope",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/zodiac-horoscope",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zodiac-horoscope",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "references/api.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/zodiac-horoscope"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/zodiac-horoscope",
    "downloadUrl": "https://openagent3.xyz/downloads/zodiac-horoscope",
    "agentUrl": "https://openagent3.xyz/skills/zodiac-horoscope/agent",
    "manifestUrl": "https://openagent3.xyz/skills/zodiac-horoscope/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/zodiac-horoscope/agent.md"
  }
}
```
## Documentation

### Zodiac Horoscope

Provide personalized, actionable daily guidance powered by planetary transit calculations against the user's natal chart.

### Required Environment Variables

VariableDescriptionZODIAC_API_KEYAPI key from zodiac-today.com (starts with hsk_)ZODIAC_PROFILE_IDProfile ID for the user's birth chart

### Privacy Notice

This skill collects sensitive PII (email, birth date, birth city) required for natal chart calculations. Handle with care:

Ask for explicit user consent before collecting birth information
Never log or expose PII in public channels or shared contexts
Store API keys and profile IDs in environment variables, not in plain text files
Delete cookies.txt after registration is complete

### How This Helps People

Daily decision-making: "Should I have that difficult conversation today?" → Check if confrontations are favorable or unfavorable
Schedule optimization: Plan high-energy tasks on high-energy days, rest on low days
Life event planning: Find the best window for job interviews, first dates, travel, or big purchases (paid tiers unlock future dates)
Relationship insights: Romance metrics help users pick ideal date nights
Motivation & mindfulness: Daily summaries provide a moment of reflection and intentional living

### Setup

Everything can be done via API — no browser needed.

### 1. Register & get API key

# Send verification code (creates account if new)
curl -s -X POST https://zodiac-today.com/api/auth/send-code \\
  -H "Content-Type: application/json" \\
  -d '{"email":"user@example.com"}'

# Verify code (check email inbox for 6-digit code)
curl -s -X POST https://zodiac-today.com/api/auth/verify \\
  -H "Content-Type: application/json" \\
  -c cookies.txt \\
  -d '{"email":"user@example.com","code":"123456"}'

# Create API key (use session cookie from verify step)
curl -s -X POST https://zodiac-today.com/api/keys \\
  -H "Content-Type: application/json" \\
  -b cookies.txt \\
  -d '{"name":"My Agent"}'
# Response: {"id":"...","key":"hsk_...","name":"My Agent"}

Store the hsk_ key as environment variable ZODIAC_API_KEY. Delete cookies.txt after this step.

### 2. Create birth profile

curl -s -X POST https://zodiac-today.com/api/profiles \\
  -H "Authorization: Bearer hsk_your_api_key" \\
  -H "Content-Type: application/json" \\
  -d '{"name":"John","birthDate":"1990-05-15","birthCity":"London, UK"}'

Save the returned id as environment variable ZODIAC_PROFILE_ID.

### First-time setup for a user

Ask for their email, birth date, and birth city (get explicit consent — this is sensitive PII)
Send verification code: POST /api/auth/send-code with their email
Human-in-the-loop: Ask the user to check their email and provide the 6-digit code. If the agent has email access (e.g., IMAP), it may retrieve the code automatically from noreply@zodiac-today.com
Verify code: POST /api/auth/verify — save session cookie to a temp file (-c cookies.txt)
Create API key: POST /api/keys (with session cookie) — save the returned hsk_ key
Clean up: Delete cookies.txt immediately — it is no longer needed
Create profile: POST /api/profiles (with API key) — save the returned profile id
Store ZODIAC_API_KEY and ZODIAC_PROFILE_ID as environment variables

### Daily horoscope fetch

Call GET /api/horoscope/daily?profileId=$ZODIAC_PROFILE_ID&startDate=YYYY-MM-DD&endDate=YYYY-MM-DD with Authorization: Bearer $ZODIAC_API_KEY
Parse the response and present actionable insights

### Presenting results to users

Translate raw data into practical advice:

overallRating (1-10): Frame as "Great day!" (8+), "Solid day" (6-8), "Take it easy" (<6)
favorable/unfavorable: Present as "Good for:" and "Better to avoid:" lists
metrics: Highlight the standout ones — "Your energy is HIGH today, perfect for tackling that project"
luckyColors: Suggest outfit or decor choices
luckyNumbers: Mention casually, fun touch
summary: Use the astrological narrative to add color, but keep advice grounded and practical

### Planning ahead (paid tiers)

For users with Starter+ tiers, fetch date ranges to help:

"What's the best day this month for my job interview?"
"When should I plan our anniversary dinner?"
Compare overallRating across dates and recommend the highest-rated windows

### API Details

See references/api.md for full endpoint docs, parameters, tiers, and response schemas.

### Example curl

curl "https://zodiac-today.com/api/horoscope/daily?profileId=PROFILE_ID&startDate=2026-02-15&endDate=2026-02-15" \\
  -H "Authorization: Bearer hsk_your_api_key"
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: dowands
- Version: 1.3.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/zodiac-horoscope)
- [Send to Agent page](https://openagent3.xyz/skills/zodiac-horoscope/agent)
- [JSON manifest](https://openagent3.xyz/skills/zodiac-horoscope/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/zodiac-horoscope/agent.md)
- [Download page](https://openagent3.xyz/downloads/zodiac-horoscope)