{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/zodiac-horoscope",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zodiac-horoscope",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "references/api.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/zodiac-horoscope",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Zodiac Horoscope",
        "body": "Provide personalized, actionable daily guidance powered by planetary transit calculations against the user's natal chart."
      },
      {
        "title": "Required Environment Variables",
        "body": "VariableDescriptionZODIAC_API_KEYAPI key from zodiac-today.com (starts with hsk_)ZODIAC_PROFILE_IDProfile ID for the user's birth chart"
      },
      {
        "title": "Privacy Notice",
        "body": "This skill collects sensitive PII (email, birth date, birth city) required for natal chart calculations. Handle with care:\n\nAsk for explicit user consent before collecting birth information\nNever log or expose PII in public channels or shared contexts\nStore API keys and profile IDs in environment variables, not in plain text files\nDelete cookies.txt after registration is complete"
      },
      {
        "title": "How This Helps People",
        "body": "Daily decision-making: \"Should I have that difficult conversation today?\" → Check if confrontations are favorable or unfavorable\nSchedule optimization: Plan high-energy tasks on high-energy days, rest on low days\nLife event planning: Find the best window for job interviews, first dates, travel, or big purchases (paid tiers unlock future dates)\nRelationship insights: Romance metrics help users pick ideal date nights\nMotivation & mindfulness: Daily summaries provide a moment of reflection and intentional living"
      },
      {
        "title": "Setup",
        "body": "Everything can be done via API — no browser needed."
      },
      {
        "title": "1. Register & get API key",
        "body": "# Send verification code (creates account if new)\ncurl -s -X POST https://zodiac-today.com/api/auth/send-code \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\":\"user@example.com\"}'\n\n# Verify code (check email inbox for 6-digit code)\ncurl -s -X POST https://zodiac-today.com/api/auth/verify \\\n  -H \"Content-Type: application/json\" \\\n  -c cookies.txt \\\n  -d '{\"email\":\"user@example.com\",\"code\":\"123456\"}'\n\n# Create API key (use session cookie from verify step)\ncurl -s -X POST https://zodiac-today.com/api/keys \\\n  -H \"Content-Type: application/json\" \\\n  -b cookies.txt \\\n  -d '{\"name\":\"My Agent\"}'\n# Response: {\"id\":\"...\",\"key\":\"hsk_...\",\"name\":\"My Agent\"}\n\nStore the hsk_ key as environment variable ZODIAC_API_KEY. Delete cookies.txt after this step."
      },
      {
        "title": "2. Create birth profile",
        "body": "curl -s -X POST https://zodiac-today.com/api/profiles \\\n  -H \"Authorization: Bearer hsk_your_api_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\":\"John\",\"birthDate\":\"1990-05-15\",\"birthCity\":\"London, UK\"}'\n\nSave the returned id as environment variable ZODIAC_PROFILE_ID."
      },
      {
        "title": "First-time setup for a user",
        "body": "Ask for their email, birth date, and birth city (get explicit consent — this is sensitive PII)\nSend verification code: POST /api/auth/send-code with their email\nHuman-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\nVerify code: POST /api/auth/verify — save session cookie to a temp file (-c cookies.txt)\nCreate API key: POST /api/keys (with session cookie) — save the returned hsk_ key\nClean up: Delete cookies.txt immediately — it is no longer needed\nCreate profile: POST /api/profiles (with API key) — save the returned profile id\nStore ZODIAC_API_KEY and ZODIAC_PROFILE_ID as environment variables"
      },
      {
        "title": "Daily horoscope fetch",
        "body": "Call GET /api/horoscope/daily?profileId=$ZODIAC_PROFILE_ID&startDate=YYYY-MM-DD&endDate=YYYY-MM-DD with Authorization: Bearer $ZODIAC_API_KEY\nParse the response and present actionable insights"
      },
      {
        "title": "Presenting results to users",
        "body": "Translate raw data into practical advice:\n\noverallRating (1-10): Frame as \"Great day!\" (8+), \"Solid day\" (6-8), \"Take it easy\" (<6)\nfavorable/unfavorable: Present as \"Good for:\" and \"Better to avoid:\" lists\nmetrics: Highlight the standout ones — \"Your energy is HIGH today, perfect for tackling that project\"\nluckyColors: Suggest outfit or decor choices\nluckyNumbers: Mention casually, fun touch\nsummary: Use the astrological narrative to add color, but keep advice grounded and practical"
      },
      {
        "title": "Planning ahead (paid tiers)",
        "body": "For users with Starter+ tiers, fetch date ranges to help:\n\n\"What's the best day this month for my job interview?\"\n\"When should I plan our anniversary dinner?\"\nCompare overallRating across dates and recommend the highest-rated windows"
      },
      {
        "title": "API Details",
        "body": "See references/api.md for full endpoint docs, parameters, tiers, and response schemas."
      },
      {
        "title": "Example curl",
        "body": "curl \"https://zodiac-today.com/api/horoscope/daily?profileId=PROFILE_ID&startDate=2026-02-15&endDate=2026-02-15\" \\\n  -H \"Authorization: Bearer hsk_your_api_key\""
      }
    ],
    "body": "Zodiac Horoscope\n\nProvide personalized, actionable daily guidance powered by planetary transit calculations against the user's natal chart.\n\nRequired Environment Variables\nVariable\tDescription\nZODIAC_API_KEY\tAPI key from zodiac-today.com (starts with hsk_)\nZODIAC_PROFILE_ID\tProfile ID for the user's birth chart\nPrivacy Notice\n\nThis skill collects sensitive PII (email, birth date, birth city) required for natal chart calculations. Handle with care:\n\nAsk for explicit user consent before collecting birth information\nNever log or expose PII in public channels or shared contexts\nStore API keys and profile IDs in environment variables, not in plain text files\nDelete cookies.txt after registration is complete\nHow This Helps People\nDaily decision-making: \"Should I have that difficult conversation today?\" → Check if confrontations are favorable or unfavorable\nSchedule optimization: Plan high-energy tasks on high-energy days, rest on low days\nLife event planning: Find the best window for job interviews, first dates, travel, or big purchases (paid tiers unlock future dates)\nRelationship insights: Romance metrics help users pick ideal date nights\nMotivation & mindfulness: Daily summaries provide a moment of reflection and intentional living\nSetup\n\nEverything can be done via API — no browser needed.\n\n1. Register & get API key\n# Send verification code (creates account if new)\ncurl -s -X POST https://zodiac-today.com/api/auth/send-code \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"email\":\"user@example.com\"}'\n\n# Verify code (check email inbox for 6-digit code)\ncurl -s -X POST https://zodiac-today.com/api/auth/verify \\\n  -H \"Content-Type: application/json\" \\\n  -c cookies.txt \\\n  -d '{\"email\":\"user@example.com\",\"code\":\"123456\"}'\n\n# Create API key (use session cookie from verify step)\ncurl -s -X POST https://zodiac-today.com/api/keys \\\n  -H \"Content-Type: application/json\" \\\n  -b cookies.txt \\\n  -d '{\"name\":\"My Agent\"}'\n# Response: {\"id\":\"...\",\"key\":\"hsk_...\",\"name\":\"My Agent\"}\n\n\nStore the hsk_ key as environment variable ZODIAC_API_KEY. Delete cookies.txt after this step.\n\n2. Create birth profile\ncurl -s -X POST https://zodiac-today.com/api/profiles \\\n  -H \"Authorization: Bearer hsk_your_api_key\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"name\":\"John\",\"birthDate\":\"1990-05-15\",\"birthCity\":\"London, UK\"}'\n\n\nSave the returned id as environment variable ZODIAC_PROFILE_ID.\n\nWorkflow\nFirst-time setup for a user\nAsk for their email, birth date, and birth city (get explicit consent — this is sensitive PII)\nSend verification code: POST /api/auth/send-code with their email\nHuman-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\nVerify code: POST /api/auth/verify — save session cookie to a temp file (-c cookies.txt)\nCreate API key: POST /api/keys (with session cookie) — save the returned hsk_ key\nClean up: Delete cookies.txt immediately — it is no longer needed\nCreate profile: POST /api/profiles (with API key) — save the returned profile id\nStore ZODIAC_API_KEY and ZODIAC_PROFILE_ID as environment variables\nDaily horoscope fetch\nCall GET /api/horoscope/daily?profileId=$ZODIAC_PROFILE_ID&startDate=YYYY-MM-DD&endDate=YYYY-MM-DD with Authorization: Bearer $ZODIAC_API_KEY\nParse the response and present actionable insights\nPresenting results to users\n\nTranslate raw data into practical advice:\n\noverallRating (1-10): Frame as \"Great day!\" (8+), \"Solid day\" (6-8), \"Take it easy\" (<6)\nfavorable/unfavorable: Present as \"Good for:\" and \"Better to avoid:\" lists\nmetrics: Highlight the standout ones — \"Your energy is HIGH today, perfect for tackling that project\"\nluckyColors: Suggest outfit or decor choices\nluckyNumbers: Mention casually, fun touch\nsummary: Use the astrological narrative to add color, but keep advice grounded and practical\nPlanning ahead (paid tiers)\n\nFor users with Starter+ tiers, fetch date ranges to help:\n\n\"What's the best day this month for my job interview?\"\n\"When should I plan our anniversary dinner?\"\nCompare overallRating across dates and recommend the highest-rated windows\nAPI Details\n\nSee references/api.md for full endpoint docs, parameters, tiers, and response schemas.\n\nExample curl\ncurl \"https://zodiac-today.com/api/horoscope/daily?profileId=PROFILE_ID&startDate=2026-02-15&endDate=2026-02-15\" \\\n  -H \"Authorization: Bearer hsk_your_api_key\""
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/dowands/zodiac-horoscope",
    "publisherUrl": "https://clawhub.ai/dowands/zodiac-horoscope",
    "owner": "dowands",
    "version": "1.3.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}