astrology-skill

Synthesize astrological readings from structured chart JSON data.

Updated Jun 19, 2026
One-click install
npx skills add https://github.com/wvanderen/astrology-skill --skill astrology-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: astrology-skill
Source: https://github.com/wvanderen/astrology-skill/tree/main
Command: npx skills add https://github.com/wvanderen/astrology-skill --skill astrology-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This Skill provides a structured, retrieval-first approach to astrological interpretation, preventing the common pitfalls of free-association and cookbook-style reading by grounding synthesis in specific, verified interpretive modules.

Core Features & Use Cases

  • Structured Interpretation: Synthesizes natal, transit, synastry, and mundane readings from validated chart JSON.
  • Retrieval-First Workflow: Loads only relevant interpretive modules from a library of 137 references, ensuring high-quality, evidence-based synthesis.
  • Use Case: A user provides a natal chart JSON; the Skill builds a reading plan, selects the appropriate planetary and house modules, and generates a synthesized reading that accounts for dignity, sect, and aspect precision.

Quick Start

Use the astrology-skill to interpret the natal chart provided in the file chart.json.

Frequently Asked Questions about astrology-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I interpret a natal chart from JSON data without generating generic cookbook readings?

Natal chart interpretation from JSON data requires a retrieval-first workflow that loads specific verified modules to synthesize aspects, sect, and dignity, preventing generic cookbook readings. This approach grounds astrological synthesis in structured evidence rather than free-association.

What is the best way to analyze synastry charts using a structured data approach?

Synastry chart analysis is best handled by loading targeted interpretive modules from a reference library to synthesize relationship dynamics from validated chart JSON. This ensures the reading accounts for aspect precision and planetary dignity rather than relying on generic interpretations.

Can I perform astrology readings without built-in ephemeris calculation capabilities?

Yes, you can perform astrology readings without calculation capabilities by using a strictly no-calculation boundary approach. This Skill synthesizes interpretations from pre-validated chart JSON data, ensuring dependency-free runtime execution without needing internal ephemeris or computation engines.

How does transit analysis work when processing structured astrological data?

Transit analysis works by building a targeted reading plan from structured chart JSON, then retrieving only the relevant planetary and house modules from a 137-reference library. This retrieval-first method ensures evidence-based synthesis that respects scope guardrails and prevents ungrounded free-association.

Does evidence-based astrological synthesis support mundane astrology tasks?

Evidence-based astrological synthesis fully supports mundane astrology tasks by applying the same retrieval-first workflow and scope guardrails used for natal and transit readings. It processes validated chart JSON to generate structured interpretations without relying on cookbook-style free-association.