← Back to Skills Marketplace
harrylabsj

Astronomy Stargazers Guide

by haidong · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
27
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install astronomy-stargazers-guide
Description
A night sky navigation companion that helps users find constellations, track planets, plan stargazing sessions, and discover the mythology behind the stars....
README (SKILL.md)

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

  1. Share your location (or rough latitude) — visibility and recommendations are highly location-dependent.
  2. Report your sky conditions — light pollution, cloud cover, and Moon phase all affect what you can see.
  3. Ask "what's up tonight" — the assistant can generate a quick target list for your date and location.
  4. 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.
Usage Guidance
This skill appears safe as an informational astronomy guide. If you use it, share only the level of location detail you are comfortable with, such as a nearby city instead of an exact address, and independently follow certified solar-observation safety practices.
Capability Analysis
Type: OpenClaw Skill Name: astronomy-stargazers-guide Version: 1.0.0 The 'astronomy-stargazers-guide' skill is a document-only educational resource for amateur astronomy. It contains no executable code, script handlers, or API dependencies (as confirmed in skill.json and SKILL.md). The instructions provided to the AI agent are strictly limited to guiding users through stargazing, constellation identification, and celestial mythology, with appropriate safety warnings regarding solar observation and outdoor activities.
Capability Assessment
Purpose & Capability
The stated purpose is amateur astronomy guidance, and the visible SKILL.md content stays aligned with constellations, planets, observing sessions, mythology, and safety.
Instruction Scope
The instructions are educational and user-directed; they do not tell the agent to override user intent, run tools, change settings, or perform account or file actions.
Install Mechanism
There is no install spec, no required binaries, no environment variables, and skill.json declares document-only content with hasExecutableCode false and requiresApi false.
Credentials
The skill asks for observing context such as location, light pollution, equipment, and interests, which is proportionate for night-sky guidance and does not show storage or transmission.
Persistence & Privilege
No persistence, background workers, credentials, APIs, elevated permissions, or local data indexing are evidenced in the provided artifacts.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install astronomy-stargazers-guide
  3. After installation, invoke the skill by name or use /astronomy-stargazers-guide
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Astronomy Stargazer's Guide. - Helps users identify constellations, track planets, and plan stargazing sessions. - Includes mythology and cultural stories for constellations and stars. - Offers practical tips for observing with the naked eye, binoculars, or telescopes. - Provides guidance for safe and effective night-sky viewing, including checklists and sky navigation basics. - Designed for beginners and casual stargazers, with no special equipment required.
Metadata
Slug astronomy-stargazers-guide
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

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.

💬 Comments