Celestial Coordinates logo

Celestial Coordinates

Community
Tibsfox
celestial-coordinates

Celestial coordinate systems and sky positioning. Covers horizon (altitude-azimuth), equatorial (right ascension-declination), ecliptic, and galactic systems; epoch and precession; coordinate transformations; planisphere use; and practical sky-locating from any latitude and date. Use when locating objects, planning observations, converting catalog coordinates, or teaching the geometry of the sky.

Overview

PublisherTibsfox
Repositorygsd-skill-creator
Skill namecelestial-coordinates
Stars
70
Forks
9
Bundled files
Instructions only
Links
  • Markdown instructions

    A SKILL.md file the model loads on demand, so it only costs tokens when a request actually matches.

  • Works with any LLM

    AI skills are plain Markdown, not provider-specific code, so this works with GPT, Claude, Gemini, Grok, or a local model.

  • Self-contained

    Everything the model needs lives in the instructions — no extra files to sync.

  • Open source

    Published by Tibsfox on GitHub. Read the source before you install it.

Installation

Install the Celestial Coordinates AI skill in TypingMind to use it with any LLM, or drop it into another agent that reads SKILL.md.

1

Install in TypingMind

TypingMind installs a skill straight from its GitHub folder — it reads SKILL.md, bundles the resource files, and stores the result locally.

  1. Open the app and go to Plugins → Skills.
  2. Choose "Install from GitHub".
  3. Paste the skill folder URL below and confirm.
  4. Enable the skill in any chat where you want it available.
Plugins → Skills → Add skill → From GitHub URL, then paste the folder URL and press Continue.
2

Install in another agent

Any agent that reads the Agent Skills format can use this skill — copy the folder into that agent's skills directory.

Claude Code — .claude/skills
git clone --depth 1 https://github.com/Tibsfox/gsd-skill-creator.git /tmp/gsd-skill-creator
mkdir -p .claude/skills
cp -r /tmp/gsd-skill-creator/examples/skills/astronomy/celestial-coordinates .claude/skills/celestial-coordinates
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Celestial Coordinates in any TypingMind chat and the model takes it from there. Its name and description sit in the system prompt, and the moment a request matches, the model loads the full instructions itself — you never invoke it by hand, and it costs no tokens until it is actually used.

The model loads Celestial Coordinates on its own as soon as a request matches it.

Works with any AI model

AI skills are plain Markdown instructions rather than provider-specific code, so Celestial Coordinates is not tied to the model it was written for. Install it once in TypingMind and use it with GPT-5, Claude, Gemini, Grok, DeepSeek, Mistral, Llama, or a local model you run yourself — all on your own API keys.

  • Loaded only when it is needed

    The system prompt carries just the name and description. The instructions are fetched on the first matching request, so an idle skill costs nothing.

  • Switch models mid-chat

    Because the skill is instructions rather than code, changing model does not break it — the next model reads the same SKILL.md.

Skill instructions

This is the SKILL.md content the model loads. Read it before installing — a skill is instructions your model will follow.

Celestial Coordinates

A coordinate system tells you where something is. On Earth we use latitude and longitude. In the sky we need analogous systems, but with a complication: the sky rotates. An object's position depends on where the observer is standing, when they look, and which frame of reference they choose. This skill catalogs four celestial coordinate systems, the transformations between them, the corrections that matter (precession, nutation, aberration, refraction), and practical procedures for locating objects with a planisphere, a star chart, or a telescope's setting circles.

Agent affinity: caroline-herschel (observational practice), hubble (catalog cross-reference)

Concept IDs: astro-constellation-navigation, astro-planisphere-use, astro-earth-moon-sun-geometry

The Four Coordinate Systems at a Glance

SystemReference planeOriginCoordinatesBest for
HorizonObserver's horizonSouth (or North)Altitude, AzimuthPointing a telescope right now
EquatorialCelestial equatorVernal equinoxDeclination, Right AscensionCatalog positions, long-term records
EclipticEcliptic planeVernal equinoxEcliptic latitude, longitudeSolar system, planetary motion
GalacticGalactic planeGalactic centerGalactic latitude, longitudeMilky Way structure, stellar populations

No single system is "best" — each is convenient for a particular class of problem. Professionals move freely between them using standard transformations.

System 1 — Horizon (Alt-Az)

Reference plane: The observer's local horizon.

Coordinates:

  • Altitude (alt or h): Angle above the horizon, 0 degrees at the horizon to +90 at the zenith. Negative values are below the horizon.
  • Azimuth (az or A): Angle measured along the horizon from a reference direction (conventionally North = 0, increasing clockwise through East = 90, South = 180, West = 270).

What makes it intuitive. Horizon coordinates describe exactly what you see. "The Moon is at altitude 35 degrees, azimuth 210 (south-southwest)" tells you where to look without any further computation.

What makes it limited. Horizon coordinates are observer-dependent and time-dependent. The same star has different (alt, az) values from Seattle and Sydney, and different values an hour later because of Earth's rotation. You cannot catalog a star's position in (alt, az) — you must catalog it in a frame that does not move with the observer.

When to use. Real-time pointing. Describing what is visible right now. Simple naked-eye instruction ("look 20 degrees above the south horizon after sunset").

System 2 — Equatorial (RA-Dec)

Reference plane: The celestial equator — the projection of Earth's equator onto the sky.

Coordinates:

  • Declination (Dec or delta): Angle north (+) or south (-) of the celestial equator. Ranges from -90 at the south celestial pole to +90 at the north celestial pole. Directly analogous to Earth latitude.
  • Right Ascension (RA or alpha): Angle eastward along the celestial equator from the vernal equinox point. Measured in hours, minutes, seconds (0h to 24h, where 24 hours = 360 degrees). Analogous to Earth longitude but using time units because the sky rotates once per sidereal day.

What makes it powerful. Equatorial coordinates are (almost) fixed to the stars. Sirius has Dec approximately -16 degrees and RA approximately 6h 45m regardless of observer or time of night. Catalogs, star atlases, telescope setting circles, and astronomical papers all use equatorial coordinates.

The epoch complication. Earth's axis precesses with a period of about 26,000 years, which slowly shifts the celestial equator and the vernal equinox. Catalog positions must specify an epoch — a reference date to which coordinates are referred. Standard epochs:

  • B1950.0 (Besselian) — older catalogs
  • J2000.0 (Julian) — modern default
  • J — current-epoch positions for high-precision work

Converting between epochs requires applying precession corrections. For backyard observing, J2000 is good enough; for radio interferometry or spacecraft navigation, precession and nutation matter.

When to use. Catalog lookups. Star charts. Telescope goto systems. Long-term records. Any situation where the position should be independent of observer and clock.

System 3 — Ecliptic

Reference plane: The ecliptic — the plane of Earth's orbit around the Sun, which is also (approximately) the plane in which the Moon and planets move.

Coordinates:

  • Ecliptic latitude (beta): Angle north (+) or south (-) of the ecliptic, -90 to +90.
  • Ecliptic longitude (lambda): Angle eastward along the ecliptic from the vernal equinox, 0 to 360 degrees.

What makes it useful. Solar system bodies stay close to the ecliptic, so ecliptic latitude is small for the Sun, Moon, and planets. This makes planetary positions easier to compute and tabulate. The zodiac is the band of the sky within about 8 degrees of the ecliptic where the classical planets are always found.

When to use. Solar system ephemerides. Planetary conjunctions. Eclipse prediction (when the Moon's ecliptic latitude is near zero at new or full moon). Meteor shower radiants relative to the ecliptic.

System 4 — Galactic

Reference plane: The mean plane of the Milky Way galaxy.

Coordinates:

  • Galactic latitude (b): Angle north (+) or south (-) of the galactic plane, -90 to +90.
  • Galactic longitude (l): Angle along the galactic plane from the direction of the galactic center (in Sagittarius), 0 to 360 degrees.

When to use. Milky Way structure studies. Distribution of open clusters, globular clusters, H II regions, pulsars. Any question that asks "where is this object relative to the galactic disk?"

Transformation — Equatorial to Horizon

The most common transformation problem: given a star's (RA, Dec) from a catalog, where is it in the sky right now?

Inputs needed:

  • Star: RA (alpha), Dec (delta)
  • Observer: latitude (phi), longitude
  • Time: date and UT, from which you compute the Local Sidereal Time (LST)

Hour angle. First compute the hour angle H = LST - alpha. This measures how far the star has moved past the meridian (due south).

Altitude:

sin(alt) = sin(delta) * sin(phi) + cos(delta) * cos(phi) * cos(H)

Azimuth:

cos(az) = (sin(delta) - sin(alt) * sin(phi)) / (cos(alt) * cos(phi))

with a quadrant fix based on the sign of sin(H) (if sin(H) > 0, the star is west of the meridian and az > 180).

Practical note. For a backyard observer, tables and planetarium software do this automatically. The formulas matter when you are building a pointing system, calibrating a telescope, or writing ephemeris code from scratch.

Transformation — Horizon to Equatorial

Reverse direction, useful when reporting the equatorial position of something you sighted with a theodolite or an unaligned camera:

sin(delta) = sin(alt) * sin(phi) + cos(alt) * cos(phi) * cos(az)
sin(H) = -sin(az) * cos(alt) / cos(delta)
alpha = LST - H

Again with quadrant care for the inverse trig functions.

The Small Corrections That Matter

For naked-eye observing, the formulas above are more than sufficient. For arcsecond precision you need to apply additional corrections:

Precession

The slow (26,000 year) wobble of Earth's axis shifts RA by about 50 arcsec per year along the ecliptic. Polaris was not always the pole star and will not always be. For historical observations or high-precision work, precess coordinates from their catalog epoch to the observation epoch.

Nutation

Short-period oscillations of Earth's axis superimposed on precession, dominated by an 18.6-year term from the Moon's node precession. Amplitude about 9 arcsec in obliquity and 17 arcsec in longitude.

Aberration

Earth's orbital motion causes an apparent shift in the direction to a star of up to 20.5 arcsec (the constant of aberration). Stars appear displaced toward the direction of Earth's motion.

Parallax

For nearby stars, Earth's orbit around the Sun causes a small annual ellipse in the star's apparent position. Parallax is what the Hipparcos and Gaia missions measure — for Proxima Centauri it is 0.77 arcsec.

Atmospheric refraction

The atmosphere bends light downward, raising the apparent altitude of an object. At the horizon the lift is about 34 arcmin — more than the Sun's angular diameter, which is why you see a "double sunset" in some conditions. At 45 degrees altitude the correction is about 1 arcmin. At the zenith it is zero.

Order of operations

For professional pipelines the corrections are applied in a fixed order: precession, nutation, aberration, parallax, refraction. For backyard observing, apply none of them and the sky still fits your plans.

Working with a Planisphere

A planisphere is a two-disk device that displays the visible night sky for a given latitude, date, and time. Use:

  1. Match the date to the time. Rotate the top disk so the observation time aligns with the date on the rim.
  2. Read the oval window. The exposed portion shows all stars currently above the horizon.
  3. Orient the planisphere. Hold it over your head so the direction marked "N" points to true north (not magnetic north — use Polaris or a corrected compass).
  4. Match window edges to horizon cardinal points. The oval's edges correspond to N, E, S, W. Read the sky by looking up and matching shapes.

Limitations. A planisphere shows stars and constellations. Planets, the Moon, and deep-sky objects are not on the disk because their positions change. Use a star chart or app for those.

When to Use Each System

QuestionUse
"Is M42 up right now from my backyard?"Horizon (from equatorial transform)
"What are the coordinates of this star in SIMBAD?"Equatorial (J2000)
"Where will Jupiter be on December 1?"Ecliptic
"Is this pulsar in the galactic plane?"Galactic
"How do I point my dobsonian at this cluster?"Equatorial + transform to Alt-Az at observation time
"Is this catalog position for 1950 or 2000?"Check epoch before transforming

When NOT to Trust a Single Coordinate Value

  • Missing epoch. Equatorial coordinates without an epoch label are ambiguous by up to a degree of arc for historical catalogs.
  • Missing units. RA in hours vs. RA in degrees (conversion: 1 hour = 15 degrees).
  • Ambiguous azimuth convention. Some older texts measure azimuth from south, not north. Always state the convention.
  • Refraction near the horizon. Do not trust any altitude below 10 degrees without refraction correction.

Common Mistakes

MistakeWhy it failsFix
Using magnetic north as "true north"Magnetic declination drifts by tens of degrees worldwideApply local declination or sight on Polaris
Treating RA degrees as RA hours360 degrees = 24 hours, ratio is 15Check units before computing hour angle
Forgetting to precessCatalog is B1950, observation is 2026 — 76 years of driftApply precession matrix or use modern catalog
Ignoring refraction at horizonSun appears to set 2 minutes lateUse refraction table for altitudes under 10 degrees
Mixing up altitude and elevation"Elevation" sometimes means altitude above sea levelIn celestial context, use "altitude" and "height above horizon"
Reading azimuth in the wrong directionCounterclockwise vs. clockwiseStandard is clockwise from north

Cross-References

  • caroline-herschel agent: Observational setup and field identification, practical use of coordinate systems at the telescope.
  • hubble agent: Cross-references catalog positions with redshift and classification data.
  • distance-ladder skill: Parallax as both a coordinate correction and a distance measurement technique.
  • naked-eye-observing skill: Star hopping from bright markers using angular distances.
  • orbital-mechanics skill: Ecliptic coordinates and planetary ephemerides.

References

  • Meeus, J. (1998). Astronomical Algorithms. 2nd edition. Willmann-Bell. (The standard reference for coordinate transformations and ephemeris calculation.)
  • Green, R. M. (1985). Spherical Astronomy. Cambridge University Press.
  • Seidelmann, P. K. (ed., 2006). Explanatory Supplement to the Astronomical Almanac. University Science Books.
  • Kaler, J. B. (2002). The Ever-Changing Sky: A Guide to the Celestial Sphere. Cambridge University Press.
  • International Astronomical Union, SOFA (Standards of Fundamental Astronomy) software library.

Frequently asked questions

What does the Celestial Coordinates AI skill do?

Celestial coordinate systems and sky positioning. Covers horizon (altitude-azimuth), equatorial (right ascension-declination), ecliptic, and galactic systems; epoch and precession; coordinate transformations; planisphere use; and practical sky-locating from any latitude and date. Use when locating objects, planning observations, converting catalog coordinates, or teaching the geometry of the sky.

Why use Celestial Coordinates on TypingMind?

Because you install it once and use it with any model. Celestial Coordinates is plain Markdown rather than provider-specific code, so the same skill runs on GPT-5, Claude, Gemini, Grok, or a local model — and you can switch model mid-chat without it breaking. TypingMind runs on your own API keys, so you pay providers directly instead of a per-seat subscription, and your skills and chats stay in your own storage.

How do I install Celestial Coordinates in TypingMind?

Open Plugins → Skills → Install from GitHub in TypingMind and paste https://github.com/Tibsfox/gsd-skill-creator/tree/main/examples/skills/astronomy/celestial-coordinates. TypingMind reads its SKILL.md and installs it as a skill you can enable per chat.

Which AI models can use Celestial Coordinates?

Any model you connect in TypingMind. AI skills are plain Markdown instructions rather than provider-specific code, so GPT, Claude, Gemini, Grok, and local models can all load this skill when a request matches it.

How many AI models can I use with Celestial Coordinates?

As many as you like. As long as a model supports skills, you can use Celestial Coordinates with it — GPT, Claude, Gemini, Grok, DeepSeek, Mistral, Llama and more — all on TypingMind with your own API keys.

Is the Celestial Coordinates AI skill free?

It is published on GitHub by Tibsfox. Check the repository for licensing terms. You only pay your own AI provider for the tokens you use.

What are AI skills?

An AI skill is a reusable instruction bundle that teaches an AI model how to do one specific task. It follows the open Agent Skills format: a SKILL.md file with a name and description, plus any scripts, templates or reference files the model may need. The model reads the instructions only when your request matches the skill, so an installed skill costs nothing until it is used.

How are AI skills different from plugins or MCP servers?

A plugin or MCP server gives a model new tools to call — code that runs somewhere and returns a result. An AI skill gives the model knowledge and process instead: how to approach a task, which steps to follow, what good output looks like. Skills are plain Markdown, so they need no server, no API key and no runtime, and they work with any model.

View all

Set up your own AI workspace now

Get notified about new features and future giveaways by subscribing to our newsletter 👇