vera-akashic-life-reading - SKILL.md Agent Skill

name: vera-akashic-life-reading description: >- Verified birth-chart interpretation workflow for simplified Akashic-record-style and life-lesson readings. Use when the user wants a symbolic soul map, Akashic record, past life reading, life purpose reading, soul blueprint, karmic reading, this-life lesson, soul mission, destiny pattern, BaZi, Zi Wei Dou Shu, Western astrology, traditional Western astrology, Hellenistic astrology, Vedic or Jyotish astrology, numerology, or a reflective spiritual narrative from provided birth data or verified charts. Produces one symbolic record and one mission by default, separates deterministic chart calculation from LLM interpretation, and refuses to invent unverified charts.

Vera Akashic Life Reading

Create concise Akashic-record-style life readings from verified birth-chart data. Keep a hard boundary: scripts or trusted external calculators compute charts; the language model interprets confirmed chart facts.

Operating Rules

Do not calculate BaZi, Zi Wei Dou Shu, modern astrology, traditional Western astrology, or Vedic/Jyotish astrology from memory.
If the user provides verified BaZi, Zi Wei, natal chart, traditional astrology, or Vedic chart data, parse and normalize it before interpreting.
If the user provides birth data, compute only through a deterministic helper or trusted backend, then ask the user to confirm the chart.
If chart data is incomplete, label the reading as partial and avoid claims that depend on missing fields.
Treat Akashic-record language as symbolic, reflective, and spiritual/creative interpretation, not factual access to hidden records.
Default to the free/simple interpretation model: one symbolic Akashic record, one this-life mission, one core blocker, and one next practice. Do not generate multiple records, multiple missions, or a long domain-by-domain report.
Treat same-named elements across systems as analogical, not equivalent: Western fire/earth/water/air and BaZi wood/fire/earth/metal/water use different technical models.
Treat exact timestamp-to-category conversions as lossy. Before interpretation, flag boundary-sensitive cases such as a birth time near a Chinese-hour boundary, a planet or angle near a sign cusp, or a planet near a house cusp.
Avoid fatalistic, medical, financial, legal, or relationship-certainty claims.

Inputs

Ask only for missing fields needed for the requested mode:

Name or preferred name.
Birth date and calendar type: Gregorian/solar or Chinese lunar, including leap month when lunar.
Birth time, as exact as available.
Birth place and timezone if chart calculation is requested.
Sex/gender only when BaZi luck-cycle direction or Zi Wei Dou Shu calculation is requested.
Latitude/longitude when Western or Vedic ascendant, houses, or lagna are requested.
Verified BaZi, Zi Wei, natal chart, traditional Western astrology, and/or Vedic chart facts if the user already has them.
Source/settings for verified charts, such as app/site, tropical vs sidereal zodiac, house system, and true-solar-time policy.
Tai Yuan auxiliary-pillar preference when using Tai Yuan: engine-calculated value, user-verified value, or adjusted value for premature/gestational considerations.
Numerology scope only when requested: date-only numbers, or explicit name method if the user asks for name-based numerology.

Workflow

Choose mode:
- verified-chart: user provides BaZi, Zi Wei, natal chart, traditional astrology, or Vedic facts.
- multi-system-calculator: for multi-system readings, run each requested calculator in sequence, collect one unified chart summary, then ask for confirmation before the simplified one-record interpretation.
- bazi-calculator: run scripts/bazi_profile.py for BaZi after dependency is available.
- ziwei-calculator: run scripts/ziwei_profile.mjs for Zi Wei Dou Shu when gender and birth time are available.
- astrology-calculator: run scripts/astro_profile.py for Western, traditional Western, and/or Vedic astrology when swisseph is available; use the traditional system alias for traditional Western astrology rather than a separate mode.
- numerology-calculator: run scripts/numerology_profile.py when the user asks for numerology or a multi-system reading that includes it.
- partial: name/date only, no hidden chart-dependent claims.
Normalize chart facts into the schema in references/calculation-contract.md.
If Tai Yuan will be used and the user did not supply a verified value, ask whether to keep the engine-calculated Tai Yuan or provide/confirm an adjusted Tai Yuan before surfacing it in the chart summary. This is especially important for premature birth or any school that adjusts Tai Yuan by gestational assumptions.
For BaZi, surface deterministic structure facts such as Earthly Branch meetings, trines, half-combinations, six-combinations, clashes, punishments, harms, and breaks; verified or confirmed auxiliary facts such as Tai Yuan; and luck cycles or annual themes when sex/gender and target years are supplied.
For Zi Wei, traditional Western, and Vedic astrology, surface chart facts only from the helper output or user-verified data; record settings such as leap-month handling, house model, sect, ayanamsa, node choice, and timing model.
If any helper script exits non-zero or returns invalid JSON, show the error briefly, do not interpret partial failed output as chart fact, and ask whether to retry with corrected input or switch to verified-chart mode.
Show the computed or parsed chart summary and ask for confirmation before interpretation. If any category boundary warning appears, ask whether to use the current categorization, an alternate calculation, or the user's verified chart.
Read references/interpretation-framework.md and references/akashic-style-patterns.md before generating the final reading.
Use cross-system correction as the primary synthesis move: if one system appears to show absence and another shows analogous strength, reframe the life lesson around access, containment, release, or domain of expression rather than simplistic deficiency. Do not claim the systems are measuring the same element.
Apply references/safety-privacy-boundary.md to the final wording, especially when using examples or prior readings as style references.
If using bundled scripts, include calculation notes and limitations in the final response.
After the initial reading, invite focused feedback. If the user corrects or nuances a pattern, load references/refinement-patterns.md and re-synthesize with the correction integrated.

Reference Routing

Need	Load
Input/output schema, chart settings, and confirmation rules	`references/calculation-contract.md`
Mapping verified chart mechanics to a reading	`references/interpretation-framework.md`
Simplified Akashic reading structure and tone	`references/akashic-style-patterns.md`
Traditional Western astrology layer	`references/traditional-astrology-module.md`
Feedback-based second-pass synthesis	`references/refinement-patterns.md`
Numerology calculation and cross-mapping	`references/numerology-module.md`
Synthetic example of correction-first reading	`references/worked-example-anonymous.md`
Privacy, partial-data, and high-stakes boundaries	`references/safety-privacy-boundary.md`
Engine provenance, license, and upgrade notes	`references/upstream-attribution.md`

Runtime Dependencies

Calculator	Script	Runtime	Dependency Status
BaZi	`scripts/bazi_profile.py`	Python 3	`lunar_python` is vendored under `scripts/vendor/`; `scripts/requirements.txt` is only for upgrades or external installs.
Zi Wei Dou Shu	`scripts/ziwei_profile.mjs`	Node.js	`iztro` is vendored under `scripts/vendor/iztro/`; no npm install is needed for normal use.
Western/traditional/Vedic astrology	`scripts/astro_profile.py`	Python 3	Requires user-installed `pyswisseph` from `scripts/requirements-astro.txt`; check Swiss Ephemeris licensing before product use.
Numerology	`scripts/numerology_profile.py`	Python 3	No external dependency; date arithmetic only.

Script Use

For BaZi calculation with Gregorian or Chinese lunar date/time:

python3 scripts/bazi_profile.py --input birth.json

The skill vendors a MIT copy of lunar_python under scripts/vendor/ so the helper can run offline in normal use. scripts/requirements.txt documents the upstream package constraint for upgrades or external environments.

To request luck cycles and specific target years, include gender and target_years, for example:

{"calendar":"solar","birth_date":"YYYY-MM-DD","birth_time":"HH:MM","birth_place":"City, Region","gender":"female","target_years":[2026]}

If the user provides a verified Tai Yuan auxiliary pillar, keep it separate from the engine-computed value:

{"verified_tai_yuan":"<verified_ganzhi_pillar>"}

For Zi Wei Dou Shu:

node scripts/ziwei_profile.mjs --input birth.json

For Western, traditional Western, or Vedic astrology, install the optional ephemeris dependency and supply coordinates:

python3 scripts/astro_profile.py --input birth.json

scripts/astro_profile.py requires pyswisseph; check the Swiss Ephemeris AGPL/commercial license before product use. Do not substitute sun-sign astrology or generic Vedic summaries for calculated chart facts.

To request traditional Western astrology output, include a traditional system alias:

{"systems":["western","traditional","vedic"],"target_years":[2026]}

The traditional Western layer is a Hellenistic-style sublayer: tropical zodiac, whole-sign houses from Ascendant, traditional seven-planet rulers, sect, Fortune/Spirit lots, and annual profections. It does not calculate bounds/terms, decans, fixed stars, primary directions, or zodiacal releasing.

For date-based numerology:

python3 scripts/numerology_profile.py --input birth.json

Use numerology as a supplemental lens. Do not calculate name-based Expression/Destiny numbers unless the user explicitly provides the name form and asks for that school.