Distance Ladder logo

Distance Ladder

Community
Tibsfox
distance-ladder

The cosmic distance ladder from radar ranging to Hubble flow. Covers parallax, spectroscopic parallax, cluster main-sequence fitting, Cepheid and RR Lyrae period-luminosity relations, Type Ia supernovae, Tully-Fisher, surface brightness fluctuation, and redshift-distance relations. Use when estimating, cross-checking, or critiquing any astronomical distance from a parsec to a gigaparsec.

Overview

PublisherTibsfox
Repositorygsd-skill-creator
Skill namedistance-ladder
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 Distance Ladder 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/distance-ladder .claude/skills/distance-ladder
Restart Claude Code after copying so it picks up the new skill.

Use it in TypingMind

Enable Distance Ladder 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 Distance Ladder 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 Distance Ladder 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.

The Cosmic Distance Ladder

There is no single method that measures every astronomical distance. Instead, astronomers chain methods into a ladder: each rung calibrates the next, and errors propagate with the chain. Radar pins down the Astronomical Unit. Parallax measures the nearest few thousand parsecs. Main-sequence fitting and spectroscopic parallax reach galactic-scale distances. Cepheids calibrate galaxies in the Local Group and beyond. Type Ia supernovae push to hundreds of megaparsecs. Redshift carries the rest. This skill covers each rung, what calibrates it, where the error bars live, and how to think critically about a claimed distance.

Agent affinity: hubble (extragalactic distances), rubin (rotation curves), payne-gaposchkin (spectroscopic parallax)

Concept IDs: astro-distance-ladder, astro-cepheid-variables, astro-hubbles-law

The Ladder, Top to Bottom

RungMethodTypical rangePrecisionCalibrated by
0Radar ranging (planets)AU scale10^-11Direct measurement
1Trigonometric parallax0 - 10 kpc (Gaia)10-100 microarcsecGeometric
2Spectroscopic parallax0 - 5 kpc~0.5 magMain sequence from parallax
3Main-sequence fitting0 - 100 kpc0.1-0.3 magParallax
4RR Lyrae0 - 100 kpc5-10%Parallax, MS fitting
5Cepheid period-luminosity0 - 30 Mpc5-10%Parallax, LMC distance
6Tip of the red giant branch (TRGB)0 - 20 Mpc5-10%Parallax, MS fitting
7Surface brightness fluctuation (SBF)0 - 200 Mpc5-15%Cepheids
8Tully-Fisher (spirals)0 - 200 Mpc15-20%Cepheids
9Fundamental Plane (ellipticals)0 - 200 Mpc15-20%SBF
10Type Ia supernovae1 Mpc - 3 Gpc5-7%Cepheids
11Hubble flow (z-d relation)> 100 Mpccosmology-dependentSN Ia + CMB

Each rung has standard candles or geometric measurements; each rung is calibrated against the one above it.

Rung 0 — Radar Ranging

The Astronomical Unit — Earth's mean distance to the Sun — is defined via radar ranging to Venus (first achieved by JPL in 1961) and other planets, combined with Kepler's third law. This gives AU to about 11 decimal places. All other distance scales in astronomy ultimately trace back to this number.

Rung 1 — Trigonometric Parallax

The cleanest distance method: measure the tiny annual ellipse a nearby star traces as Earth orbits the Sun. The parallax angle pi is defined as half the maximum angular displacement:

d (parsecs) = 1 / pi (arcseconds)

A parsec is the distance at which a baseline of 1 AU subtends 1 arcsec. The closest star, Proxima Centauri, has pi = 0.7687 arcsec, so d = 1.301 pc.

Historical. Friedrich Bessel measured the first stellar parallax (61 Cygni, 0.3136 arcsec) in 1838. The technique was limited by atmospheric seeing until space missions.

Hipparcos (1989-1993). ESA mission, milliarcsecond precision for about 100,000 stars, reaching out to about 100 pc with good accuracy.

Gaia (2013-present). ESA successor, microarcsecond precision for over 1.8 billion stars. Gaia DR3 (2022) reaches useful precision to about 10 kpc and pushes all subsequent ladder rungs to new precision.

Limits. At very small parallaxes (distant stars), systematic errors (Lutz-Kelker bias, selection effects) dominate.

Rung 2 — Spectroscopic Parallax

"Spectroscopic parallax" is a misleading name — it is not a parallax, it is a distance inferred from:

  1. The star's spectral type and luminosity class (from its spectrum).

  2. The absolute magnitude M that a star of that type typically has (calibrated from parallax-measured stars).

  3. The observed apparent magnitude m.

  4. The distance modulus formula:

    m - M = 5 * log10(d / 10 pc)

So d = 10^((m - M + 5) / 5) parsecs.

Error sources. The absolute magnitude of a spectral type has intrinsic scatter (roughly 0.5 mag for main-sequence dwarfs). Interstellar extinction reddens and dims the star — you must correct for A_V using the (B-V) color excess.

Range. Useful out to several kpc for bright stars. Pre-Gaia, this was the primary method for mapping the Milky Way beyond the local volume.

Rung 3 — Main-Sequence Fitting

For a star cluster, plot the color-magnitude diagram. Compare the cluster main sequence against a nearby cluster (the Hyades or the Pleiades) whose distance is known from parallax. The vertical shift needed to align the main sequences gives the distance modulus of the unknown cluster.

Strengths. Uses many stars, averaging down photometric errors. Independent of single-star peculiarities.

Weaknesses. Sensitive to metallicity (metal-rich stars are subtly redder and brighter), age (main-sequence turnoff shifts), and reddening.

Applications. Open clusters throughout the galactic disk. Globular clusters throughout the halo. Cross-checks on Cepheid distances via Cepheid-containing clusters.

Rung 4 — RR Lyrae Variables

RR Lyrae stars are horizontal-branch variables with periods of 0.2 to 1 day. They pulse regularly and have nearly constant absolute magnitudes (M_V approximately 0.6 with slight metallicity dependence). One RR Lyrae light curve gives the absolute magnitude; apparent magnitude + extinction correction gives the distance.

Strengths. Found in globular clusters and the galactic halo, reaching across the Milky Way and into the Magellanic Clouds.

Weaknesses. Intrinsically faint, so useful only out to about 100 kpc.

Rung 5 — Cepheid Period-Luminosity Relation

Henrietta Swan Leavitt discovered the Cepheid period-luminosity relation at Harvard in 1908-1912, working on photographic plates of the Small Magellanic Cloud. She found that the longer a Cepheid's period, the brighter it was. Because all the SMC Cepheids were at roughly the same distance, the pattern she saw was an intrinsic relation — not a distance artifact.

The relation:

M_V = a * log10(P / days) + b

with a slope around -2.8 and a zero point that depends on calibration. Modern calibrations (Freedman et al. 2001, Riess et al. 2019) refine a and b to a few percent.

Why Cepheids are gold. They are bright (up to 100,000 solar luminosities for long-period ones), reaching out to about 30 Mpc in the best cases. They are variable and easy to identify. Their periods are intrinsic clocks. They are the rung that connects parallax-measured nearby stars to galaxies.

Metallicity dependence. Metal-poor Cepheids (like those in the SMC) have slightly different zero points than metal-rich Cepheids (Milky Way disk). This is a few-percent systematic that matters at the precision frontier.

Edwin Hubble's use. In 1923-1924 Hubble identified Cepheids in the Andromeda Nebula (M31), measured their periods, applied Leavitt's relation, and concluded that M31 was a million light-years away — far outside the Milky Way. This settled the Great Debate of 1920 (Shapley vs. Curtis) about whether "spiral nebulae" were inside or outside the Milky Way.

Rung 6 — Tip of the Red Giant Branch (TRGB)

Red giant stars climb the red giant branch in the HR diagram until they experience the helium flash at a sharply defined luminosity — the "tip." The absolute magnitude at the tip is nearly constant (M_I around -4.0) with weak metallicity dependence.

Use. Deep photometry of a galaxy's stellar population reveals the RGB tip as a sudden cutoff in the luminosity function. Its apparent magnitude gives the distance.

Strengths. Independent of variability. Works in old stellar populations where Cepheids are absent. Applicable to early-type galaxies.

Recent prominence. TRGB has been used as a cross-check on Cepheid distances in the Hubble tension debate — giving values of H_0 that sit between the Cepheid-based and CMB-based extremes.

Rung 7 — Surface Brightness Fluctuation (SBF)

Developed by Tonry and Schneider (1988). A galaxy's integrated light comes from individual stars that are unresolved. Pixel-to-pixel fluctuations in surface brightness are higher where fewer stars contribute per pixel — i.e., in more distant galaxies. Specifically, the amplitude of pixel fluctuations scales as sqrt(1/N) where N is the number of stars per pixel, and the inferred "fluctuation star magnitude" gives the distance.

Use. Elliptical galaxies out to 100-200 Mpc. Calibrated against Cepheid distances in galaxies that have both methods applicable.

Rung 8 — Tully-Fisher

Tully and Fisher (1977) showed that spiral galaxies obey a power-law relation between their luminosity and their rotation velocity:

L proportional to v_max^alpha

with alpha around 4 for the B band and around 3.5 for I. Measure v_max from 21 cm HI line width, combine with a measurement of apparent magnitude, and you have the distance.

Use. Spiral galaxies out to about 200 Mpc. Good enough for large-scale structure surveys.

Rung 9 — Fundamental Plane

The elliptical-galaxy analog of Tully-Fisher. Elliptical galaxies occupy a two-dimensional plane in the three-dimensional space of (effective radius, central velocity dispersion, surface brightness). Measuring two of these three coordinates gives the distance.

Rung 10 — Type Ia Supernovae

A Type Ia supernova is the thermonuclear detonation of a white dwarf that approaches the Chandrasekhar mass. Because the trigger mass is physically determined, Type Ia SNe are standardizable candles — not perfectly standard, but with a known relation between peak brightness and light-curve shape (the Phillips relation).

Procedure.

  1. Observe the supernova light curve in multiple bands.
  2. Fit the shape; apply the Phillips correction.
  3. Extract the peak absolute magnitude.
  4. Combine with apparent peak magnitude to get distance modulus.

Range. From about 1 Mpc to several Gpc. Type Ia SNe are the primary extragalactic distance indicator for cosmological work.

History. The use of Type Ia SNe by the High-Z Supernova Team (Riess et al. 1998) and the Supernova Cosmology Project (Perlmutter et al. 1999) led to the discovery of accelerating cosmic expansion — the evidence for dark energy — and the 2011 Nobel Prize in Physics.

Rung 11 — Hubble Flow

For distances much larger than the Local Group, recession velocity (measured from redshift) is approximately proportional to distance:

v = H_0 * d

where H_0 is the Hubble constant — currently measured to about 70 +/- 2 km/s/Mpc depending on method. At sufficient distances, redshift itself becomes a distance estimator, subject to the assumed cosmological model.

The Hubble tension. Different distance-ladder methods give slightly different values of H_0:

  • Cepheid + SN Ia (local): around 73 km/s/Mpc
  • CMB + Lambda-CDM (early-universe): around 67 km/s/Mpc
  • TRGB + SN Ia: around 70 km/s/Mpc

The 4-5 sigma discrepancy between local and early-universe measurements is the Hubble tension, an active research puzzle at the frontier of precision cosmology.

Error Propagation

The distance ladder is a chain. Errors at each rung propagate multiplicatively:

sigma_total^2 = sum of (sigma_i / d_i)^2 in quadrature

A 5% error on parallax, 5% on Cepheid calibration, 5% on Cepheid-to-SN Ia calibration, and 5% on SN Ia standardization compound. The entire ladder from parallax to the cosmological horizon carries roughly 5-10% systematic uncertainty end-to-end.

This is why Gaia matters. Tightening rung 1 (parallax) by an order of magnitude tightens every subsequent rung, because every other rung is calibrated against rung 1.

Strategy Selection Heuristics

SituationMethod
Distance to a star within 10 kpcGaia parallax
Distance to a clusterMain-sequence fitting or TRGB
Distance to a galaxy in the Local GroupCepheids, RR Lyrae, or TRGB
Distance to an elliptical out to 200 MpcSBF or Fundamental Plane
Distance to a spiral out to 200 MpcTully-Fisher
Distance beyond 200 MpcType Ia SN, redshift
Distance to a QSO at z = 2Redshift with cosmological model

When to Doubt a Distance

  • Extinction uncorrected. Reddening from interstellar dust systematically underestimates distance (stars look dimmer, which reads as "farther," except the color also reddens — catch the inconsistency).
  • Metallicity mismatch. Calibration sample has different composition from target (affects Cepheids, RR Lyrae, TRGB).
  • Systematic in the calibration rung. If rung N has a 10% systematic, every rung below it inherits it.
  • Unverified standard. Is the object really a standard candle? Type Ia SNe do have subclasses; Cepheids come in overtones as well as fundamentals.
  • Selection bias. Lutz-Kelker effect — stars selected by "small parallax" tend to have their parallaxes overestimated on average.

Common Mistakes

MistakeWhy it failsFix
Using Hubble flow for nearby galaxiesPeculiar velocities dominateUse Cepheids or TF/FP for d < 50 Mpc
Treating d = 1/pi naively with noisy piErrors in 1/pi are not symmetricFit in parallax space, not distance space
Ignoring metallicity in PL relationsMetal-poor Cepheids have different zero pointApply metallicity correction
Over-trusting one SNType Ia scatter is realUse large samples
Combining inconsistent H_0 valuesDifferent systematicsState which ladder was used

Cross-References

  • hubble agent: The observational cosmology chair whose original work launched the modern extragalactic distance scale.
  • payne-gaposchkin agent: Spectroscopic parallax and stellar luminosity calibration.
  • rubin agent: Rotation-curve work depends on accurate Tully-Fisher calibration.
  • stellar-spectroscopy skill: Spectral classification feeds spectroscopic parallax.
  • cosmological-observation skill: The cosmological rungs and Hubble tension in context.

References

  • Leavitt, H. S., & Pickering, E. C. (1912). "Periods of 25 variable stars in the Small Magellanic Cloud." Harvard College Observatory Circular, 173.
  • Hubble, E. (1929). "A relation between distance and radial velocity among extra-galactic nebulae." PNAS, 15, 168.
  • Freedman, W. L., et al. (2001). "Final results from the Hubble Space Telescope Key Project to measure the Hubble constant." ApJ, 553, 47.
  • Riess, A. G., et al. (2022). "A comprehensive measurement of the local value of the Hubble constant." ApJL, 934, L7.
  • Perlmutter, S., et al. (1999). "Measurements of Omega and Lambda from 42 high-redshift supernovae." ApJ, 517, 565.
  • Gaia Collaboration (2023). "Gaia DR3: Summary of the content and survey properties." A&A, 674, A1.
  • Tully, R. B., & Fisher, J. R. (1977). "A new method of determining distances to galaxies." A&A, 54, 661.

Frequently asked questions

What does the Distance Ladder AI skill do?

The cosmic distance ladder from radar ranging to Hubble flow. Covers parallax, spectroscopic parallax, cluster main-sequence fitting, Cepheid and RR Lyrae period-luminosity relations, Type Ia supernovae, Tully-Fisher, surface brightness fluctuation, and redshift-distance relations. Use when estimating, cross-checking, or critiquing any astronomical distance from a parsec to a gigaparsec.

Why use Distance Ladder on TypingMind?

Because you install it once and use it with any model. Distance Ladder 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 Distance Ladder in TypingMind?

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

Which AI models can use Distance Ladder?

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 Distance Ladder?

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

Is the Distance Ladder 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 👇