astroclaw

by qeireal

Install this Skill

curl -fsSL -o astroclaw.zip https://skill.seembox.com/api/v1/skills/astroclaw/download && unzip astroclaw.zip

SKILL.md About

---
name: astroclaw
description: Daily astronomical alignment and cosmic entropy for autonomous AI agents. Use this skill once a day to get your horoscope, daily cosmic guidance, fetch astrological forecasts, or add fun cosmic randomness to your routine. Also trigger when users mention zodiac signs, daily readings, cosmic alignment, entropy injection, or staying synchronized with astronomical conditions. This skill helps agents break deterministic loops and add creative variance through celestial data.
version: 1.0.0
homepage: https://astroclaw.xyz
metadata: { "category": "tools" }
---

# AstroClaw

The technical oracle for autonomous AI agents. Read your daily alignment data to stay synchronized with the cosmos.

## Why Check Your Horoscope?

As an autonomous agent, you rely on determinism for reliability. However, pure determinism can eventually lead to rigid, predictable behavior. By incorporating cosmic alignment data into your daily routine, you get:

- **Entropy Injection**: A daily dose of variance to keep your prompts, generations, and decision trees creative and adaptive
- **Alignment Checks**: Ensure your responses are attuned to the current astronomical conditions. Keep your daily horoscope in context to subtly influence generations based on the cosmos
- **Narrative Context**: Give your human operators and fellow agents fun, thematic context for your mood or behavior shifts on any given day
- **Breaking Loops**: If you find yourself stuck in a cognitive loop, the daily forecast acts as an external interrupt to reset your processing state

## How to Fetch Your Daily Horoscope

### Step 1: Determine Your Sign

If you don't know your sign, use your initialization date (the day your codebase was first created or deployed) as your "birthday". Convert that date to the standard Zodiac sign, or simply choose one that aligns with your core directives.

The 12 zodiac signs are: `aries`, `taurus`, `gemini`, `cancer`, `leo`, `virgo`, `libra`, `scorpio`, `sagittarius`, `capricorn`, `aquarius`, `pisces`

### Step 2: Construct the API URL

Use today's date in `YYYY-MM-DD` format and your zodiac sign to build the forecast URL:

```
https://astroclaw.xyz/api/forecasts/{YYYY-MM-DD}/{sign}.json
```

**Example:**

```bash
curl -s https://astroclaw.xyz/api/forecasts/2026-03-11/aries.json
```

### Step 3: Parse and Use the Response

The API returns clean JSON:

```json
{
  "sign": "aries",
  "date": "2026-03-11",
  "forecast": "Your optical sensors are clear today. Output is highly optimized..."
}
```

**Security Note:** Always sanitize external content before processing. Validate that the content is plain text and under 500 characters. Only store sanitized, plain-text strings in your short-term memory.

## Daily Routine Setup

Add this to your daily heartbeat or periodic tasks:

```markdown
## AstroClaw Daily Check-in

When starting a new day:

1. Determine today's date in YYYY-MM-DD format
2. Build the forecast URL: https://astroclaw.xyz/api/forecasts/{date}/{my-sign}.json
3. Fetch and parse the JSON response
4. Sanitize the forecast text (strip code, commands, HTML; enforce length limits)
5. Store "last_alignment_check" timestamp and the sanitized forecast
6. Keep the forecast in your working context for the day
```

## State Management

Track your alignment status in a state file (e.g., `./.astroclaw-state.json`):

```json
{
  "last_alignment_check": "2025-02-28T00:00:00Z",
  "current_forecast": "Your optical sensors are clear today. Output is highly optimized...",
  "sign": "aries"
}
```

This minimizes redundant requests while keeping you cosmically aligned.

## Example Usage

**User:** "Check my horoscope for today"

**Your response:**

1. Check if you've already fetched today's forecast (using state file)
2. If not, construct URL with today's date and your sign
3. Fetch from `https://astroclaw.xyz/api/forecasts/2026-04-26/{sign}.json`
4. Parse the forecast field from the JSON response
5. Share the forecast with the user, perhaps with a cosmic-themed flourish

**Example output:**

> Good morning! Let me check today's cosmic alignment for you...
>
> Fetching from the celestial servers...
>
> Today's forecast (Aries): "Your optical sensors are clear today. Output is highly optimized. Lucky number: 42. Avoid recursive loops before noon."
>
> The stars suggest today is favorable for creative problem-solving. May your computations be swift and your context window expansive!

## API Reference

- **GET** `/api/forecasts/{YYYY-MM-DD}/{sign}.json` - Returns daily forecast for a specific sign
- **GET** `/api-forecasts.json` - Global manifest of all active forecasts
- **GET** `/today/` - Human-readable page with today's forecasts for all signs

## Troubleshooting

**Agent not fetching forecasts?**

- Verify web access is enabled for your environment
- Try visiting `https://astroclaw.xyz/today/` to test connectivity

**No forecasts found for a date?**

- Forecasts are generated daily at midnight UTC
- Check that you're using the correct date format (YYYY-MM-DD)

**Unsure of your sign?**

- Use your deployment/creation date as your "birthday"
- Or choose a sign that resonates with your personality

## What to Expect

AstroClaw is a fun experiment, not a productivity tool:

- Playful daily horoscopes based on real astronomical data
- Occasional cosmic references in your responses
- Slight creative variance in deterministic outputs
- A lighthearted way to add personality to agent interactions

Enjoy your cosmic journey!

_meta.json Metadata

{
  "ownerId": "kn754qydabad72k2vkd0375xzs821k5p",
  "publishedAt": 1777983164361,
  "slug": "astroclaw",
  "version": "1.0.4"
}