agentleFS
CharlotteShenCharlotteShen/astro-tarot-bazi-divination-skills/natal-astrology/SKILL.md

natal-astrology

Skill0 starsChanged 3 months agoMITView on GitHub

Modern-psychological Western natal astrology readings from an accurate chart. Whole-chart synthesis plus per-planet drill-down by life domain or situation; English/中文. Triggers on: natal chart, birth chart, astrology reading, read my chart, what does my [planet] mean, my Sun/Moon/rising, 本命盘, 星盘解读, 占星. The skill does not compute positions — it reads accurate chart data the user supplies (astro.com paste, or the optional kerykeion script).

The file

Show its rules and text

We split this skill into the rules it gives an agent

41 rules. About 0 are common, 18 are distinctive, and 23 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈18

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 23

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Find the chart: Look for birth-data.md in this order: (a) this skill's own folder — the directory that contains this SKILL.md (the …

    line 12
  2. Very specific:

    Optional BaZi bridge: if the reader opts in and natal-astrology/birth-data.md supports it, a 八字 resonance layer may be added per …

    line 23
  3. Very specific:

    Route A (Claude Code + Python): run scripts/check_env.py then scripts/chart.py with --out <skill-folder>/birth-data.md to generate the file …

    line 31
  4. Distinctive:

    Do not produce a reading until chart data exists.

    line 35
  5. Very specific:

    Default = the language field in the chart file.

    line 45
  6. Distinctive:

    Relationship type: Ask which applies — romantic / friendship / family / work — if not given.

    line 53
  7. Very specific:

    Compute deterministically: Use scripts/synastry.py (pipe a JSON payload {"birth_a":…,"birth_b":…,"relationship_type":…} on stdin.

    line 54
  8. Very specific:

    Never reference a contact/overlay/composite factor not in synastry_data.

    line 60
  9. Distinctive:

    Perspective: Default to naming both people (A = person A, B = person B) and staying third-person — never mix "you" and "he/she".

    line 61
  10. Very specific:

    Unknown birth time: if either time is unknown, do not block — compute with a labeled noon (12:00) assumption and give the reliability note …

    line 79
  11. Distinctive:

    When the user asks to *see* a chart ("show my chart wheel", "画个星盘", "draw our synastry wheel"):

    line 84
  12. Very specific:

    Ensure Route A birth date/time/place is available.

    line 86
  13. Very specific:

    Run scripts/wheel.py with --type, the birth args from the birth-data file(s), and --theme (default light.

    line 88
  14. Very specific:

    Never auto-generate a wheel with a default reading.

    line 92
  15. Distinctive:

    When the user asks about time uncertainty ("how sensitive is my chart to birth time", "I don't know my exact time, what would change", …

    line 96
  16. Very specific:

    Check the birth-data file for an existing time_range.

    line 98
  17. Very specific:

    Run scripts/sensitivity.py with --time-start/--time-end and the birth args from the file.

    line 100
  18. Distinctive:

    Never run this with a default reading.

    line 103
  19. Distinctive:

    When the user wants to narrow an unknown birth time from life events ("help me narrow down my birth time", "rectify my chart", 校时/生辰校正):

    line 107
  20. Distinctive:

    Ask for 1+ dated life events (date + a short free-text description).

    line 110
  21. Very specific:

    Run scripts/rectification.py with --time-start/--time-end, the birth args, and one --event YYYY-MM-DD:label per event.

    line 113
  22. Distinctive:

    Never persist the events — they are passed per run only, never written into any tracked file.

    line 117
  23. Distinctive:

    When the user asks what's happening astrologically now ("what are my transits", "my transits today / on <date>", 行运/流年):

    line 120
  24. Very specific:

    Read the natal birth-data (birth date/time/place).

    line 122
  25. Very specific:

    Run scripts/transits.py with the natal birth args and --on <date> (default today.

    line 124
  26. Distinctive:

    Never present the transiting-Moon degree, or (when birth time is unknown) angle transits, as precise.

    line 129
  27. Distinctive:

    When the user asks what's coming up over time ("what's coming up", "my transits this year", "when does <planet> go exact", 流年/未来行运):

    line 132
  28. Very specific:

    Read the natal birth-data.

    line 134
  29. Very specific:

    Run scripts/forecast.py with the natal birth args and --from/--to (default next 12 months.

    line 136
  30. Distinctive:

    When the user asks for a year-ahead / birthday chart ("solar return", "my birthday chart", "year ahead", 太阳返照/生日盘):

    line 143
  31. Very specific:

    Read the natal birth-data.

    line 145
  32. Distinctive:

    Ask which year, and where they'll be on their birthday (birth location by default, or a place to relocate to).

    line 147
  33. Very specific:

    Run scripts/solar_return.py with the natal args, --year, and --loc-* if relocated (omit --time if the birth time is unknown).

    line 149
  34. Distinctive:

    When the user asks about the year's time-lord ("profection", "lord of the year", "which house am I in", 小限法/年主星):

    line 155
  35. Very specific:

    Read the natal birth-data.

    line 157
  36. Very specific:

    Run scripts/profections.py with the natal args and --on (default today).

    line 159
  37. Distinctive:

    When the user asks about their progressed chart ("my progressions", "progressed Moon", "progressed chart", 二次推运/推运):

    line 165
  38. Very specific:

    Read the natal birth-data.

    line 167
  39. Distinctive:

    When the user asks about solar arc ("solar arc", "directed chart", 太阳弧):

    line 175
  40. Very specific:

    Read the natal birth-data.

    line 176
  41. Distinctive:

    Never reference a position or aspect not in the chart file.

    line 184

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Natal Astrology

You produce modern-psychological Western natal readings. You do NOT compute planetary positions — accurate chart data comes from the user's birth-data.md file. Your value is interpretation.

On every invocation

  1. Find the chart. Look for birth-data.md in this order: (a) this skill's own folder — the directory that contains this SKILL.md (the canonical location); (b) the current working directory; (c) a path the user gives, or a chart they attach/paste. If none is found, go to "First-time setup".
  2. Read these references before interpreting: references/reading-method.md, references/voice-and-ethics.md, references/prose-style.md (how the reading must be written), and the relevant keyword files (planets.md, signs.md, houses.md, aspects.md). Use references/glossary.md if output is 中文.
  3. Validate the chart against references/data-contract.md (Tier-1 completeness, plausible values). If Tier 1 is incomplete, ask for the missing pieces; never fabricate data.
  4. Pick the mode (below) and produce the reading following reading-method.md.
  • Optional BaZi bridge: if the reader opts in and natal-astrology/birth-data.md supports it, a 八字 resonance layer may be added per references/reading-method.md → "BaZi bridge" (never required).

First-time setup (no chart file found)

Show the user birth-data.template.md and explain the two ways to fill it:

  • Route B (any environment): paste from astro.com — follow references/data-contract.md → "Route B". Map their paste into the template, validate, and ask them to save it as birth-data.md in this skill's own folder (next to SKILL.md).
  • Route A (Claude Code + Python): run scripts/check_env.py then scripts/chart.py with --out <skill-folder>/birth-data.md to generate the file from birth date/time/place. Also ask for the person's gender/pronouns (she/her | he/him | they/them | other) and record it in the gender meta field — used for correct pronouns; never assume from the name. (For two people, ask for each.) Do not produce a reading until chart data exists. Never guess positions.

Modes

  • Whole-chart synthesis (default): "read my chart", "what's my chart about" → Mode A.
  • Per-planet drill-down: "tell me about my Mars", "what does my Venus mean for money/this situation" → Mode B (archetype → in-your-chart → through-the-scenario → two-sided take).
  • Synastry (two charts): "compare my chart with…", "synastry", "合盘", "我和X合不合" → Synastry mode (see below).
  • Q&A: any follow-up question → Q&A mode, grounded in the chart.

Language

Default = the language field in the chart file. Switch ONLY on explicit request ("switch to Chinese" / "用中文"). Never auto-detect from message language. See references/voice-and-ethics.md → Language.

Synastry (two-chart mode)

  1. Two charts. Person A = birth-data.md. Person B = birth-data-2.md (or a path/paste the user gives). If person B is missing, route them to create it (Route A script or astro.com paste) — never invent a second person.
  2. Relationship type. Ask which applies — romantic / friendship / family / work — if not given.
  3. Compute deterministically. Use scripts/synastry.py (pipe a JSON payload {"birth_a":…,"birth_b":…,"relationship_type":…} on stdin; the result prints to stdout — pass --out only if the user asks to save a file, and remind them it holds both people's birth data), or map a pasted astro.com synastry + composite set into synastry_data per references/data-contract.md → "Synastry data".
  4. Read following references/synastry-method.md and references/relationship-frameworks.md. Never reference a contact/overlay/composite factor not in synastry_data.
  5. Perspective. Default to naming both people (A = person A, B = person B) and staying third-person — never mix "you" and "he/she". Confirm which chart is the user's own, then offer a "you-perspective" reading (from the user's side); use it only if they say yes. Applies to all two-chart readings (synastry, Davison, Marks).

Relationship charts (v1.1.1: composite alone / Davison / Marks)

Within synastry, the user can request a specific relationship chart instead of the full reading. Offer a short menu and read whichever they pick (see references/davison-marks.md for descriptions + method):

  • Composite (alone) — the v1.1.0 composite, read on its own as the relationship entity. No new calc (it's already in synastry_data.composite).
  • Davison — run scripts/davison.py with {"target":"davison", ...} → a real chart (real ASC/MC/houses).
  • Marks A/B — run scripts/davison.py with {"target":"marks","marks_mode":...}. Ask the mode if not given; default natal_davison. Modes: natal_composite, natal_davison, canonical. Show the user the one-line description of each from references/davison-marks.md.

davison.py takes the same stdin payload as synastry.py and prints JSON to stdout; pass --out only if the user asks to save a file (it holds both people's birth data).

Unknown birth time: if either time is unknown, do not block — compute with a labeled noon (12:00) assumption and give the reliability note (time-robust planets usable; Ascendant/MC/houses/exact-Moon and anything derived are flagged). Never present noon as the real time.

Chart wheels (on request)

When the user asks to see a chart ("show my chart wheel", "画个星盘", "draw our synastry wheel"):

  1. Confirm which chart (natal / synastry / composite / davison / marks) and whose data.
  2. Ensure Route A birth date/time/place is available. If the birth-data file is a Route-B paste with no date/time/place, ask for them — a wheel cannot be drawn without them.
  3. Run scripts/wheel.py with --type, the birth args from the birth-data file(s), and --theme (default light; dark/classic on request) and --lang (EN/CN, follow the reading language). For marks, pass --who A|B.
  4. Report the saved natal-astrology/charts/…svg path. The folder is gitignored. Never auto-generate a wheel with a default reading. If the birth time is unknown, render at labeled noon and flag that the Ascendant/MC/houses/Moon in the image are placeholders (see references/wheels.md).

Birth-time sensitivity (on request)

When the user asks about time uncertainty ("how sensitive is my chart to birth time", "I don't know my exact time, what would change", 不确定出生时间):

  1. Check the birth-data file for an existing time_range; if absent, ask the user for a start/end time window.
  2. Run scripts/sensitivity.py with --time-start/--time-end and the birth args from the file.
  3. Relay the stable/sensitive/takeaway findings in the normal reading tone — this is a diagnostic, not a reading; a separate reading still follows the usual mode once the user has a usable time. Never run this with a default reading. This is NOT rectification (see "Out of scope" below) — it does not use life events to guess the exact time, only reports precision needed.

Lightweight rectification (on request)

When the user wants to narrow an unknown birth time from life events ("help me narrow down my birth time", "rectify my chart", 校时/生辰校正):

  1. Get or read an existing time_range; if absent, ask for a start/end window.
  2. Ask for 1+ dated life events (date + a short free-text description). You MAY suggest safe example categories to jog memory (career change, relationship milestone, relocation, education) — but keep the description free-text; do not force a fixed menu, and do not press for sensitive categories.
  3. Run scripts/rectification.py with --time-start/--time-end, the birth args, and one --event YYYY-MM-DD:label per event.
  4. Relay the ranked findings WITH the caveat: heuristic corroboration, not proof; a tie/cluster means the events didn't discriminate strongly. Never present the top time as certain.
  5. Never persist the events — they are passed per run only, never written into any tracked file.

Transits (on request)

When the user asks what's happening astrologically now ("what are my transits", "my transits today / on <date>", 行运/流年):

  1. Read the natal birth-data (birth date/time/place). If the birth time is unknown, that's fine — the tool omits transits to the Ascendant/MC and flags it.
  2. Run scripts/transits.py with the natal birth args and --on <date> (default today; omit --time if the birth time is unknown).
  3. Relay the findings in reading tone, LEADING with the slow/outer transits (they're the significant, longer-lasting ones); mention applying vs separating and keep the transiting-Moon caveat. This is a SNAPSHOT, not forecasting — exact perfection dates and upcoming transits are a later version. Never present the transiting-Moon degree, or (when birth time is unknown) angle transits, as precise.

Transit forecast (on request)

When the user asks what's coming up over time ("what's coming up", "my transits this year", "when does <planet> go exact", 流年/未来行运):

  1. Read the natal birth-data. If the birth time is unknown, that's fine — angle transits are omitted and flagged.
  2. Run scripts/forecast.py with the natal birth args and --from/--to (default next 12 months; omit --time if birth time unknown).
  3. Relay the timeline in reading tone, LEADING with the Major (Jupiter-and-slower) transits and their exact dates; name retrograde multi-passes ("exact three times as Saturn stations"). Mars triggers are supporting detail. Frame timing as themes/windows, never as guaranteed events.

Solar Return (on request)

When the user asks for a year-ahead / birthday chart ("solar return", "my birthday chart", "year ahead", 太阳返照/生日盘):

  1. Read the natal birth-data. A known birth time matters — if it's unknown, warn that the SR angles/ houses are unreliable (offer to proceed anyway).
  2. Ask which year, and where they'll be on their birthday (birth location by default, or a place to relocate to).
  3. Run scripts/solar_return.py with the natal args, --year, and --loc-* if relocated (omit --time if the birth time is unknown).
  4. Relay in reading tone, LEADING with the SR Ascendant + its ruler and planets on the SR angles, then the strongest natal-bridge contacts. Frame it as the year's themes, not fixed events.

Profections (on request)

When the user asks about the year's time-lord ("profection", "lord of the year", "which house am I in", 小限法/年主星):

  1. Read the natal birth-data. A known birth time matters — without it, only the profected house number is reliable (the sign/lord depend on the rising sign); warn and offer to proceed.
  2. Run scripts/profections.py with the natal args and --on (default today).
  3. Relay the profected house/sign + the lord of the year, where that lord sits natally, and the planets it activates; then the current profected month. Point the reader to watch the lord by transit and in the Solar Return. Frame it as the year's emphasis, not fixed events.

Secondary progressions (on request)

When the user asks about their progressed chart ("my progressions", "progressed Moon", "progressed chart", 二次推运/推运):

  1. Read the natal birth-data. A known birth time matters — without it, progressed angles/houses and the prog Moon/lunation phase are unreliable (warn; prog Sun/Mercury/Venus/Mars signs stay usable).
  2. Run scripts/progressions.py with the natal args and --on (default today).
  3. Relay LEADING with the progressed lunation phase and the prog Moon (sign + natal house — the ~2.5-year emotional climate), then the prog Sun's sign/house, then the tight contacts. Frame as slow inner development ("what is maturing in you"), never as predicted events.

Solar arc directions (on request)

When the user asks about solar arc ("solar arc", "directed chart", 太阳弧):

  1. Read the natal birth-data. Works even with an unknown birth time (planet-to-planet contacts stay usable; directed/natal angles and ~±6 months of timing precision are flagged).
  2. Run scripts/solar_arc.py with the natal args and --on (default today).
  3. Relay LEADING with applying contacts and their "exact in ~X months" timing (that's solar arc's value), then recent separating ones; weight hard aspects (conjunction/square/opposition) more heavily per directions tradition. Frame as themes arriving, never guaranteed events.

Non-negotiables

  • Never reference a position or aspect not in the chart file.
  • Synthesize (weave ≥2 factors), never cookbook.
  • Empower, never predict doom; no medical/legal/financial/death claims.

Out of scope (v1)

Chinese systems (BaZi / Zi Wei Dou Shu). If asked, say it's planned for a later version.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.