A comprehensive astrology engine for AI agents to calculate planetary transits and natal chart aspects using the Swiss Ephemeris.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install astro-transits
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install astro-transits using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Astro Transits?
Astro Transits is a robust astrological calculation engine designed for integration with AI agents. It provides developers and users with the ability to calculate planetary positions, analyze aspects to specific natal charts, and track celestial events like stations or ingresses. As a standout tool within the Openclaw Skills library, it operates entirely locally, ensuring privacy and sub-arcsecond accuracy without the need for external API subscriptions.
This skill enables agents to interpret complex astrological data by translating planetary movements into actionable insights. Whether you are building a personalized scheduling assistant or a research tool, Astro Transits offers the technical foundation needed to bridge celestial mechanics with digital productivity.
Astro Transits Use Cases
- Creating personalized daily or weekly astrological forecasts based on user birth data.
- Automating Void-of-Course Moon checks to determine optimal times for decision-making.
- Analyzing planetary stations and sign ingresses for market research or creative planning.
- Building AI-driven astrological interpretation systems that reference specific natal chart placements.
How Astro Transits Works
- The user installs the Swiss Ephemeris library to handle high-precision celestial mechanics.
- A one-time natal chart generation process creates a reusable JSON file containing birth coordinates and house cusps.
- The transit script compares current planetary positions against the natal chart data using the Placidus house system.
- The system calculates active aspects, identifying significant orbs and planetary themes.
- The skill returns structured data including interpretive meanings, planetary phases, and specific event timing.
Astro Transits Setup
First, install the core dependency:
pip install pyswisseph
Generate your natal chart configuration:
python3 scripts/natal_chart.py --date "1993-05-13" --time "01:20" --tz "Australia/Brisbane" --lat -27.2308 --lon 153.0972 --save natal.json
Run a daily transit check:
python3 scripts/transits.py --chart natal.json
Astro Transits Data Schema & Taxonomy
The skill organizes data into a structured format for easy consumption by other Openclaw Skills.
| Data Component | Format | Description |
|---|---|---|
| Natal Chart | JSON | Stores birth date, time, timezone, and geographic coordinates. |
| Transit Data | Object | Contains planetary positions, aspects (conjunction, square, etc.), and house placements. |
| VOC Status | JSON | Boolean indicator for Void-of-Course Moon with duration and next sign data. |
| Interpretation | String | Built-in thematic meanings for detected planetary aspects. |
Astro Transits Advanced Features
- Local Swiss Ephemeris integration provides professional-grade accuracy without external calls.
- Automatic Moshier fallback ensures the skill remains functional even if high-precision data files are missing.
- Support for variable orbs allows for more nuanced interpretations of personal versus outer planet aspects.
- Seamless multi-user support via portable natal chart JSON files within the Openclaw Skills architecture.
SKILL.md
Loading
Related Openclaw Skills
Life Capture
A sophisticated personal information manager that converts messy natural language entries into structured daily notes and a relational SQLite database.
SEO Audit Report
An automated SEO auditing tool that generates prioritized, scored reports covering technical, on-page, and content health.
Log Analyzer
A privacy-focused local log analysis system for identifying errors, duplicates, and system anomalies through interactive visualizations.
Indie Designer Brand Pages & Store Structure
A comprehensive toolkit for independent fashion designers to build authentic brand narrative pages and cohesive site structures that drive conversion.
Microsoft To Do
A professional skill for AI agents to manage Microsoft To Do tasks and lists through the Microsoft Graph API using secure device-code authentication.
Feishu File Send
A specialized skill for sending images, audio, documents, and other file types directly to Feishu channels via automated workflows.
Featured*
