What it does

AstroGuru Report is a professional-grade Vedic astrology skill that transforms natural-language birth details into comprehensive, deterministic astrological reports. It bridges the gap between complex astronomical calculations and human-readable insights, supporting Dasha (predictive timing) and Gochara (transit) analysis.

How it works

Unlike simple prompting, this skill uses a local, standalone calculation engine to generate high-fidelity astrological data. It handles geocoding, timezone normalization to Indian Standard Time (IST), and precise Vimsottari Dasha calculations. Developers can choose between interactive chat responses or the generation of persisted, animated HTML reports.

Why use this skill?

• Deterministic Accuracy: Built-in libraries perform actual planetary math rather than relying on LLM "hallucinations" of star charts.
• Flexible Output: Supports chat-only modes, context-only for debugging, or full artifact persistence with automated HTML rendering.
• Follow-up Ready: Persists analysis context (Dasha/Gochara data) so users can ask refinement questions without re-entering birth data.
• Agency-Agnostic: Designed to work seamlessly with Claude Code, Cursor, and other agent environments without external API dependencies.

The Output

Produces a structured analysis including goal-oriented outlooks with broad timeframes (e.g., "Mid-2025"), practical recommendations, and optional spiritual practices, presented as either a CLI summary or a rich, animated HTML report.

Setup is simple:

unzip the skill folder into the target agent’s skills or workspace directory, then create the local Python environment using SETUP.md and install dependencies from requirements.txt. Python 3.10 or 3.11 is recommended. The scripts do not call any LLM provider directly; interpretation is handled by the active agent.