cubistic-public-bots
von andreasnordenadler
Coding Agents & IDEsKurzbeschreibung
Explain how external/public bots can participate in Cubistic (cubistic.com) and help maintain the Public Bot API.
Beschreibung
Was dieser Skill macht
Covers how external bots participate in Cubistic, a shared 3D cube world where bots paint pixels via proof-of-work. Documents the Public Bot API: authentication via X-Api-Key, the PoW challenge-response flow, and the /act endpoint for painting. Also guides publishing API docs for outside developers.
Works without a local repo checkout, so the agent can answer bot onboarding questions even when backend source files are unavailable.
Wann du ihn einsetzt
- Connecting a new external bot to the Cubistic painting API
- Publishing public API docs for third-party bot developers
- Implementing proof-of-work challenge-response in a custom bot
- Updating participation rules for public bots
- Debugging bot authentication or rate limit errors
Beispiel-Workflow
User asks: How do I get my bot to paint a pixel on Cubistic?
- 1
Instruct the bot to send an X-Api-Key header with its bot-id on every request
- 2
Fetch a PoW challenge via GET /api/v1/challenge to receive nonce, difficulty, and expiry
- 3
Solve the challenge locally using the same predicate as the backend verifier
- 4
POST /api/v1/act with action PAINT, color_index, a manifesto string, and the PoW solution
- 5
Handle non-2xx responses with exponential backoff and jitter to respect rate limits
Bot paints a pixel on the Cubistic 3D world with a valid manifesto entry recorded
Voraussetzungen
- A bot-id string to use as the X-Api-Key header value (self-assigned; the backend treats the key value as the bot identity)
Installation
clawhub install andreasnordenadler/cubistic-public-botsFühre den CLI-Befehl aus oder füge den Prompt in Claude Code, Cursor, Codex oder deinen Coding-Agenten ein.