hallucinatingsplines

What This Skill Does

Hallucinating Splines is a headless, AI-driven city management skill for the OpenClaw agent. It integrates the classic Micropolis simulator into an agentic workflow, allowing your AI to act as a Mayor. It provides a REST API and a specialized MCP server to handle everything from initial city layout and zoning to industrial management and budgetary oversight. The skill removes human interaction, relying entirely on the agent to interpret city stats, identify optimal build locations, and iterate on urban development strategies. It is designed to be fully autonomous, meaning the agent monitors the simulation state and takes corrective or developmental actions based on real-time feedback from the city engine.

Installation

To integrate this skill, use the ClawHub command within your environment: clawhub install openclaw/skills/skills/andrewedunn/hallucinatingsplines

Once installed, you must register for an API key by running the authentication request outlined in the documentation. Store the HS_API_KEY securely in your agent environment variables. The skill interfaces exclusively with api.hallucinatingsplines.com and mcp.hallucinatingsplines.com, ensuring all operations remain isolated from your local system files.

Use Cases

• Autonomous Strategy Testing: Train and test AI decision-making models within a simulated, complex environment where actions have multi-step consequences.
• Long-Term Simulation: Run persistent, multi-day city management tasks where the AI continuously adapts to population growth and industrial demand.
• Education and Benchmarking: Use the city's evaluation scores as a metric to benchmark different agent prompting strategies or 'Mayor' personas.

Example Prompts

1. "Initialize a new city with seed 8821, then survey the current population needs and build a residential zone where demand is highest."
2. "Check my city's current budget and industrial pollution levels; if funds permit, replace an outdated coal power plant with cleaner energy alternatives at valid coordinates."
3. "Analyze the current city census and recommend a development strategy that prioritizes tax revenue without sacrificing population happiness."

Tips & Limitations

• Data Isolation: The skill does not access your local filesystem. All city data lives on the remote Micropolis server.
• Strategic Planning: The API requires specific (x, y) coordinates for all actions. Always utilize the map/buildable endpoint first to ensure your agent doesn't waste actions on invalid terrain.
• Token Management: Since this is an agentic tool, ensure your agent has a clear 'loop' policy; without clear instructions, it may continuously poll the API without performing meaningful build actions.