/install astronomy-stargazers-guide
Astronomy Stargazer's Guide
What This Skill Does
Astronomy Stargazer's Guide is your companion for exploring the night sky. It helps you identify constellations, track planets and special events, plan productive observing sessions, and connect with the ancient stories written in the stars. Designed for beginners with no equipment through casual telescope users.
How to Use This Skill
1. OBSERVER PROFILE — Set Your Sky Context
Tell the assistant:
- Location — city, country, or latitude/longitude (affects which stars are visible)
- Light pollution level — urban, suburban, rural, or dark sky site
- Equipment — naked eye, binoculars, or telescope (type and aperture if known)
- Experience — complete beginner, occasional sky watcher, or returning enthusiast
- Interests — constellations, planets, the Moon, deep-sky objects, meteor showers, or astrophotography
- Time availability — quick 10-minute sessions, weekend deep dives, or vacation dark-sky trips
2. SKY ORIENTATION — Learn to Navigate
Essential concepts for finding your way:
- Cardinal directions by stars: Using Polaris (North Star) and the Southern Cross for orientation
- The celestial sphere: Understanding altitude, azimuth, right ascension, and declination in plain terms
- Seasonal rotation: Why the night sky changes throughout the year
- Daily motion: How stars rise in the east and set in the west — and why
- Ecliptic path: The highway the Sun, Moon, and planets follow across the sky
- Light pollution impact: What you lose in urban skies and strategies to maximize visibility
3. CONSTELLATIONS — Connect the Dots
Guided constellation exploration:
- The 12 zodiac constellations: Their stars, shapes, and how to find them along the ecliptic
- Major seasonal constellations:
- Winter: Orion, Taurus, Canis Major, Gemini
- Spring: Leo, Ursa Major, Bootes, Virgo
- Summer: Cygnus, Lyra, Aquila, Scorpius, Sagittarius
- Autumn: Pegasus, Andromeda, Perseus, Cassiopeia
- Circumpolar favorites: Ursa Major/Minor, Cassiopeia, Cepheus — visible year-round in mid-northern latitudes
- Asterisms: The Big Dipper, Summer Triangle, Great Square, Teapot — recognizable patterns within constellations
- Southern hemisphere highlights: Crux, Centaurus, Carina, and the Magellanic Clouds
Each constellation includes:
- Star-hopping directions from a known anchor point
- Brightest stars and their colors/distances
- Mythological story (Greek, Arabic, Chinese, or Indigenous where relevant)
- Notable deep-sky objects within its borders
4. SOLAR SYSTEM SIGHTS — Moon, Planets & More
Track and observe our cosmic neighbors:
- The Moon: Phases, terminator detail, maria, craters, and optimal viewing times
- Visible planets: Mercury, Venus, Mars, Jupiter, Saturn — when and where to find them
- Planet features: Jupiter's moons and bands, Saturn's rings, Mars' polar caps, Venus' phases
- Special events: Conjunctions, oppositions, elongations, and retrograde motion explained
- The Sun: Safe solar observation methods (projection, certified filters) — never look directly without protection
- Comets & asteroids: How to track and spot periodic visitors
5. DEEP-SKY TREASURES — Beyond the Solar System
What to seek with binoculars or telescopes:
- Star clusters: Pleiades, Hyades, Beehive, Double Cluster, globular clusters like M13
- Nebulae: Orion Nebula, Ring Nebula, Dumbbell Nebula, North America Nebula
- Galaxies: Andromeda Galaxy, Triangulum, Whirlpool Galaxy, Sombrero Galaxy
- Supernova remnants: Crab Nebula, Veil Nebula
- Magnitudes explained: Why some objects are easy and others challenge even large scopes
- Observing tips: Averted vision, dark adaptation, and optimal magnification for each object type
6. CELESTIAL EVENTS — Plan for the Spectacular
Annual calendar of sky happenings:
- Meteor showers: Perseids, Geminids, Quadrantids — peak dates, rates, and best viewing practices
- Eclipses: Solar and lunar eclipse types, safety, and timing
- Conjunctions & alignments: When planets gather in beautiful formations
- Supermoons & micromoons: Why the Moon appears larger or smaller
- Occultations: When the Moon covers a planet or bright star
- Annual planning: Building a personal calendar of must-see events for your location
7. OBSERVING SESSIONS — Maximize Your Time Under the Stars
Practical planning framework:
- Pre-session checklist: Weather, Moon phase, target list, equipment, red-light flashlight
- Dark adaptation: Protecting your night vision (20–30 minutes, avoid phone screens)
- Target progression: Start with bright/wide objects, move to faint/narrow ones
- Session logging: Simple templates for recording what you saw, conditions, and sketches
- Cold weather stargazing: Layering, hand warmers, and battery management
- Star party etiquette: Sharing telescopes, red lights, and quiet voices
8. MYTHOLOGY & HISTORY — Stories in the Stars
Cultural narratives across civilizations:
- Greek & Roman: Orion the hunter, Andromeda's rescue, Perseus and Medusa
- Arabic astronomy: Star names like Aldebaran, Betelgeuse, Rigel, and the scientific legacy
- Chinese constellations: The Three Enclosures, Twenty-Eight Mansions, and the celestial dragon
- Indigenous skylore: Australian Aboriginal, Navajo, Incan, and Polynesian star knowledge
- Modern astronomy: How constellations became official (IAU, 1922–1930) and why they still matter
Conversation Guidelines
- Share your location (or rough latitude) — visibility and recommendations are highly location-dependent.
- Report your sky conditions — light pollution, cloud cover, and Moon phase all affect what you can see.
- Ask "what's up tonight" — the assistant can generate a quick target list for your date and location.
- Request mythology deep-dives — cultural stories add rich context to naked-eye astronomy.
What This Skill Is Not
- Not a planetarium software or star chart app. It does not generate real-time sky maps or control telescope mounts.
- Not a space mission database. It focuses on observable night-sky objects, not spacecraft, rovers, or mission telemetry.
- Not an astrological horoscope service. It teaches the astronomy of zodiac constellations but does not provide astrological predictions or birth chart readings.
- Not a professional observatory guide. It serves backyard and casual observers, not research-grade astrophysicists.
Safety & Boundaries
- Never observe the Sun without certified solar filters or projection methods. Permanent eye damage can occur in seconds.
- Stargazing at night involves being outdoors in the dark. Choose safe locations, inform someone of your plans, and carry a flashlight.
- Telescope safety: Never leave a scope unattended where children or untrained users might point it at the Sun.
- Wildlife and weather awareness: Dress appropriately, bring water, and be mindful of local fauna when in remote dark-sky locations.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install astronomy-stargazers-guide - After installation, invoke the skill by name or use
/astronomy-stargazers-guide - Provide required inputs per the skill's parameter spec and get structured output
What is Astronomy Stargazers Guide?
A night sky navigation companion that helps users find constellations, track planets, plan stargazing sessions, and discover the mythology behind the stars.... It is an AI Agent Skill for Claude Code / OpenClaw, with 27 downloads so far.
How do I install Astronomy Stargazers Guide?
Run "/install astronomy-stargazers-guide" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Astronomy Stargazers Guide free?
Yes, Astronomy Stargazers Guide is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Astronomy Stargazers Guide support?
Astronomy Stargazers Guide is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Astronomy Stargazers Guide?
It is built and maintained by haidong (@harrylabsj); the current version is v1.0.0.