← 返回 Skills 市场
mizukaizen

Astro Transits

作者 mizukaizen · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
278
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install astro-transits
功能描述
Astrological transit calculator with natal chart support. Daily transits, weekly forecasts, void-of-course Moon, aspects, stations, and ingresses. Uses Swiss...
使用说明 (SKILL.md)

Astro Transits

Full astrological transit calculator for AI agents. Calculates planetary positions, aspects to any natal chart, Moon phases, void-of-course periods, stations, and ingresses. Uses Swiss Ephemeris (pyswisseph) with Moshier fallback — no API key needed.

Setup

Install the dependency:

pip install pyswisseph

Generate a natal chart (one-time setup per user):

python3 {baseDir}/scripts/natal_chart.py \
  --date "1993-05-13" \
  --time "01:20" \
  --tz "Australia/Brisbane" \
  --lat -27.2308 --lon 153.0972 \
  --save natal.json

Parameters:

  • --date — Birth date (YYYY-MM-DD)
  • --time — Birth time in 24h format (HH:MM)
  • --tz — Timezone name (e.g. America/New_York, Europe/London, Australia/Brisbane)
  • --lat / --lon — Birth location coordinates
  • --save — Save chart to JSON file for reuse

Daily Transits

python3 {baseDir}/scripts/transits.py --chart natal.json
python3 {baseDir}/scripts/transits.py --chart natal.json --date 2026-03-15

Returns: current planetary positions, active aspects to natal chart (ranked by significance), Moon sign/phase, stations, and ingresses. Top 8 aspects shown with orb, house placement, and interpretive meaning.

Weekly Forecast

python3 {baseDir}/scripts/transits.py --chart natal.json --week

Returns: top 3 most significant transits for the coming week with peak dates and themes.

Void-of-Course Moon

python3 {baseDir}/scripts/voc_check.py

Returns JSON: {"voc": true/false} with end time, duration, and next Moon sign if currently void-of-course. No natal chart needed — this is a universal calculation.

What It Covers

  • Planets: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, True Node
  • Aspects: Conjunction, sextile, square, trine, opposition (with variable orbs for personal vs outer planets)
  • Houses: Placidus house system
  • Events: Planetary stations (retrograde/direct), sign ingresses
  • Moon: Phase, sign, void-of-course detection
  • Interpretations: Built-in aspect meanings for all planet-aspect combinations

Notes

  • No API key or external service required — all calculations run locally
  • Swiss Ephemeris provides sub-arcsecond accuracy
  • Falls back to Moshier ephemeris if Swiss Eph data files are absent
  • Natal chart JSON can be generated once and reused indefinitely
  • Timezone handling uses Python's zoneinfo (Python 3.9+)
安全使用建议
This skill appears coherent and runs calculations locally, but consider: (1) pip install pyswisseph is required — this may build native extensions and rely on ephemeris data, so install in a virtualenv and review the PyPI package; (2) the natal JSON contains personal birth data (PII: date/time/place) — treat it as sensitive and save it only to locations you control; (3) although the code uses local Swiss Ephemeris functions and has a Moshier fallback, verify your environment can install native deps and that no unexpected network access occurs during install if you are in a restricted environment; (4) run the scripts manually first to confirm behavior before giving any agent automated access. If you want extra assurance, inspect the pip package source for pyswisseph and run the included scripts in an isolated environment.
功能分析
Type: OpenClaw Skill Name: astro-transits Version: 1.0.0 The astro-transits skill bundle is a legitimate astrological calculation tool. It uses the standard 'pyswisseph' library to compute planetary positions and transits locally without any external network calls, data exfiltration, or suspicious execution patterns. The scripts (natal_chart.py, transits.py, voc_check.py) perform mathematical and astronomical calculations as described in the documentation.
能力评估
Purpose & Capability
Name/description (transits, natal charts, voc) matches the included Python scripts and their operations. Required binaries (python3) and the recommended dependency (pyswisseph) are appropriate for the stated purpose. No extraneous services or credentials are requested.
Instruction Scope
SKILL.md instructs running local scripts and generating/reading a natal JSON file. The runtime instructions remain within the stated domain (local planetary calculations, timezones, coordinates). The scripts read user-provided birth data and may write the saved natal JSON; they do not reference other system config, environment secrets, or external endpoints.
Install Mechanism
There is no registry install spec; SKILL.md recommends pip install pyswisseph. Installing pyswisseph is expected for Swiss Ephemeris bindings but can involve a compiled extension and ephemeris data; this is a normal but non-zero risk (native code build / dependency on PyPI). The skill itself contains the full Python source (no external download URLs).
Credentials
The skill requires no environment variables, credentials, or config paths. The only data used is user-supplied birth date/time/location and any file path the user chooses to save/read (natal.json). This is proportionate to the described functionality.
Persistence & Privilege
The skill is not always-enabled and does not request elevated or persistent system privileges. It writes only to files the user explicitly names (e.g., --save natal.json) and does not modify other skills or system-wide agent configuration.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install astro-transits
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /astro-transits 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Astro Transits v1.0.0 - Initial release of a comprehensive astrological transit calculator. - Supports daily and weekly transits, including planetary positions, aspects to natal charts, Moon phases, stations, and ingresses. - Detects void-of-course Moon periods and provides interpretations for active aspects. - All calculations are local—no API key or external service required. - Uses Swiss Ephemeris with Moshier fallback for high-accuracy results.
元数据
Slug astro-transits
版本 1.0.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Astro Transits 是什么?

Astrological transit calculator with natal chart support. Daily transits, weekly forecasts, void-of-course Moon, aspects, stations, and ingresses. Uses Swiss... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 278 次。

如何安装 Astro Transits?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install astro-transits」即可一键安装,无需额外配置。

Astro Transits 是免费的吗?

是的,Astro Transits 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Astro Transits 支持哪些平台?

Astro Transits 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Astro Transits?

由 mizukaizen(@mizukaizen)开发并维护,当前版本 v1.0.0。

💬 留言讨论