功能描述

Personalized daily astrological insights focused on relationships, work, personal growth, and luck. Positive framing only. Uses your natal chart + astronomy-...

使用说明 (SKILL.md)

Astro Life Insights ✨

Name: Astro Life Insights
Author: unicoleunicron

Personalized daily astrology for YOUR life, with a positive twist.

What This Does

Calculates current planetary transits against YOUR natal chart and provides insights for:

💕 Relationships - Love, connection, partnerships
💼 Work - Career, achievement, projects
🌱 Personal Growth - Learning, spirituality, transformation
🍀 Luck - Opportunities, abundance, manifestation

Everything is framed positively. Challenging transits become growth opportunities. Saturn squares = building foundations. Mars oppositions = channeling passion.

Setup (One-Time, Required)

⚠️ This skill ships with no personal data. You must run setup before anything works. Your birth data stays on your machine only.

1. Install Dependencies

cd path/to/astro-life-insights
npm install

2. Configure Your Birth Chart

node configure.js

You'll be prompted for:

Birth date (YYYY-MM-DD)
Birth time (HH:MM in 24-hour format)
Birth location (city, country)

This saves to ~/.config/astro-life-insights/natal-chart.json

2. Test It

node daily.js

Should output your personalized insights for today!

Usage

Get Today's Insights (Human-Readable)

node daily.js

Output:

✨ Your Astrological Weather - March 13, 2026

💕 RELATIONSHIPS
Uranus square natal Mars (building)
→ Freedom and intimacy find balance.
→ Action: Break free from limiting patterns.

💼 WORK
Sun square natal Uranus (EXACT TODAY)
→ Building identity through productive challenge.
→ Action: Honor both your needs and commitments.

🌱 PERSONAL GROWTH
Neptune sextile natal Moon (building)
→ Intuition guides evolutionary path.
→ Action: Tune into subtle guidance.

🍀 LUCK
Venus square natal Neptune (building)
→ Fortune through clarifying values.
→ Action: Invest in what you truly value.

✨ OVERALL: 15 active transits today. Rich day for inner work.

Get Insights for Specific Date

node daily.js 2026-03-15

Check Upcoming Transits

node upcoming.js

Shows major transits coming in the next 30 days.

Get JSON Output (for dashboards and automation)

node daily-json.js

Returns structured JSON — perfect for integrating into dashboards, agents, or any app.

JSON Output Schema (`daily-json.js`)

{
  "date": "2026-03-13",
  "totalTransits": 15,
  "relationships": [
    {
      "transit": "Uranus square",
      "planet": "uranus",
      "natal": "mars",
      "insight": "Freedom and intimacy find balance.",
      "action": "Break free from limiting patterns.",
      "emoji": "💕",
      "exact": false
    }
  ],
  "work": [ ... ],
  "growth": [ ... ],
  "luck": [ ... ]
}

Field Reference

Field	Type	Description
`date`	string	ISO date for this reading
`totalTransits`	number	Total active transits across all categories
`planet`	string	Transiting planet (lowercase: `sun`, `moon`, `mars`, etc.)
`natal`	string	Natal planet being aspected (lowercase)
`transit`	string	Aspect type string e.g. `"Uranus square"`
`insight`	string	Positive interpretation of the transit
`action`	string	What to do about it today
`exact`	boolean	Whether the transit is exact today (peak influence)

Aspect Reference

Understanding aspects helps you interpret the data. Each aspect represents a geometric relationship between planets:

Symbol	Name	Angle	Vibe	Meaning
☌	Conjunction	0°	Fusion	Two forces merge — intense, focused, amplified energy
☍	Opposition	180°	Tension	Opposing forces — awareness through contrast
□	Square	90°	Challenge	Friction that demands growth — a productive challenge
△	Trine	120°	Harmony	Natural flow and ease — gifts arriving without effort
⚹	Sextile	60°	Opportunity	An open door — rewards conscious action
⚻	Quincunx	150°	Adjustment	Subtle misalignment requiring creative adaptation

Planet Glyphs & Meanings

Glyph	Planet	Governs
☀️	Sun	Identity, vitality, purpose
🌙	Moon	Emotions, instincts, inner world
☿	Mercury	Mind, communication, learning
♀	Venus	Love, beauty, values, pleasure
♂	Mars	Drive, action, desire, courage
♃	Jupiter	Expansion, luck, wisdom, growth
♄	Saturn	Structure, discipline, mastery
⛢	Uranus	Revolution, freedom, sudden change
♆	Neptune	Dreams, intuition, spirituality
♇	Pluto	Transformation, power, rebirth

Dashboard Integration

daily-json.js is designed for dashboard use. Here's how to integrate it:

Server-Side (Node.js)

// In your server.js API endpoint
const { execSync } = require('child_process');
const astroPath = path.join(process.env.HOME, '.openclaw', 'workspace', 'skills', 'astro-life-insights', 'daily-json.js');

const output = execSync(`/opt/homebrew/bin/node daily-json.js`, {
  encoding: 'utf8',
  timeout: 10000,
  cwd: path.dirname(astroPath),
  env: { ...process.env, PATH: '/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin', HOME: process.env.HOME }
});
const data = JSON.parse(output.trim());

⚠️ Important: Always use the full node path (/opt/homebrew/bin/node) and set PATH explicitly in env. launchd/daemon environments often don't inherit shell PATH.

Educational Visualization

When building a UI, display transits with:

Planet chip: glyph + planet name (hoverable with meaning)
Aspect symbol: colored by vibe (square=purple, trine=indigo, etc.)
Natal chip: what in your natal chart is being activated
"EXACT TODAY" badge: pulsing highlight when exact: true
Aspect description: what the aspect type means geometrically
Insight: the positive interpretation
Action: concrete thing to do today
Planet meanings: educational footer so users learn over time

This turns a transit like "Uranus square natal Mars" into something anyone can understand and learn from, not just astrologers.

How It Works

Calculate Transits - Uses astronomy-engine to find current planetary positions
Compare to Natal Chart - Identifies aspects (conjunctions, trines, squares, etc.)
Map to Life Areas - Venus/Mars/7th house = relationships, Sun/Saturn/10th = work, etc.
Positive Interpretation - Frames every transit as opportunity
Actionable Advice - Tells you what to DO about it

Files

configure.js — One-time setup for your natal chart
daily.js — Human-readable daily insights
daily-json.js — Machine-readable JSON output for dashboards/automation
upcoming.js — See future transits
calculate.js — astronomy-engine wrapper
interpret.js — Transit → insight mapping
data/interpretations.json — Database of positive meanings
data/life-areas.json — Life area → planet/house mapping

Why This is Different

Other astrology tools:

Generic sun sign horoscopes (not personalized)
Focus on negative/challenging aspects
No actionable advice
Not tailored to YOUR life

This tool:

Uses YOUR exact natal chart
Everything framed positively
Focused on relationships, work, growth, luck
Tells you what to DO, not just what to expect
JSON output ready for dashboard integration

Privacy & Your Data

Your natal chart is stored locally on your machine at:

~/.config/astro-life-insights/natal-chart.json

This file is outside the skill folder and is never packaged or published. This skill ships with zero personal data — every user must run configure.js to enter their own birth details before anything works.

Nothing is sent to external services. All calculations happen locally using the astronomy-engine npm package.

Requirements

Node.js 16+
astronomy-engine npm package (run npm install in the skill directory)

Changelog

v1.1.0

Documented daily-json.js JSON output format and full field schema
Added Aspect Reference table (symbols, angles, meanings)
Added Planet Glyphs reference
Added Dashboard Integration guide with server-side code and educational visualization patterns
Added note on PATH requirement for daemon/launchd environments

v1.0.0

Initial release

Built with intention 🌀

安全使用建议

This skill appears to do what it says: it calculates transits locally and saves your natal chart to ~/.config/astro-life-insights/natal-chart.json. Before installing, check: (1) you will run 'npm install' which pulls astronomy-engine from npm — review the dependency if you want. (2) The project includes test files; one test imports 'swisseph' which isn't in package.json (probably leftover). (3) If you copy the execSync server example into a production server, avoid running child processes with untrusted inputs and be careful with PATH overrides — prefer calling node from a controlled environment and validate inputs. (4) No network exfiltration is present in the code, but if you modify the scripts to send data to external services, be mindful that your natal data is sensitive personal information. Overall this skill is internally consistent and reasonable for personal/local use.

功能分析

Type: OpenClaw Skill Name: astro-life-insights Version: 1.1.1 The skill bundle is a legitimate tool for calculating astrological transits based on a user's natal chart. It stores sensitive birth data locally in `~/.config/astro-life-insights/natal-chart.json` as documented in `SKILL.md` and `configure.js`, with no evidence of data exfiltration or external network requests. The code uses the reputable `astronomy-engine` library, and the provided documentation is transparent about its functionality and privacy model.

能力评估

✓ Purpose & Capability

Name/description (personalized astrological insights) match the code and files: the package computes planetary positions (astronomy-engine), finds transits against a natal chart, and generates human-readable and JSON outputs. The required files and npm dependency (astronomy-engine) are proportionate. Minor inconsistency: test-basic.js references a 'swisseph' module that is not listed in package.json — likely leftover test code, not functionality required for the stated purpose.

ℹ Instruction Scope

SKILL.md instructs local setup (npm install, node configure.js) and running local scripts (daily.js, daily-json.js), which is appropriate. The README includes a server-side example that runs execSync with an absolute node path and overrides PATH/HOME in env — this is an integration example, not an instruction to collect or transmit user data externally. It does access normal environment variables (HOME, PATH) and references the skill workspace path; nothing in the instructions directs birth data off the machine. Users should be cautious when copy-pasting the execSync example into a server: running child processes with constructed env/paths can be a source of risk if combined with untrusted input.

✓ Install Mechanism

No install spec in registry (instruction-only), so nothing is automatically downloaded by the platform. The SKILL.md instructs running 'npm install' locally which will fetch 'astronomy-engine' from the public npm registry (package-lock.json confirms this). Using an npm dependency from the registry is expected for this use case and is standard practice; no downloads from personal servers or URL shorteners are present.

✓ Credentials

The skill declares no required environment variables or credentials. It reads/writes a local config file at ~/.config/astro-life-insights/natal-chart.json (stated in SKILL.md). The example integration manipulates PATH and HOME for execSync, but these are normal and justified for the example use — there are no unrelated secrets requested or used.

✓ Persistence & Privilege

'always' is false and nothing in the code requests elevated or persistent platform privileges. The skill stores only the user's birth data in a per-user config directory and does not attempt to alter other skills or system-wide agent settings.

版本历史

v1.1.1

Fix docs: astronomy-engine not Swiss Ephemeris; zero personal data shipped; added npm install step; strengthened privacy section

v1.1.0

Added daily-json.js documentation, full JSON schema, aspect reference table (☌☍□△⚹ with meanings), planet glyph reference, dashboard integration guide with server-side code and educational visualization patterns

元数据

Slug astro-life-insights

版本 1.1.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题